laravel-notification-channels/webpush

Web Push Notifications driver for Laravel.

Web Push Notifications Channel for Laravel

, _(*1)

This package makes it easy to send web push notifications with Laravel., _(*2)

Installation

You can install the package via Composer:, _(*3)

composer require laravel-notification-channels/webpush

First, add the NotificationChannels\WebPush\HasPushSubscriptions trait to your User model:, _(*4)

use NotificationChannels\WebPush\HasPushSubscriptions;

class User extends Model
{
    use HasPushSubscriptions;
}

Next, publish the migration with:, _(*5)

php artisan vendor:publish --provider="NotificationChannels\WebPush\WebPushServiceProvider" --tag="migrations"

Run the migrate command to create the necessary table:, _(*6)

php artisan migrate

You can also publish the config file with:, _(*7)

php artisan vendor:publish --provider="NotificationChannels\WebPush\WebPushServiceProvider" --tag="config"

Generate the VAPID keys (required for browser authentication) with:, _(*8)

php artisan webpush:vapid

This command will set VAPID_PUBLIC_KEY and VAPID_PRIVATE_KEY in your .env file. You need the VAPID_PUBLIC_KEY as applicationServerKey when using the Push API., _(*9)

Note: If targeting Safari or iOS after 2023, you will need to include the VAPID_SUBJECT variable as well, or Apple will return a BadJwtToken error., _(*10)

These keys must be safely stored and should not change., _(*11)

Usage

Now you can use the channel in your via() method inside the notification and send a web push notification:, _(*12)

use Illuminate\Notifications\Notification;
use NotificationChannels\WebPush\WebPushMessage;
use NotificationChannels\WebPush\WebPushChannel;

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

    public function toWebPush($notifiable, $notification)
    {
        return (new WebPushMessage)
            ->title('Approved!')
            ->icon('/approved-icon.png')
            ->body('Your account was approved!')
            ->action('View account', 'view_account')
            ->options(['TTL' => 1000]);
            // ->data(['id' => $notification->id])
            // ->badge()
            // ->dir()
            // ->image()
            // ->lang()
            // ->renotify()
            // ->requireInteraction()
            // ->tag()
            // ->vibrate()
    }
}

You can find the available options here., _(*13)

Save/Update Subscriptions

To save or update a subscription, use the updatePushSubscription($endpoint, $key = null, $token = null, $contentEncoding = null) method on your user:, _(*14)

$user = \App\User::find(1);

$user->updatePushSubscription($endpoint, $key, $token, $contentEncoding);

The $key and $token are optional and are used to encrypt your notifications. However, all major browsers require encryption when sending notifications., _(*15)

When using the Push API, $key is the value of the getKey('p256dh') method, and $token is the value of the getKey('auth') method of the PushSubscription interface., _(*16)

Delete Subscriptions

To delete a subscription, use the deletePushSubscription($endpoint) method on your user:, _(*17)

$user = \App\User::find(1);

$user->deletePushSubscription($endpoint);

Browser Compatibility

See the Push API browser compatibility., _(*18)

Changelog

Please see CHANGELOG for more information about what has changed recently., _(*19)

Testing

composer test

Security

If you discover any security-related issues, please email themsaid@gmail.com instead of using the issue tracker., _(*20)

Contributing

Please see CONTRIBUTING for details., _(*21)

Credits

• Cretu Eusebiu
• All Contributors

License

The MIT License (MIT). Please see License File for more information., _(*22)