This package makes it easy to send Pushover notifications with Laravel Notifications (included in Laravel 5.3 and higher).
You can install the package via composer:
composer require laravel-notification-channels/pushover
For Laravel 5.4 or lower, you must add the service provider to the app config:
// config/app.php
'providers' => [
...
NotificationChannels\Pushover\PushoverServiceProvider::class,
],
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' => 'YOUR_APPLICATION_TOKEN',
],
...
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');
}
}
Make sure there is a routeNotificationForPushover
method on your notifiable model, for instance:
...
public function routeNotificationForPushover()
{
return $this->pushover_key;
}
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']);
}
You can also send a message to a Pushover group:
...
public function routeNotificationForPushover() {
return PushoverReceiver::withGroupKey('pushover-group-key');
}
Please note that only the message content is mandatory, all other methods are optional. The message content can be set via content('')
, via the create method PushoverMessage::create('')
or via the constructor new PushoverMessage('')
.
content($message)
: Accepts a string value for the message text.title($title)
: Accepts a string value for the message title.time($timestamp)
: Accepts either aCarbon
object or an UNIX timestamp.url($url[, $title])
: Accepts a string value for a supplementary url and an optional string value for the title of the url.sound($sound)
: Accepts a string value for the notification sound.priority($priority[, $retryTimeout, $expireAfter])
: Accepts an integer value for the priority and, when the priority is set to emergency, also an integer value for the retry timeout and expiry time (in seconds). Priority values are available as constants:LOWEST_PRIORITY
,LOW_PRIORITY
,NORMAL_PRIORITY
andEMERGENCY_PRIORITY
.lowestPriority()
: Sets the priority to the lowest priority.lowPriority()
: Sets the priority to low.normalPriority()
: Sets the priority to normal.highPriority()
: Sets the priority to high.emergencyPriority($retryTimeout, $expireAfter)
: Sets the priority to emergency and accepts integer values for the retry timeout and expiry time (in seconds).
Please see CHANGELOG for more information what has changed recently.
$ composer test
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Please see CONTRIBUTING for details.
The MIT License (MIT). Please see License File for more information.