Features
- Install and update your WordPress themes and plugins directly from GitHub
- BitBucket support
- Easy version control of your clients code
- Works everywhere because it hooks in to the WordPress core auto updater
- No Git or SSH needed on the server
PRO features
- Push-to-deploy can automatically trigger updates when whenever you push to GitHub (Coming soon)
- E-mail support
Learn more about PRO
Coming soon
- Support for self-hosted Git repositories like GitLab
- Release notifications in WordPress dashboard - notify clients on updates
Get started
If you already use Git for your projects and your themes and plugins are in their own repositories on GitHub, getting started with WP Pusher is simple and easy. Just go to "New plugin" or "New theme" in the WP Pusher menu and type in the repository for the package: github-username/repository-name
If any of your plugins or themes are in private repositories on GitHub, WP Pusher will need a token to access them. You can read GitHub's guide to application tokens
here. Paste in the token at WP Pusher settings page.
Conventions
- Theme stylesheets must be named the same as the repository
- Plugin directories must be named the same as the repository
- GitHub version tags must be numeric, such as '1.0' or '1.0.1', with an optional preceding 'v', such as 'v1.0.1'
- WordPress version tags must be numeric, such as '1.0' or '1.0.1'
Git workflow
The way WP Pusher works, packages (themes and plugins) need to be in their own repositories. If your packages are in their own repositories already, you can safely skip this section. Some developers prefer having their whole WordPress installation under Git, which potentially makes things a bit more complicated. By having all packages in their own repositories, you can easily share code across clients / projects. Since you shouldn’t be editing the core WordPress code, in most cases having the whole project under Git shouldn’t be necessary. However, if for some reason your project require that you have one Git repository for the whole project, you will have to use Git submodules, so that you can still have every package in its own (sub) repository.
Using The WordPress Dashboard
- Navigate to the 'Add New' in the plugins dashboard
- Search for 'WP Pusher'
- Click 'Install Now'
- Activate the plugin on the Plugin dashboard
Uploading in WordPress Dashboard
- Navigate to the 'Add New' in the plugins dashboard
- Navigate to the 'Upload' area
- Select
wp-pusher.zip
from your computer
- Click 'Install Now'
- Activate the plugin in the Plugin dashboard
Using FTP
- Download
wp-pusher.zip
- Extract the
wppusher
directory to your computer
- Upload the
wppusher
directory to the /wp-content/plugins/
directory
- Activate the plugin in the Plugin dashboard