Description
Easily trigger a GitHub Actions workflow from your WordPress site whenever a post is created, updated, or deleted. Perfect for headless WordPress setups to automate frontend deployments and keep your site in sync.
- Triggers a GitHub Actions workflow on post save or delete
- Manual deploy/reset options from the settings page
- Securely stores your GitHub token
- Works with any post type
External services
This plugin connects to the GitHub API to trigger GitHub Actions workflows. This service is required to automatically deploy your site when content changes.
The plugin sends the following data to GitHub’s API:
– Repository information (user/repo format)
– Workflow filename
– Branch reference (default: main)
– GitHub personal access token for authentication
This data is sent every time a post is created, updated, or deleted (when the post status is ‘publish’). The GitHub token is stored securely in your WordPress database and is never displayed in plain text.
This service is provided by GitHub, Inc.:
– Terms of Service: https://docs.github.com/en/site-policy/github-terms/github-terms-of-service
– Privacy Policy: https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement
Installation
- Upload the plugin files to the
/wp-content/plugins/wc-github-deployerdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Create a GitHub Personal Access Token in your GitHub account with ‘repo’ permissions for the target repository.
- Go to ‘Settings’ > ‘GitHub Deploy’ and configure your GitHub token, repository, workflow filename, and branch.
- Save changes. The plugin will now trigger your workflow on post save or delete.
FAQ
-
Is my GitHub token safe?
-
Yes, your token is stored securely in the WordPress options table and never displayed in plain text.
-
Can I trigger the deploy manually?
-
Yes, there is a button on the settings page to manually trigger the deploy.
-
Does it work with custom post types?
-
Yes, it works with any post type.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Deploy Trigger for GitHub” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Deploy Trigger for GitHub” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.4
- Fixed WordPress.org compliance issues
- Updated text domain to match plugin slug (deploy-trigger-for-github)
- Renamed all functions and options with unique prefix (depltrfo_)
- Added external services documentation for GitHub API
- Improved code structure and naming conventions
1.3
- Improved error handling and logging
- Updated documentation
1.2
- Added reset button to clear plugin data
- Improved code structure and security
1.1
- Added support for post deletion trigger
1.0
- Initial release