Total Pushover

Redirects all outgoing site email to the Pushover notification service.

Description

Total Pushover redirects all WordPress generated emails to the Pushover notification service. Pushover is an app that provides real-time notifications on your iOS or Android devices.

This plugin is especially handy when you don't want to worry about setting up either an SMTP or transactional mail plugin on a development sites.

It is suggested that this plugin only be used on single-user WordPress installs. Everything that your site would usually mail out — including password reset requests for all site users — will be sent to the Pushover account that you've configured.

Features

• Automatically intercepts all wp_mail function and redirects the output to Pushover.
• Logs errors if the notification fails to be sent to Pushover.
• Configuration via constants in wp-config.php.

Installation

1. Upload the plugin to the /wp-content/plugins/ directory, or install the plugin directly via the WordPress plugins screen.

2. Activate the plugin through the 'Plugins' screen in WordPress.

3. Add the following constants to your wp-config.php file:

   define('PUSHOVER_API_TOKEN', 'your-pushover-api-token');
   define('PUSHOVER_USER_KEY', 'your-pushover-user-key');

Frequently Asked Questions

Why is there not a settings page?

This plugin should be considered a developer tool. If you are not comfortable adding constants to wp-config.php you should reconsider using this plugin on your site.

How do I get a Pushover User Key and API Token?

To use this plugin, you need both a Pushover User Key and an API Token:

1. Create a Pushover Account
   First, visit Pushover.net and create a free account. You can use the same account on both your desktop and mobile devices.

2. Find Your User Key
   After logging in, navigate to your Pushover dashboard. Your User Key will be displayed under the "Your User Key" section. This is a unique identifier that allows you to receive notifications.

3. Generate an API Token
   To generate a new API Token, visit Pushover Apps.

   • Click "Create a New Application/API Token".
   • Fill in the details like the application's name and description.
   • After submitting, your API Token will be shown. This token authorizes the plugin to send notifications to your account.

4. Configure in wp-config.php
   After copying both your User Key and API Token, add the following constants to your wp-config.php file:

   define('PUSHOVER_API_TOKEN', 'your-pushover-api-token');
   define('PUSHOVER_USER_KEY', 'your-pushover-user-key');

How do I make sure I've configured my API Token and User Key correctly?

As of version 1.1.0, there's a link on the "Plugins -> Installed Plugins" page (when the plugin is active) that will send you a test message.

Would you consider adding Pushbullet support?

This plugin was created and — continues to be maintained — for totally selfish personal reasons. Since I don't use Pushbullet at all, I don't feel that I could adequately support that service.

Will you add support for per-user Pushover settings?

I would prefer not to.

Changelog

1.2.0

• Added nonce verification and capability check to the test message action to prevent CSRF.
• Added HTTP status code validation when calling the Pushover API.
• Added Text Domain header and textdomain to all translatable strings.
• Used esc_html__() in all HTML output contexts.
• Removed spurious ob_start() call.
• Bumped minimum WordPress requirement to 6.5 and PHP requirement to 8.0.

1.1.0

• Added Test link to Plugins page so you could check that things are configured correctly.

1.0.0

• Initial release of the plugin.

License

This plugin is licensed under the GPLv2 or later. For more details, please refer to the license file in the plugin package or visit the GPLv2 License page.