General Troubleshooting

If you are having any issues with WP Pusher, here are a few points to help you out. If none of this helps, please don't hesitate to contact support.

Logging

You can enable logging under the "Log" tab in the WP Pusher settings area. Logging WP Pusher events makes debugging easier and attaching information from the log when contacting support is always helpful. Remember to disable logging when you're done debugging. Otherwise the log file might get our of hand.

Push-to-Deploy

If you are having issues with Push-to-Deploy, this is usually caused by 1 of 2 things:

  • Push-to-Deploy isn't enabled for the plugin or theme
  • The Push-to-Deploy URL returns a redirect response (see below)

301 redirect issue

If nothing happens when you push your code and you see nothing in the WP Pusher log, you most probably have a redirect problem (please refer to the guides for GitHub, Bitbucket or GitLab below to find debug information). If you get a 301 redirect response, WordPress and WP Pusher never received the webhook payload. This problem is caused by WordPress and your webserver being configured differently. Most probably one has a trailing slash and the other hasn't. WP Pusher uses WordPress' site_url to generate the Push-to-Deploy URL, so if this does not include a trailing slash when the server is configured to add one, this will cause a redirect. GitHub, Bitbucket or GitLab will not follow a redirect, so neither WordPress nor WP Pusher will know anything about the webhook and nothing will be updated.

Usually, adding or removing a trailing slash from the URL will solve this issue.

In these guides you can learn more about how you can dig out debugging information from the different Git hosting services:

FTP credentials

If WordPress prompts you to provide your FTP credentials while installing/updating a plugin or theme, WP Pusher won't work. Your server needs to be configured with the correct file permissions so that WordPress can write files, without using FTP. You can read more about WordPress and file permissions here.

Need any help?

If you have any questions about WP Pusher, Git or WordPress, our email is hi@wppusher.com. Don't hesitate shooting us a message!