README

Reusable infrastructure relating to testing, building, and deploying my WordPress plugins (see the "Used by" section below).

Provided without support, warranty, guarantee, backwards compatibility, fitness for purpose, resilience, safety, sanity, beauty, or support for any plugin that isn't one of mine.

Used by

• Extended CPTs
• Query Monitor
• User Switching
• WP Crontrol

Overview

Plugins that use this library all use a similar setup in their workflows:

Acceptance testing

• Push to a main branch or pull request, acceptance-tests.yml fires
  • Constructs a matrix of supported PHP and WordPress versions
  • Uses reusable-acceptance-tests.yml
    • Installs PHP and WordPress
    • Runs the build
    • Runs acceptance testing with wp-browser

Integration testing

• Push to a main branch or pull request, integration-tests.yml fires
  • Constructs a matrix of supported PHP and WordPress versions
  • Uses reusable-integration-tests.yml
    • Installs PHP and WordPress
    • Runs the build
    • Runs integration testing with wp-browser

Coding standards testing

• Push to a main branch or pull request, coding-standards.yml fires
  • Constructs a matrix of supported PHP versions
  • Uses reusable-coding-standards.yml
    • Installs PHP
    • Checks coding standards with PHPStan and PHPCS

Deployment to WordPress.org

• Push to the release branch, build.yml fires
  • Uses reusable-build.yml
    • Runs the build
    • Reads version from package.json
    • Commits built files
    • Pushes to release-$VERSION
    • Tags the new version and pushes
• Publish a release, deploy-tag.yml fires
  • Uses reusable-deploy-tag.yml
    • Creates a changelog entry from the release notes
    • Uses 10up/action-wordpress-plugin-deploy
      • Deploys the new version to WordPress.org
      • Generates a zip file
  • Uses johnbillion/action-wordpress-plugin-attestation
    • Fetches the zip from WordPress.org
    • Generates an attestation if the zip contents match the build

Licence

MIT