Skip to content

[Docs] Document Symfony without WordPress in Blueprint examples#3763

Merged
adamziel merged 5 commits into
trunkfrom
add-symfony-package-radar-blueprint
Jun 9, 2026
Merged

[Docs] Document Symfony without WordPress in Blueprint examples#3763
adamziel merged 5 commits into
trunkfrom
add-symfony-package-radar-blueprint

Conversation

@adamziel

@adamziel adamziel commented Jun 7, 2026

Copy link
Copy Markdown
Collaborator

What it does

Adds a Symfony example to the Blueprint examples page showing preferredVersions.wp: false and a PHP-only Symfony app loaded from the Blueprints gallery.

The Symfony app files and Blueprint JSON no longer live in this repository. The example points at the canonical Blueprint in WordPress/blueprints, where the source/rebuild instructions were added in WordPress/blueprints#208.

Implementation

  • Teaches BlueprintExample/BlueprintRunButton how to render a remote blueprintUrl.
  • Uses the merged Blueprints repo URL for the Symfony example instead of duplicating the Blueprint JSON in Playground docs.
  • Refreshes the Symfony ZIP cache key in the PHP frameworks guide so it picks up the rebuilt Blueprints ZIP that uses the published wp-php-toolkit/html Composer package.
  • Rebases on trunk, which already includes the newer /guides/php-frameworks page from [Docs] Document Symfony apps in Playground without WordPress #3766.

Testing

npm exec nx run docs-site:check-orphan-pages
npm exec nx run docs-site:lint
npm exec nx run docs-site:build

docs-site:build passed and printed the existing Docusaurus broken-anchor warnings for unrelated localized docs pages.

@github-actions github-actions Bot added the [Type] Documentation Improvements or additions to documentation label Jun 7, 2026
@adamziel adamziel force-pushed the add-symfony-package-radar-blueprint branch from 674d89e to 1b23306 Compare June 9, 2026 15:54
@adamziel adamziel changed the title Add Symfony Package Radar Blueprint [Docs] Document Symfony without WordPress in Blueprint examples Jun 9, 2026
@adamziel adamziel force-pushed the add-symfony-package-radar-blueprint branch from fd79b3b to 63d6aac Compare June 9, 2026 16:14
@adamziel adamziel marked this pull request as ready for review June 9, 2026 16:39
@adamziel adamziel requested review from a team, Copilot and zaerl June 9, 2026 16:39

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds documentation and component support for running Blueprints from a remote Blueprint URL (highlighted via a Symfony “without WordPress” example), and refreshes the Symfony ZIP cache-busting key used in the PHP frameworks guide.

Changes:

  • Extend BlueprintRunButton/BlueprintExample to accept and render a blueprintUrl in addition to embedded Blueprint JSON.
  • Update the Blueprints examples docs to include a Symfony (WP-less) example that references the canonical remote Blueprint.
  • Refresh the Symfony ZIP URL cache key in the PHP frameworks guide.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
packages/docs/site/src/components/Blueprints/BlueprintRunButton.tsx Adds support for launching Playground with a remote blueprintUrl query parameter.
packages/docs/site/src/components/Blueprints/BlueprintExample.mdx Renders either Blueprint JSON or a remote URL, and passes blueprintUrl through to the run button.
packages/docs/site/docs/main/guides/php-frameworks.md Updates Symfony ZIP URL version string to bust cache for rebuilt artifact.
packages/docs/site/docs/blueprints/08-examples.md Adds a Symfony “Run without WordPress” example using a remote Blueprint URL.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +24 to +28
: `https://playground.wordpress.net/?mode=seamless#${btoa(
typeof blueprint === 'string'
? blueprint
: JSON.stringify(blueprint)
)}`;
import React from 'react';

export function BlueprintRunButton({ blueprint }) {
export function BlueprintRunButton({ blueprint, blueprintUrl }) {
@adamziel adamziel merged commit 4b5afbe into trunk Jun 9, 2026
55 checks passed
@adamziel adamziel deleted the add-symfony-package-radar-blueprint branch June 9, 2026 16:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Type] Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants