README

This package makes it easy to send Pushover notifications with Laravel Notifications.

Contents

• Installation
  • Setting up your Pushover account
• Usage
  • Advanced usage and configuration
  • Available Message methods
• Changelog
• Testing
• Security
• Contributing
• Credits
• License

Installation

You can install the package via composer:

composer require laravel-notification-channels/pushover

Support Policy

This package supports various versions of Laravel and PHP with different releases. Choose the correct package version for your project. Please note that older versions of this package are no longer being updated.

Setting up your Pushover account

To start sending messages via Pushover, you have to register an application. Add the generated Pushover application token to the services config file:

// config/services.php
'pushover' => [
    'token' => env('YOUR_APPLICATION_TOKEN'),
],

Usage

Now you can use the channel in your via() method inside the notification as well as send a push notification:

use NotificationChannels\Pushover\PushoverChannel;
use NotificationChannels\Pushover\PushoverMessage;
use Illuminate\Notifications\Notification;

class AccountApproved extends Notification
{
    public function via($notifiable)
    {
        return [PushoverChannel::class];
    }

    public function toPushover($notifiable)
    {
        return PushoverMessage::create('The invoice has been paid.')
            ->title('Invoice paid')
            ->sound('incoming')
            ->lowPriority()
            ->url('http://example.com/invoices', 'Go to your invoices');
    }
}

To send Pushover notifications to the notifiable entity, add the routeNotificationForPushover method to that model. Usually, this is the User model. The pushover_key could be a database field and editable by the user itself.

public function routeNotificationForPushover()
{
    return $this->pushover_key;
}

Advanced usage and configuration

If you want to specify specific devices, you can return a PushoverReceiver object.

public function routeNotificationForPushover() {
    return PushoverReceiver::withUserKey('pushover-key')
        ->toDevice('iphone')
        ->toDevice('desktop')
        // or, if you prefer:
        ->toDevice(['iphone', 'desktop']);
}

If you want to (dynamically) overrule the application token from the services config, e.g. because each user holds their own application token, return a PushoverReceiver object like this:

public function routeNotificationForPushover() {
    return PushoverReceiver::withUserKey('pushover-key')
        ->withApplicationToken('app-token');
}

You can also send a message to a Pushover group:

public function routeNotificationForPushover() {
    return PushoverReceiver::withGroupKey('pushover-group-key');
}

Available Message methods

Changelog

Please see CHANGELOG for more information what has changed recently.

Testing

composer test

Security

If you discover any security related issues, please email mail@casperboone.nl instead of using the issue tracker, or submit a vulnerability report using GitHub Security Advisories for this package.

Contributing

Please see CONTRIBUTING for details.

Credits

• Casper Boone
• Kevin Woblick
• All Contributors

License

The MIT License (MIT). Please see License File for more information.