WP Manifestindependent plugin directory
manifest / updates / wp-deploy-hook-runner

WP Deploy Hook Runner

Secure webhook + WP-CLI endpoint to run post-deploy maintenance tasks (flush rewrites, purge caches, clear transients).

by Best Website · github.com/bestwebsite-legacy/wp-deploy-hook-runner

★ 1stars
1forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/bestwebsite-legacy/wp-deploy-hook-runner/archive/refs/heads/master.zip
Readme github.com/bestwebsite-legacy/wp-deploy-hook-runner ↗

WP Deploy Hook Runner — securely trigger deploy tasks via webhooks

WP Deploy Hook Runner

Secure webhook + WP‑CLI endpoint to run post‑deploy maintenance tasks from CI/CD.

What it Does

  • Flush rewrite rules
  • Flush object cache (if available)
  • Delete expired transients (and allows full transient purge via filter)

Installation

  1. Upload wp-deploy-hook-runner to /wp-content/plugins/
  2. Activate via Plugins screen
  3. Go to Tools → Deploy Hook Runner to view your endpoint + token

Webhook Usage

Endpoint: POST /wp-json/deploy/v1/run

Authenticate with either:

  • Header: X-Deploy-Token: <your-token>
  • Query param: ?token=<your-token>

cURL

curl -X POST -H "X-Deploy-Token: YOUR_TOKEN" https://example.com/wp-json/deploy/v1/run

GitHub Actions Example

- name: WordPress post-deploy
  run: |
    curl -X POST -H "X-Deploy-Token: ${{ secrets.DEPLOY_TOKEN }}" https://example.com/wp-json/deploy/v1/run

WP‑CLI

wp deploy-hook run
wp deploy-hook token
wp deploy-hook token --regenerate

Extensibility

  • Filter wdhr_clear_all_transients to true to purge all transients.
  • Action wdhr_after_tasks receives the $report array after execution.

Security

  • Uses a random 32‑character token stored in the database.
  • Accepts token via header or query param (for CI flexibility).

Author

Built and maintained by Best Website — https://bestwebsite.com
Contact: support@bestwebsite.com

License

GPL‑2.0 or later