Merge pull request #10 from imagewize/feature/rebuild-demo-script

Feature/rebuild Demo Script

Author: jasperf

CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.4.0] - 2026-05-15
+
+### Added
+
+- **`scripts/rebuild-demo.php`** — WP-CLI script to rebuild demo pages from pattern PHP files. Renders each pattern file in the live WordPress context and overwrites the page's `post_content`, identical to a fresh block-editor insert. Supports:
+  - Single-site and multisite configurations
+  - Mapping page IDs to one or more pattern files (concatenated in order)
+  - Optional push of custom `.html` templates to the WP database
+  - Optional push of custom template parts (header, footer, etc.) to the WP database
+  - Dry-run mode via `WP_REBUILD_DRY_RUN=1` environment variable
+  - Works with any FSE block theme (not just Elayne)
+
+### Changed
+
+- Moved demo rebuild script documentation from `README.md` to `docs/demo-rebuild-script.md` for better organization
+- Added `docs/index.php` and `scripts/index.php` with "silence is golden" to prevent directory browsing
+
 ## [2.3.1] - 2026-05-14
 
 ### Fixed

README.md

@@ -333,6 +333,10 @@ Applied to `.html` files in `templates/` and `parts/` directories. These checks
 
 The `check` command processes PHP pattern files. HTML template files use a different structure — raw block markup without PHP wrappers — and require different checks. In particular, WooCommerce 9.x+ changed the `save()` output for filter blocks to include empty `<div>` wrappers; templates written against older versions lack those wrappers and trigger client-side block validation errors that neither WP-CLI nor the PHP checker can catch.
 
+## Demo Rebuild Script
+
+For rebuilding demo pages from pattern PHP files, see the [Demo Rebuild Script guide](docs/demo-rebuild-script.md).
+
 ## Development
 
 ```bash

bin/pt-cli

@@ -22,7 +22,7 @@ use Imagewize\PtCli\Commands\Scaffold\StyleCreateCommand;
 use Imagewize\PtCli\Commands\TemplateCheckCommand;
 use Symfony\Component\Console\Application;
 
-$application = new Application('pt-cli', '2.3.1');
+$application = new Application('pt-cli', '2.4.0');
 $application->add(new CheckCommand());
 $application->add(new TemplateCheckCommand());
 $application->add(new PatternCreateCommand());

docs/demo-rebuild-script.md

@@ -0,0 +1,58 @@
+# Demo Rebuild Script
+
+A WP-CLI script is included to rebuild demo pages from the latest pattern PHP files. It renders each pattern file in the live WordPress context and overwrites the page's `post_content` — identical to a fresh block-editor insert.
+
+## Location
+
+`scripts/rebuild-demo.php`
+
+## Usage
+
+Copy the script to your theme directory (e.g., `web/app/themes/your-theme/scripts/rebuild-demo.php`) and customize the `$page_map`, `$templates`, and `$template_parts` arrays.
+
+```bash
+# Single-site usage (run from your WordPress root):
+wp --path=web/wp eval-file web/app/themes/your-theme/scripts/rebuild-demo.php
+
+# Multisite usage — pass --url= to target the correct subsite AND pass the
+# subsite slug as a positional argument:
+wp --path=web/wp --url=example.com/store/ \
+  eval-file web/app/themes/your-theme/scripts/rebuild-demo.php store
+
+# Dry-run (shows what would be updated, no writes):
+WP_REBUILD_DRY_RUN=1 wp --path=web/wp \
+  eval-file web/app/themes/your-theme/scripts/rebuild-demo.php
+```
+
+## Configuration
+
+Edit the script's arrays to map your page IDs to pattern files:
+
+```php
+// Single-site
+$page_map = array(
+    17 => array( 'patterns/hero-with-cta.php', 'patterns/features.php' ),
+    20 => array( 'patterns/contact-with-form.php' ),
+);
+
+// Multisite (nested by subsite slug)
+$page_map = array(
+    'main'  => array( 17 => array( 'patterns/hero-with-cta.php' ) ),
+    'store' => array( 92 => array( 'patterns/woocommerce/woo-hero.php' ) ),
+);
+
+// Optional: Push custom .html templates to WP database
+$templates = array(
+    'archive-product' => 'templates/archive-product-custom.html',
+);
+
+// Optional: Push custom template parts
+$template_parts = array(
+    'header' => 'patterns/my-custom-header.php',
+    'footer' => 'patterns/my-custom-footer.php',
+);
+```
+
+## Important for multisite
+
+Page IDs are per-subsite (not global). Always pass `--url=` so WP-CLI switches to the right blog context. Without it, `get_template_directory()` and page IDs may resolve against the wrong subsite.

docs/index.php

@@ -0,0 +1,2 @@
+<?php
+// Silence is golden.

scripts/index.php

@@ -0,0 +1,2 @@
+<?php
+// Silence is golden.