Plugin repositories keep the event triggers, required checks, and repository settings. The reusable workflows in .github/workflows/ run CI, package candidates, and publish releases. The composites in actions/ handle shared steps such as reading plugin configuration and verifying ZIPs.
| Plugin caller | Trigger | Shared workflow |
|---|---|---|
ci.yml |
Pull request | plugin-pr-ci.yml |
ci-cron.yml and ci-cron-qit.yml |
Schedule or manual dispatch | plugin-cron-ci.yml and plugin-cron-qit.yml |
manual-ci.yml |
Manual dispatch | plugin-test-runner.yml |
release-start.yml |
Manual dispatch | plugin-release-start.yml |
ci-release-smoke-test.yml |
Release branch push | plugin-release-smoke-test.yml |
ci-release.yml |
Manual dispatch | plugin-release.yml |
request-external-review.yml |
Pull request target | plugin-request-external-review.yml |
Required checks, Check changelog, and Validate @version Tag are the plugin branch protection contexts. Keep their names stable. The aggregate PR check expects each applicable job to succeed and fails on drafts.
Set capabilities, versions, packaging options, and release product IDs in package.json under config.woo. The plugin's bin/woo-config.sh validates the settings against its schema and supplies defaults. Repository-specific setup belongs in the documented bin/hooks/ scripts and package commands. These run in the checkout that supplies the candidate code.
PR CI reads configuration from the merge commit and version overrides from the PR head subject. A reusable job can accept the PR's configuration for that event commit. A job that checks out a different ref reads configuration from that ref. Pass artifact IDs, source SHAs, and checksums from build jobs to consumers so they verify the right ZIP.
External review runs on the base workflow and uses its explicit review credential. Fork PRs cannot use same-repository private-plugin coverage. Check which suites need a same-repo branch before merging. Release credentials belong in the steps that use them. Explicit release-candidate refs bypass dependency caches where the callers disable caching.
PRs restore pnpm, Composer, and Playwright caches. Eligible scheduled and trunk runs restore and save those same keys. Compare cache hits and runner time in the pilot when changing cache keys or writers.
QIT waits by default. Turn off qit-wait in Test Runner to queue managed checks, which the run summary marks as submitted after a successful enqueue. Activation, Woo API, Woo E2E, and API fuzz still report completed results.
- Review the shared diff and record its full commit SHA. Pin reusable workflows and actions to the reviewed SHA in the plugin callers.
- Start with Bookings Availability. Exercise the required contexts, a PR with explicit test versions, and any scheduled or manual path the change touches.
- Check repository-specific behavior in Accommodation Bookings, the Back in Stock Notifications Migrator, Coupon Campaigns, and Product Bundles. Then roll out to the remaining plugins.
See the plugin's AGENTS.md for release steps and local commands. Start Release prepares the branch and opens the release PR. Publish release uses the verified candidate. Use Re-run failed jobs for a publish retry once the candidate has been pinned.