PHPackages                             agoradesign/web\_push\_notification - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. agoradesign/web\_push\_notification

ActiveDrupal-module[Mail & Notifications](/categories/mail)

agoradesign/web\_push\_notification
===================================

Sends browser push notifications to users.

025PHP

Since Jan 8Pushed 1y ago1 watchersCompare

[ Source](https://github.com/agoradesign/web_push_notification)[ Packagist](https://packagist.org/packages/agoradesign/web_push_notification)[ RSS](/packages/agoradesign-web-push-notification/feed)WikiDiscussions 8.x-1.x Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

```
README.txt for Web Push Notification module
-------------------------------------------

INTRODUCTION
------------

Web Push Notification module allows you to send the browser push notifications.
See (https://developer.mozilla.org/en-US/docs/Web/API/Push_API) for details.

This module doesn't use any third-party services for sending notifications instead
it handles directly to the browser push services. Thus it can be used for low traffic
notifications but if you need to send mass of notifications you need to use
a foreign service anyway instead of this module.

The module registers a service worker to handle push notification and you may
to define pages where the service worker won't be registered (for example, contact pages, etc).

The notifications may be sent by manual or when a new content is added (the administrator
can choose content types to notify).

REQUIREMENTS
------------

  - SSL certificate is mandatory : Push notification will only work on
    domain with SSL enabled. For testing purposes you need to use
    localhost (127.0.0.1)

  - Please be sure that the following PHP extensions is installed and enabled:
    - curl extension (https://www.php.net/manual/en/book.curl.php)
    - gmp extension (https://www.php.net/manual/en/book.gmp.php)

  - Web Push library for PHP (installed automatically via composer)
    (https://github.com/web-push-libs/web-push-php)

  - Browser Push API compatibility:
    (https://developer.mozilla.org/en-US/docs/Web/API/Push_API#Browser_compatibility)

INSTALLATION
------------

 - Install the Web Push Notification module as you would normally install a contributed Drupal
   module. Visit https://www.drupal.org/node/1897420 for further information.
 - Install via composer:
    composer require drupal/web_push_notification

CONFIGURATION
-------------

After the module is installed open its configuration page (admin/config/services/web-push-notification)
and generate keys by pressing the "Generate keys" button.
Clear the cache and open the front page as an anonymous user. The browser will popup a dialog for subscribing
for the notifications. Accept it. In the configuration page on the "Subscriptions" tab you should see
a new subscriber. Go to "Test" tab, fill mandatory "Title" and "Message" fields and send a test message.

CONTENT NOTIFICATION
--------------------

If you want to notify about specific content (for example, a news is added) you should choose on
the configuration page which content type will be processed. Also, you can choose which fields of the
specified content type to use for the description and the image in a notification banner.

After the content is added the 'web_push_queue' queue will be created. You may process that queue
by the 'drush' command:

    drush queue:run web_push_queue

You can insert the above command in your system cron and invoke it, every 5 - 10 min.

TESTING
-------

As it said earlier the notifications only work on localhost. To test them, you need to run your site
on localhost. It can be easily done with the `drush` command in your project root:
```
drush serve
```
```

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity16

Early-stage or recently created project

 Bus Factor1

Top contributor holds 58.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5078744?v=4)[agoradesign](/maintainers/agoradesign)[@agoradesign](https://github.com/agoradesign)

---

Top Contributors

[![agoradesign](https://avatars.githubusercontent.com/u/5078744?v=4)](https://github.com/agoradesign "agoradesign (10 commits)")[![skoro](https://avatars.githubusercontent.com/u/6389201?v=4)](https://github.com/skoro "skoro (7 commits)")

### Embed Badge

![Health badge](/badges/agoradesign-web-push-notification/health.svg)

```
[![Health](https://phpackages.com/badges/agoradesign-web-push-notification/health.svg)](https://phpackages.com/packages/agoradesign-web-push-notification)
```

###  Alternatives

[maize-tech/laravel-email-domain-rule

Laravel Email Domain Rule

612.0k](/packages/maize-tech-laravel-email-domain-rule)[sarfraznawaz2005/noty

Laravel package to incorporate noty flash notifications into laravel.

324.5k](/packages/sarfraznawaz2005-noty)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)