=== Total Pushover ===
Contributors: Jason Cosper
Donate link: https://littleroom.studio/
Tags: pushover, notifications, email, wp_mail
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Redirects all WordPress emails 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 is especially handy when you don't want to worry about setting up either an SMTP or transactional mail plugin on your 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](https://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](https://pushover.net/apps/build).  
   - 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');
   ```

= 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.0 =
* Initial release of the plugin.

== Upgrade Notice ==

= 1.0 =
Initial release. No upgrade is needed.

== 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](https://www.gnu.org/licenses/gpl-2.0.html).