Build Playground links with wordpress-playground-action

[pattonwebz]

Replaces the hand-rolled Playground link building in build-plugin-with-ref.yml with pattonwebz/wordpress-playground-action@v0.

Removed: the "Resolve public plugin URLs for Playground" step (manual nightly.link URL construction) and the "Build WordPress Playground links" step (an inline python3 -c one-liner that base64-encoded the blueprint). Both are now the action's job.

Net: -64/+32, one file.

Behaviour changes

No Playground link on release events. The action resolves artifacts through nightly.link, which only proxies Actions artifacts, not release assets. The old code special-cased release to emit a releases/download/... URL instead — but that URL had no consumer. The PR comment step is pull_request-only, so on a release the link only ever reached an echo in the Summary log. Releases already ship the real zip as a release asset, which is the better artifact anyway.

No Playground link for the ref (woocommerce) build. Also already unreachable: need_ref_build is only true for a workflow_dispatch carrying a ref value, or for a release — never for a pull_request. So a ref link could only ever have surfaced in a manual-dispatch job log.

The ref/woo build itself is untouched. It still builds and still attaches to releases. Verified the whole chain is intact: ref_param=woocommerce → check_ref → update-ref-param.sh → ref dist build → ref artifact upload → softprops/action-gh-release picking up REF_ZIP_PATH.

Net effect for reviewers: the PR comment on a gha-build label looks the same as before.

Other changes

• Added actions: read to permissions: — the action uses it to verify the artifact exists before minting a link, so a wrong artifact name fails at build time instead of at click time.
• plugin-slug: accessibility-checker is pinned rather than left to inference, keeping the activation path correct regardless of artifact naming.
• Playground URLs reach the comment/Summary steps via env: rather than ${{ }} interpolated into the script body.
• Dropped the github.event.repository.private == false guards — repo is public, and the action refuses private repos itself.

Verification

• actionlint 1.7.7 on the final state: 2 errors, both pre-existing. Linted the pre-change file from develop as a baseline and got the identical pair (labels.*.name array-in-template at line 38, github.head_ref in an inline script at line 69). Neither is on a touched line, so both are left alone.
• Dry-ran the action's build_blueprint.py against a real artifact name (accessibility-checker-1.47.0-1804-3959d1e4): the resulting zip-url matches the shape the old inline code produced, and plugin-path resolves to accessibility-checker/accessibility-checker.php.

One JSON difference worth knowing: the new blueprint uses installPlugin with options.activate: true instead of a separate activatePlugin step, and adds preferredVersions: {php: latest, wp: latest}. Same end state, different blueprint shape.

🤖 Generated with Claude Code

https://claude.ai/code/session_019LoLgW7oFjBPxGea9kiZJ2

Summary by CodeRabbit

• Improvements
  • Updated pull request comments and build summaries to reflect Playground availability for primary plugin builds, showing “Not available for this run” when no primary link is generated.
  • Adjusted reporting logic for release builds and when primary generation is skipped, with clearer messaging.
  • Simplified ref-build reporting to focus on artifact presence rather than URL/blueprint details.
• Bug Fixes
  • Improved consistency of generated Playground links for primary artifacts, including correct handling for release and skipped-primary scenarios.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

📝 Walkthrough

Walkthrough

The workflow uses a dedicated WordPress Playground action for primary builds, passes its URL to pull request comments and summaries, and removes ref Playground URL reporting.

Changes

Primary Playground workflow

Layer / File(s)	Summary
Generate the primary Playground URL .github/workflows/build-plugin-with-ref.yml	Adds actions: read permission, adjusts Composer installation flags, and uses pattonwebz/wordpress-playground-action to generate a primary artifact Playground URL on eligible runs.
Report Playground availability .github/workflows/build-plugin-with-ref.yml	Passes the generated URL to pull request comments and summaries, displays explicit unavailable-state messages, and reports ref builds using only their ZIP path.

Estimated code review effort: 2 (Simple) | ~10 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Workflow
  participant PlaygroundAction
  participant PullRequestComment
  participant BuildSummary
  Workflow->>PlaygroundAction: Generate primary Playground URL
  PlaygroundAction-->>Workflow: Return PRIMARY_PLAYGROUND_URL
  Workflow->>PullRequestComment: Pass primary URL
  Workflow->>BuildSummary: Pass primary URL and run state

Loading

Possibly related PRs

• equalizedigital/accessibility-checker#1603: Modifies Playground URL generation and related pull request and summary output.

Suggested labels: gha-build

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: replacing manual Playground link generation with wordpress-playground-action.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch playground-link-action

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/workflows/build-plugin-with-ref.yml:
- Around line 352-361: Update the “Playground (primary)” fallback in the build
summary to distinguish why the primary build was skipped: report release-asset
behavior only when the mode is release, and use a run-neutral message when
skip_primary is caused by a manual ref_param dispatch. Use the existing
steps.setref.outputs.mode value and preserve the successful URL output path.
- Around line 258-279: Update the uses reference in the playground_primary step
from the mutable pattonwebz/wordpress-playground-action@v0 tag to a specific
immutable commit SHA, preserving the existing inputs and execution condition.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a72e356b-a2a4-4942-89c7-ea543232e3f7

📥 Commits

Reviewing files that changed from the base of the PR and between 3959d1e and 762c5b6.

📒 Files selected for processing (1)

• .github/workflows/build-plugin-with-ref.yml

[github-actions]

✅ Accessibility Checker build (primary only)

• Artifact: Download accessibility-checker-1.47.0-1843-6420a71e.zip
• Workflow run: View logs
• Playground (primary): Open with plugin preinstalled

[github-actions]

✅ Accessibility Checker build

• Artifact: Download accessibility-checker-1.47.0-1843-1770a0ee.zip
• Workflow run: View logs
• Playground: Open with plugin preinstalled

_{Built from 1770a0ee · 2026-07-24 22:27 UTC}