Skip to content

[Docs] Add overlay parameter to Playground URL options#3457

Merged
fellyph merged 10 commits intotrunkfrom
add-overlay-property
Apr 11, 2026
Merged

[Docs] Add overlay parameter to Playground URL options#3457
fellyph merged 10 commits intotrunkfrom
add-overlay-property

Conversation

@fellyph
Copy link
Copy Markdown
Collaborator

@fellyph fellyph commented Apr 2, 2026

This pull request adds new documentation for a UI overlay feature in the Playground's query API. The main change is an update to the documentation to describe the new overlay URL parameter, which allows users to open specific overlays (like the Blueprint Gallery) automatically when the Playground loads.

New feature documentation:

  • Added a description of the overlay parameter, which lets users open a UI overlay (such as the Blueprint Gallery) on page load by specifying ?overlay=blueprints in the URL. The overlay parameter is removed from the URL when the overlay is closed.

introduced on PR #3220

- Introduced a new `overlay` parameter that opens a UI overlay on page load, currently supporting `blueprints` to directly access the Blueprint Gallery.
- The parameter is removed from the URL once the overlay is closed, enhancing user experience by streamlining access to features.
@fellyph fellyph requested review from a team, JanJakes, bgrgicak, brandonpayton and Copilot April 2, 2026 16:49
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds documentation for the Playground Query API to describe a new overlay URL parameter that opens specific UI overlays on initial load.

Changes:

  • Documented new overlay query parameter
  • Added example usage (?overlay=blueprints)
  • Clarified that the parameter is removed from the URL when the overlay closes

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

fellyph added 3 commits April 2, 2026 18:01
- Enhanced the description of the Query API page to clarify its purpose in configuring a WordPress Playground instance via URL parameters.
- Improved formatting and consistency in the documentation by adjusting comment styles and correcting minor grammatical errors in the Portuguese text.
- Added a detailed explanation of how the API works and provided an example URL for users to test the functionality.
- Introduced a new page detailing the Query API of WordPress Playground, explaining how to configure an instance via URL parameters.
- Included examples of usage, available options, and their descriptions in Spanish to enhance accessibility for Spanish-speaking users.
fellyph and others added 6 commits April 10, 2026 06:46
…ent/developers/06-apis/query-api/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/06-apis/query-api/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/06-apis/query-api/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/06-apis/query-api/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/06-apis/query-api/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
@fellyph fellyph merged commit 5e95574 into trunk Apr 11, 2026
47 checks passed
@fellyph fellyph deleted the add-overlay-property branch April 11, 2026 09:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants