https://github.com/barning/2025child

My personal child theme for twentytwentyfive
https://github.com/barning/2025child

wordpress wordpress-child-theme wordpress-theme

Last synced: 5 months ago
JSON representation

My personal child theme for twentytwentyfive

• Host: GitHub
• URL: https://github.com/barning/2025child
• Owner: barning
• Created: 2025-08-13T13:00:41.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2026-01-24T10:48:04.000Z (5 months ago)
• Last Synced: 2026-01-24T19:18:47.392Z (5 months ago)
• Topics: wordpress, wordpress-child-theme, wordpress-theme
• Language: JavaScript
• Homepage: https://niklasbarning.de
• Size: 688 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# TwentyTwentyFive Child Theme — Overview

This child theme extends a block-based parent theme with a set of small, maintainable theme modules and custom Gutenberg blocks. It replaces certain plugin functionality with lightweight, theme-integrated code.

## Summary

- Child stylesheet is enqueued from `functions.php`.

- Modular structure: PHP modules live in `inc/` and are autoloaded.

- Block source is in `blocks/`; compiled assets live in `build/`.

## Included Blocks & Modules

- **Book Rating**

	- Location: `inc/book-rating.php`

	- Registration: `build/book-rating` (block assets) and server-side renderer at `blocks/book-rating/render.php`.

	- Purpose: Display a book card (cover, title, author). Rendering is done server-side in PHP.

- **Media Recommendation (Film/Serie)**

	- Location: `inc/media-recommendation.php`

	- Registration: `build/media-recommendation` (block assets) and server-side renderer at `blocks/media-recommendation/render.php`.

	- Purpose: Display movies and TV shows with poster images and titles. Searches both movies and TV shows via TMDB API with server-side AJAX endpoint for security.

	- Features: Ambilight-style gradient effect that adapts to poster colors, responsive design matching book-rating block.

	- Setup: Requires TMDB API key configuration (see `MEDIA_RECOMMENDATION_SETUP.md`).

- **Videogame Recommendation**

	- Location: `inc/videogame-recommendation.php`

	- Registration: `build/videogame-recommendation` (block assets) and server-side renderer at `blocks/videogame-recommendation/render.php`.

	- Purpose: Display video games with cover images and titles. Searches games via RAWG API with server-side AJAX endpoint for security.

	- Features: Ambilight-style gradient effect that adapts to cover colors, responsive design matching media-recommendation block.

	- Setup: Requires RAWG API key (free from [rawg.io/apidocs](https://rawg.io/apidocs)). Configure via WordPress Admin → Settings → Videogame Recommendation or define `RAWG_API_KEY` in `wp-config.php`.

- **Magic Cards**

	- Location: `inc/magic-cards.php`

	- Registration: `build/magic-cards` (block assets) and server-side renderer at `blocks/magic-cards/render.php`.

	- Purpose: Display Magic: The Gathering cards (single cards from Scryfall/Gatherer or Moxfield deck embeds). Features card lookup with alternative print selection and lazy loading for images and iframes.

- **Popular Posts**

	- Location: `inc/popular-posts.php`

	- Purpose: Provides a Gutenberg block to render a curated list of posts selected by editors.

- **Visual Link Preview**

	- Location: `inc/visual-link-preview.php` (block) and `inc/visual-link-preview-async.php` (background fetch)

	- Behavior: Fetches metadata (OG/Twitter) using `wp_safe_remote_get()`, parses HTML with `DOMDocument`/`DOMXPath`, normalizes image URLs, and caches results in a transient (`child_vlp_`) for approximately 24 hours.

- **Head/Footer Injections (Fediverse)**

	- Location: `inc/head-footer-injections.php`

	- Purpose: Adds a Customizer setting `fediverse_creator_handle` and outputs the `` tag in the page head when set.

## Files & Folders (quick)

- `blocks/` — block source (editor scripts, `block.json`, `render.php` where server-side rendering is required)

- `build/` — compiled, shipped block assets (JS/CSS)

- `inc/` — PHP modules registering blocks, render callbacks and helpers

- `functions.php` — bootstraps the theme (loads `inc/*.php`, enqueues child stylesheet)

## Development & Build

Prerequisites (recommended): Node.js, npm

From the theme root run:

```bash

npm install

npm run build

```

To create a distributable package:

```bash

npm run dist

```

Note: After changes to `blocks/` always run `npm run build` to update the `build/` assets — the theme registers assets from that folder.

## Automated Builds & Releases

The repository uses GitHub Actions to automatically build and release the theme:

- **Pull Request Merged to main**: Triggers a build and uploads artifacts to the workflow run.

- **Tag Pushed (v*)**: Triggers a build and automatically creates a GitHub release with the theme zip file attached.

- **Release Published**: When a GitHub release is manually created/published, automatically builds and uploads the theme zip to that release.

- **Manual Workflow Dispatch**: Can be triggered manually from the Actions tab.

The automated workflow ensures the `dist/twentytwentyfive-child.zip` file is always available for releases without needing to commit build artifacts to the repository.

## Developer Notes

- Styles: Each module registers `style-index.css` as a block style and also enqueues it globally as a frontend fallback when present.

- Popular Posts: The block renders a curated list chosen by editors.

- Visual Link Preview: Background fetch endpoint is `admin_post_child_vlp_fetch` (also available via `admin_post_nopriv_child_vlp_fetch`) and is responsible for fetch/parse/cache.

## Performance Optimizations

The theme includes several performance optimizations to minimize filesystem I/O operations:

- **Cached Module Loading**: `functions.php` caches the result of `glob()` when loading modules from `inc/` to avoid repeated filesystem scans on every page load.

- **Static CSS Caching**: All block modules (book-rating, popular-posts, media-recommendation, visual-link-preview) use static variables to cache CSS file existence and modification time checks, reducing redundant `file_exists()` and `filemtime()` calls.

- **Clean Code**: Removed unreachable dead code from the Visual Link Preview render callback to improve code maintainability and execution efficiency.

These optimizations are transparent to users and require no configuration.

## Quick FAQ

- Where do I set the Fediverse meta tag? → Customizer → "Fediverse Author" (setting `fediverse_creator_handle`).

- Where are server-side renderers? → `blocks//render.php` and the corresponding `inc/*.php` registration files.