PHPackages                             phpbb/webpushnotifications - 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 &amp; Notifications](/categories/mail)
4. /
5. phpbb/webpushnotifications

ActivePhpbb-extension[Mail &amp; Notifications](/categories/mail)

phpbb/webpushnotifications
==========================

An official phpBB extension that allows board users to receive browser-based push notifications.

1.0.4(2mo ago)342GPL-2.0-onlyPHPPHP &gt;=7.3CI passing

Since May 12Pushed 2mo ago9 watchersCompare

[ Source](https://github.com/phpbb-extensions/webpushnotifications)[ Packagist](https://packagist.org/packages/phpbb/webpushnotifications)[ Docs](https://www.phpbb.com/customise/db/extension/webpushnotifications/)[ RSS](/packages/phpbb-webpushnotifications/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (17)Used By (0)

phpBB Browser Push Notifications
================================

[](#phpbb-browser-push-notifications)

This is the repository for the development of the phpBB Browser Push Notifications extension.

[![Build Status](https://github.com/phpbb-extensions/webpushnotifications/actions/workflows/tests.yml/badge.svg)](https://github.com/phpbb-extensions/webpushnotifications/actions)

An official phpBB extension that allows board users to receive browser-based push notifications.

**Important: Only official release versions validated by the phpBB Extensions Team should be installed on a live forum. Pre-release (beta, RC) versions downloaded from this repository are only to be used for testing on offline/development forums and are not officially supported.**

Contributing
------------

[](#contributing)

Please fork this repository and submit a pull request to contribute to this extension.

To run this extension from the repo (and not from a pre-built package) on a local server, perform the following tasks:

- Fork phpbb-extensions/webpushnotifications to your GitHub account, then create a local clone of it: ```
    git clone https://github.com/your_github_name/webpushnotifications.git
    ```
- Install this extension's dependencies (from the root of your webpushnotifications repo): ```
    cd webpushnotifications # navigate into the root of your webpushnotifications repo
    php composer.phar install # installs extension's 3rd-party dependencies
    ```
- Install the extension to your local phpBB forum by moving your local repo to the proper phpBB directory: ```
    cd ../ # back out one directory level
    mv webpushnotifications path_to_phpBB/ext/phpbb # move webpushnotifications to your phpBB/ext/phpbb directory
    cd path_to_phpBB # navigate to your phpBB forum's root directory
    php bin/phpbbcli.php extension:enable phpbb/webpushnotifications # install the extension
    ```

Browser Support
---------------

[](#browser-support)

Web BrowserPlatformWeb Push Notification SupportBackground Notification Support (When Browser Closed)**Google Chrome**macOS✅ Yes❌ No (unless running in the background)Windows✅ Yes❌ No (unless running in the background)iOS❌ No❌ NoAndroid✅ Yes✅ Yes**Safari**macOS✅ Yes✅ YesiOS✅ Yes✅ Yes (site must be added to Home Screen first)**Microsoft Edge**macOS✅ Yes❌ No (unless running in the background)Windows✅ Yes❌ No (unless running in the background)iOS❌ No❌ NoAndroid✅ Yes✅ Yes**Mozilla Firefox**macOS✅ Yes❌ NoWindows✅ Yes❌ NoiOS❌ No❌ NoAndroid✅ Yes❌ No**Opera**macOS✅ Yes❌ NoWindows✅ Yes❌ NoiOS❌ No❌ NoAndroid✅ Yes❌ No*(unless running in the background)* means the browsers have background processes running (they’re not fully quit).

More info here

Testing Push Notifications
--------------------------

[](#testing-push-notifications)

Testing push notifications necessitates user-to-user interactions to observe the notification behavior accurately. Follow the steps outlined below to effectively test push notifications (the browser recommendations are what we have seen work in local environments):

1. **User Account Setup:**

    - Create at least two distinct board user accounts for testing purposes.
    - Using Google Chrome, visit `UCP -> Board Preferences -> Edit notification options` for ***User Account 1*** and enable Push Notifications (and enable all web push notification types if necessary). Your browser may ask you to allow notifications, which you should accept. Leave Chrome open and running the background.
2. **Message, Quote, or Reply Interaction:**

    - Initiate a user-to-user interaction by performing one of the following actions using ***User Account 2*** in separate browser such as Firefox, Edge or Safari:
        - **Private Message:** Send a direct message from ***User Account 2*** to ***User Account 1***.
        - **Quote:** Quote a post or message authored by ***User Account 1*** using ***User Account 2***.
        - **Reply:** Respond to a post or message authored by ***User Account 1*** using ***User Account 2***.
3. **Observing Push Notifications:**

    - Once the interaction is performed from ***User Account 2*** to engage with ***User Account 1***, you promptly should see a notification from Google Chrome for ***User Account 1***.
4. **Caveats for Local Testing**

    - Local testing of Push Notifications only works from a `http://localhost` address or if your local test server has a secure SSL certificate, e.g.: `https://local.phpbb.board`.
    - Depending on your local server's setup, operating system, and browsers, it is still possible that testing push notifications may not work (for example, in a local environment running on macOS, only Chrome will show notifications).

License
-------

[](#license)

[GNU General Public License v2](license.txt)

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance86

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 89.9% 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.

###  Release Activity

Cadence

Every ~46 days

Recently: every ~147 days

Total

15

Last Release

86d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f27058bb08dbf78f4871638ee8b4a7367938147dc0ee2f6fe9fbc7f9fa945759?d=identicon)[MattF](/maintainers/MattF)

---

Top Contributors

[![iMattPro](https://avatars.githubusercontent.com/u/303711?v=4)](https://github.com/iMattPro "iMattPro (470 commits)")[![rxu](https://avatars.githubusercontent.com/u/212322?v=4)](https://github.com/rxu "rxu (53 commits)")

### Embed Badge

![Health badge](/badges/phpbb-webpushnotifications/health.svg)

```
[![Health](https://phpackages.com/badges/phpbb-webpushnotifications/health.svg)](https://phpackages.com/packages/phpbb-webpushnotifications)
```

###  Alternatives

[laravel-notification-channels/webpush

Web Push Notifications driver for Laravel.

7984.5M16](/packages/laravel-notification-channels-webpush)[bentools/webpush-bundle

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

71274.3k](/packages/bentools-webpush-bundle)[dereuromark/cakephp-mailchimp

A CakePHP plugin for MailChimp

2217.9k](/packages/dereuromark-cakephp-mailchimp)[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

522.0k](/packages/etailors-mautic-amazon-ses)

PHPackages © 2026

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