github-workflows

Reusable GitHub Actions workflows for PublishPress plugin repositories.

Available workflows

• .github/workflows/unit-tests.yml: Runs PHPUnit tests.
• .github/workflows/code-standards.yml: Runs PHP compatibility and lint checks.
• .github/workflows/deploy-free.yml: Builds and deploys free plugin releases to WordPress.org and uploads release assets to GitHub.
• .github/workflows/deploy-free-assets.yml: Updates WordPress.org plugin assets/readme.
• .github/workflows/deploy-pro.yml: Builds pro plugin packages and uploads release assets to GitHub.

Usage

Create a workflow file in your repository under .github/workflows/ and call one of these reusable workflows.

Security recommendation: always pin reusable workflows to a commit SHA, not a branch name such as main.

Unit tests example

name: Unit Tests

on:
  pull_request:
    branches: [ master, development ]
  push:
    branches: [ master, development ]

permissions:
  contents: read

jobs:
  unit_tests:
    uses: publishpress/github-workflows/.github/workflows/unit-tests.yml@<commit-sha>

Code checks example

name: Code Checks

on:
  pull_request:
    branches: [ master, development ]
  push:
    branches: [ master, development ]

permissions:
  contents: read

jobs:
  code_check:
    uses: publishpress/github-workflows/.github/workflows/code-check.yml@<commit-sha>

Deploy free plugin example

name: Deploy Free Plugin

on:
  push:
    tags:
      - "v*"

permissions:
  contents: write

jobs:
  deploy_free:
    uses: publishpress/github-workflows/.github/workflows/deploy-free.yml@<commit-sha>
    secrets: inherit

Required repository secrets for WordPress.org deploy:

• SVN_USERNAME
• SVN_PASSWORD

Deploy pro plugin example

name: Deploy Pro Plugin

on:
  push:
    tags:
      - "v*"

permissions:
  contents: write

jobs:
  deploy_pro:
    uses: publishpress/github-workflows/.github/workflows/deploy-pro.yml@<commit-sha>
    secrets: inherit

Deploy free plugin assets example

name: Deploy Free Plugin Assets

on:
  workflow_dispatch:

permissions:
  contents: read

jobs:
  deploy_assets:
    uses: publishpress/github-workflows/.github/workflows/deploy-free-assets.yml@<commit-sha>
    secrets: inherit