GitHub Configuration, Actions & Workflows

This folder contains the repository's configuration for GitHub, automated CI/CD workflows, and custom helper scripts for static analysis.

• workflows/: Automated GitHub Actions yaml files.
• bin/: Supporting scripts used by workflows or developers.
• unit-tests-suites.yml: Unit test suite definitions — the single source of truth for which suites exist and which paths trigger them.

• Purpose: Optimizes static analysis checks inside PRs. Instead of checking the whole repository (which contains legacy code violations), it isolates PHPCS violations to only the lines added or modified in the current branch.
• Mechanism:
  • Runs standard phpcs on newly added files (diff-filter=A).
  • Runs phpcs-changed on modified files (diff-filter=M), creating temporary files/diffs to calculate only the errors introduced on the changed lines.
  • In GitHub Actions, also emits each violation as an inline annotation on the PR diff.
• Usage:

  BASE_REF=trunk php .github/bin/phpcs-branch.php

• Trigger: Runs on pull requests that modify PHP files, phpcs.xml.dist, composer.json, or the workflow files themselves.
• Actions: Sets up PHP 8.4, installs composer tools, and executes the phpcs-branch.php helper script to report PHPCS syntax/standard compliance on PR diffs.

• Trigger: Runs on pull requests and pushes to trunk (only the suites affected by the changed files), plus a daily scheduled run and manual dispatch (all suites).
• Suite definitions: unit-tests-suites.yml declares every suite, its job matrix configuration, and the paths that can break it. To add a suite, edit that file — the workflow generates its path filters and job matrices from it.
• Jobs:
  • changes: Loads the suite definitions, detects which paths changed, and builds the matrices for the suites that need to run.
  • php-standalone: Runs PHPUnit on modules that do not depend on WordPress or a database (Serve Happy, Browse Happy, Events API, Slack Trac Bot, and Slack Props Library).
  • php-wordpress: Sets up Node.js, installs Docker-based @wordpress/env (wp-env), spins up the local container environment, injects PHPUnit polyfills, and runs unit tests for the Handbook, Plugin Directory, Theme Directory, and Make plugins.

• Trigger: Runs daily at 14:00 UTC and on manual workflow dispatch.
• Purpose: Executes integration/E2E and data freshness checks against the live production endpoints (api.wordpress.org and wordcamp.org). Runs in isolation from the PR checks to avoid blocking PR merges due to transient external/live issues.

• Trigger: Pull request lifecycle events (opened, reopened, ready for review, labeled with props-bot, or commented on).
• Purpose: Automatically scans the pull request's author, commit messages, and review comments to compile a contributor "Props" credit line formatted in WordPress SVN style. Comments the list of credits back on the PR.

• Trigger: Runs twice daily (00:19 and 12:19 UTC) and on manual workflow dispatch.
• Purpose: Audits one representative page per site template on the live network (performance, accessibility, best practices, SEO) and posts the category scores to the site-quality stats endpoint, so regressions show up as a trend. Settings live in lighthouserc.json.

• Trigger: Runs on pull requests and pushes to trunk that touch wordpress.org/public_html/style/, the Plugin Directory theme (wporg-plugins-2024), or the Support theme (wporg-support-2024). Any of them runs the job for all three.
• Actions: Installs each package from its committed package-lock.json, runs its lint:js and lint:css scripts (and Prettier for style/), then rebuilds and fails if the committed build output differs. To cover another package with a committed build, commit its lockfile, add it to the matrix, and add its path to both triggers.