Title: Shift8 Deployment Manager for Woodpecker CI Author: shift8 Published: November 12, 2026 Last modified: November 12, 2026 --- Search plugins ![](https://ps.w.org/shift8-deployment-manager-for-woodpecker-ci/assets/banner-772x250. png?rev=3798644) ![](https://ps.w.org/shift8-deployment-manager-for-woodpecker-ci/assets/icon-256x256. png?rev=3798644) # Shift8 Deployment Manager for Woodpecker CI By [shift8](https://profiles.wordpress.org/shift8/) [Download](https://downloads.wordpress.org/plugin/shift8-deployment-manager-for-woodpecker-ci.1.1.0.zip) * [Details](https://wordpress.org/plugins/shift8-deployment-manager-for-woodpecker-ci/#description) * [Reviews](https://wordpress.org/plugins/shift8-deployment-manager-for-woodpecker-ci/#reviews) * [Installation](https://wordpress.org/plugins/shift8-deployment-manager-for-woodpecker-ci/#installation) * [Development](https://wordpress.org/plugins/shift8-deployment-manager-for-woodpecker-ci/#developers) [Support](https://wordpress.org/support/plugin/shift8-deployment-manager-for-woodpecker-ci/) ## Description Shift8 Deployment Manager for Woodpecker CI lets an administrator push a staging site to production by starting a manual Woodpecker pipeline from Shift8 Woodpecker, either immediately or at a scheduled date and time. An activity log records the WordPress user, the date/time, and how each deployment ended. “Woodpecker CI” is the name of a third-party open source project. This plugin is an independent integration made by Shift8 and is not affiliated with, endorsed by or sponsored by the Woodpecker CI project. The plugin only triggers and observes the pipeline; the deployment itself is performed by your Woodpecker workflow. The API token stays on the server, is never stored in the database and is never sent to the browser. End users cannot cancel a running deployment. ### External services This plugin connects to one external service: the Woodpecker CI server whose address you enter in the settings (or define in `wp-config.php`). Woodpecker is open source and normally self-hosted, so the server is your own or one your organisation operates. Nothing is sent anywhere else, and the plugin does not contact Shift8 or any third party. When it is used: * When an administrator clicks “Test Woodpecker Connection”, the plugin requests`/ api/user`, `/api/repos/{id}` and the repository’s workflow list. * When a deployment is started (immediately or by a schedule), the plugin sends a request to `/api/repos/{id}/pipelines` containing the configured branch, the optional workflow name, an empty variables object and a short message (by default“ WordPress production deployment by {display name of the WordPress user}”). * While a deployment is running, the plugin requests `/api/repos/{id}/pipelines/{ number}` to read its status. Every request carries your Woodpecker API token as a bearer token in the Authorization header. The token is read only from `wp-config.php` and is never shown in the browser or stored in the database. Woodpecker is a project of the Woodpecker CI community: https://woodpecker-ci.org. This plugin is an independent integration and is not affiliated with or endorsed by that project. Terms and privacy for your server are those of whoever hosts it. ## Installation 1. Upload the plugin to `/wp-content/plugins/shift8-deployment-manager-for-woodpecker- ci` and activate it (on the staging site). 2. Define the API token in `wp-config.php`. It is required and is the only way to set it: 3. define( ‘SHIFT8_WOODPECKER_TOKEN’, ‘…’ ); 4. Open Shift8 Woodpecker Settings and enter the Woodpecker URL, repository ID, branch and (optionally) workflow. These can also be defined in `wp-config.php` as `SHIFT8_WOODPECKER_URL`, `SHIFT8_WOODPECKER_REPO_ID`, `SHIFT8_WOODPECKER_BRANCH` and `SHIFT8_WOODPECKER_WORKFLOW`, which override the saved values. 5. On the Deployment tab click “Test Woodpecker Connection”. 6. Make sure the Woodpecker workflow accepts the `manual` event. 7. For scheduled deployments use a system cron to run `wp-cron.php` every minute and add `define( 'DISABLE_WP_CRON', true );`. ## FAQ ### Does the plugin deploy anything itself? No. It asks Woodpecker to start a pipeline. Everything else is up to your pipeline. ### How does scheduling work? Woodpecker cannot delay a pipeline, so the schedule is kept in WordPress (WP-Cron) and the pipeline is started when the time arrives, in the site timezone. One schedule can be pending at a time; a schedule that is more than 30 minutes late is skipped and logged instead of running. ### Who can deploy? Users with the `manage_options` capability by default, filterable with `shift8_woodpecker_deploy_capability`. Settings always require `manage_options`. ### Where do I see the result of a deployment? In the activity log on the Deployment tab: a “Started deployment” line and, when the pipeline stops, a “Deployment finished” line with the final status. It is recorded when the page next checks the pipeline, so it may appear at your next visit if nobody was watching. ### Does the plugin need a system cron? Only for scheduled deployments, which rely on WP-Cron. A system cron running `wp- cron.php` every minute with `DISABLE_WP_CRON` set makes schedules reliable. ### Does it work on the production site too? Install it on staging only. A staging-to-production database copy carries the plugin’s saved settings, schedule and log with it. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Shift8 Deployment Manager for Woodpecker CI” is open source software. The following people have contributed to this plugin. Contributors * [ shift8 ](https://profiles.wordpress.org/shift8/) [Translate “Shift8 Deployment Manager for Woodpecker CI” into your language.](https://translate.wordpress.org/projects/wp-plugins/shift8-deployment-manager-for-woodpecker-ci) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/shift8-deployment-manager-for-woodpecker-ci/), check out the [SVN repository](https://plugins.svn.wordpress.org/shift8-deployment-manager-for-woodpecker-ci/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/shift8-deployment-manager-for-woodpecker-ci/) by [RSS](https://plugins.trac.wordpress.org/log/shift8-deployment-manager-for-woodpecker-ci/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.1.0 * Renamed to “Shift8 Deployment Manager for Woodpecker CI” after WordPress.org review, with a not-affiliated notice * Single Shift8 Woodpecker page with Deployment and Settings tabs * Schedule a deployment for a later date/time (site timezone, up to 30 days ahead) * Activity log of which user started or scheduled a deployment, when, and the final status * End users cannot cancel a running deployment; removed the link to the Woodpecker UI * The API token can only be set in wp-config.php #### 1.0.0 * Initial release ## Meta * Version **1.1.0** * Last updated **1 day ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.1.4** * PHP version ** 7.4 or higher ** * Tags * [CI](https://wordpress.org/plugins/tags/ci/)[deployment](https://wordpress.org/plugins/tags/deployment/) [push](https://wordpress.org/plugins/tags/push/)[shift8](https://wordpress.org/plugins/tags/shift8/) [woodpecker](https://wordpress.org/plugins/tags/woodpecker/) * [Advanced View](https://wordpress.org/plugins/shift8-deployment-manager-for-woodpecker-ci/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/shift8-deployment-manager-for-woodpecker-ci/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/shift8-deployment-manager-for-woodpecker-ci/reviews/) ## Contributors * [ shift8 ](https://profiles.wordpress.org/shift8/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/shift8-deployment-manager-for-woodpecker-ci/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.shift8web.ca)