bentools/webpush-bundle

Send push notifications through Web Push Protocol to your Symfony users.

Maintainers

Details

github.com/bpolaszek/webpush-bundle

Installs: 6 616

0.5 2019-02-05 09:26 UTC

Requires

php: >=7.1
ext-curl: *
ext-json: *
ext-mbstring: *
ext-openssl: *
guzzlehttp/guzzle: ~6.0
minishlink/web-push: ^4.0|^5.0
symfony/http-kernel: ^3.0|^4.0

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 7655e41f49dcccea9bd11e82a2e35cdbc48fa10b

Beno!t POLASZEK <bpolaszek.woop@gmail.com>

browser notifications subscription notification push chrome push notification push notifications subscriptions flex notification bundle firefox WebPush FCM Web Push vapid web push notification notifications bundle symfony notifications web push notifications push subscription PushNotification PushNotification bundle PushSubsciption PushSubsciption bundle subscription bundle subscriptions bundle push bundle push notification bundle push notifications bundle push subscription bundle push subscriptions push subscriptions bundle webpush protocol webpush bundle webpush notification webpush notification bundle webpush notifications webpush notifications bundle webpush subscription webpush subscription bundle webpush subscriptions webpush subscriptions bundle web push protocol web push bundle web push notification bundle web push notifications bundle web push subscription web push subscription bundle web push subscriptions web push subscriptions bundle symfony PushNotification symfony PushNotification bundle symfony PushSubsciption symfony PushSubsciption bundle symfony notification symfony notification bundle symfony notifications bundle symfony subscription symfony subscription bundle symfony subscriptions symfony subscriptions bundle symfony push symfony push bundle symfony push notification symfony push notification bundle symfony push notifications symfony push notifications bundle symfony push subscription symfony push subscription bundle symfony push subscriptions symfony push subscriptions bundle symfony webpush symfony webpush bundle symfony webpush notification symfony webpush notification bundle symfony webpush notifications symfony webpush notifications bundle symfony webpush subscription symfony webpush subscription bundle symfony webpush subscriptions symfony webpush subscriptions bundle symfony web push symfony web push bundle symfony web push notification symfony web push notification bundle symfony web push notifications symfony web push notifications bundle symfony web push subscription symfony web push subscription bundle symfony web push subscriptions symfony web push subscriptions bundle

dev-master / 1.0.x-dev
0.5
0.4
0.3.4
0.3.3
0.3.2
0.3.1
0.3
0.2.1
0.2
0.1
dev-fix-travis
dev-minishlink-webpush5-support
dev-symfonyflex
dev-fix-2

README

Webpush Bundle

This bundle allows your app to leverage the Web Push protocol to send notifications to your users' devices, whether they're online or not.

With a small amount of code, you'll be able to associate your Symfony users to WebPush Subscriptions:

A single user can subscribe from multiple browsers/devices
Multiple users can subscribe from a single browser/device

This bundle uses your own persistence system (Doctrine or anything else) to manage these associations.

We assume you have a minimum knowledge of how Push Notifications work, otherwise we highly recommend you to read Matt Gaunt's Web Push Book.

Example Use cases

You have a todolist app - notify users they're assigned a task
You have an eCommerce app:
- Notify your customer their order has been shipped
- Notify your category manager they sell a product

Summary

Getting started

This bundle is just the back-end part of the subscription process. For the front-end part, have a look at the webpush-client package.

Composer is your friend:

PHP7.1+ is required.

composer require bentools/webpush-bundle 0.4.*

If you're using Symfony 3, add the bundle to your kernel. With Symfony Flex, this should be done automatically.

⚠️We aren't on stable version yet - expect some changes.

Generate your VAPID keys:

php bin/console webpush:generate:keys

You'll have to update your config with the given keys. We encourage you to store them in environment variables or in parameters.yml.

Next: Create your UserSubscription class

Tests

./vendor/bin/phpunit

License

MIT

Credits

This bundle leverages the minishlink/web-push library.