close
Skip to content

Add URL route to open Blueprint Gallery via ?overlay=blueprints#3220

Merged
adamziel merged 3 commits intoWordPress:trunkfrom
bph:add-blueprint-gallery-route
Feb 11, 2026
Merged

Add URL route to open Blueprint Gallery via ?overlay=blueprints#3220
adamziel merged 3 commits intoWordPress:trunkfrom
bph:add-blueprint-gallery-route

Conversation

@bph
Copy link
Collaborator

@bph bph commented Jan 29, 2026

This improves discoverability by enabling direct linking to the Blueprints for educational content, presentations, and documentation.
Fixes #2031

A user arrives at the full list of blueprints and can choose the one they would like to start out with or try out. Once the user uses the "x" to close the overlay the ?overlay=blueprints is removed, so it doesn't trigger the blueprints view when the browser window is refreshed.

  • Adds support for ?overlay query parameter to open the Saved Playgrounds overlay directly via URL
  • ?overlay=blueprints opens the Blueprint Gallery view
  • ?overlay (or any other value) opens the main Overlay view
    A shared OverlayViewMode type is exported from the overlay component for type safety across files.
    The code changes are meant to keep it flexible if there is a need to create more routes via overlay in the future.

Claude Code assisted.

Test plan

  • Visit https://playground.wordpress.net/?overlay=blueprints → Blueprint Gallery opens
  • Visit https://playground.wordpress.net/ → normal behavior (no overlay)
  • Click the grid icon in the toolbar → overlay opens manually
  • Close and reopen overlay → works correctly

@bph bph force-pushed the add-blueprint-gallery-route branch from dbaac1c to bd38866 Compare January 29, 2026 22:33
@bph bph changed the title Add URL route to open Blueprint Gallery via ?section=blueprints Add URL route to open Blueprint Gallery via ?overlay=blueprints Jan 29, 2026
@bph bph force-pushed the add-blueprint-gallery-route branch 3 times, most recently from 16af61f to 6db5cc3 Compare January 30, 2026 13:27
@bph bph requested a review from adamziel January 30, 2026 13:52
@bph bph self-assigned this Jan 30, 2026
@bph bph marked this pull request as ready for review January 30, 2026 13:52
Adds support for ?overlay parameter to directly open the Saved Playgrounds overlay:
- ?overlay opens the main Saved Playgrounds view
- ?overlay=blueprints opens the Blueprint Gallery view

This improves discoverability by allowing direct linking to the Blueprint Gallery
for educational content and presentations.

Fixes WordPress#2031
@bph bph force-pushed the add-blueprint-gallery-route branch from 0b96b45 to de6b49b Compare January 30, 2026 14:25
@adamziel adamziel requested a review from fellyph January 30, 2026 19:56
@bph bph added [Aspect] Browser [Type] Enhancement New feature or request labels Feb 2, 2026
@adamziel adamziel merged commit c22acc5 into WordPress:trunk Feb 11, 2026
35 checks passed
@adamziel
Copy link
Collaborator

Thank you @bph!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a route to open Blueprint Gallery via URL

2 participants