Push notifications and PWA app
Push notifications for your shop: a shopper allows them once and hears about their order, restocked items and discounts even with the site closed — with no per-message fee like SMS. Push sits next to email and SMS: the same shop events, the same texts, the same log; it also sends broadcasts to everyone subscribed, and the panel lists subscribers with their devices. Permission is asked after the shopper has looked around, not on arrival — a browser remembers a refusal forever. The second half is PWA: your storefront becomes an app, so shoppers add it to the phone home screen and open it in one tap without the address bar. Name, icon, colours, launch mode and quick actions are set per storefront, and icons are cut from a single image. Platform differences are handled: Android gets an install button, iPhone gets a hint, because the button does not exist there.
Screenshots are coming soon.
What appears in the shop
This is what a shopper sees once it is installed.
- The page head gets the shop-as-an-app description: name, icon and colours for the phone. Nothing visible appears on the page. Name, icon and colours come from the plugin settings for this storefront.
- A small card appears at the bottom asking about notifications and offering to add the shop to the phone. Texts and timing are in the plugin settings, the look is in the design editor. The «Restore original look» button brings the original card back.
New shop pages
- /manifest.webmanifest The shop-as-an-app description: the phone uses it to offer installation and draw the icon.
- /push-worker.js The handler that shows a notification even when the shop is closed. The file appears in the site root by itself: a browser allows notifications only where the handler lives and below.
- /web-push/… The addresses the browser uses to tell the shop about allowing or refusing notifications.
Уведомления в браузере и магазин на телефоне
Плагин даёт магазину бесплатный канал связи и превращает витрину в приложение.
Что делает
- Уведомления. Покупатель один раз разрешает их и получает сообщения магазина, даже когда сайт закрыт. Канал встаёт рядом с почтой и SMS: те же события, те же шаблоны, тот же журнал. Им же можно сделать рассылку.
- Магазин на телефоне. Витрина описывает себя приложением: имя, значок, цвета, запуск без адресной строки. Покупатель ставит её на главный экран.
Как устроено
| Часть | Где |
|---|---|
| Подпись магазина (ключи VAPID) | подключение канала webpush — шифруется вместе с остальными доступами |
| Подписки браузеров | таблица web_push_subscriptions, по одной на устройство |
| Обработчик уведомлений | маршрут /push-worker.js — с корня сайта, иначе браузер ограничит его одной папкой |
| Описание приложения | маршрут /manifest.webmanifest |
| Окошко на витрине | шаблон темы plugins/web-push/prompt.html + push.js |
Что учтено про платформы
- Разрешение спрашиваем не сразу: отказ браузер запоминает надолго, переспросить магазин не сможет. Момент задаётся настройкой (секунды + страницы).
- iPhone показывает уведомления только установленному магазину (iOS 16.4+). Пока витрина живёт вкладкой, вопрос не задаётся вовсе — иначе покупатель решит, что уведомления сломаны.
- Кнопки установки на iPhone не существует — там показывается подсказка «Поделиться → На экран „Домой“», а кнопка убирается.
- Значки нарезаются из одной картинки: 192, 512, отдельный «обрезаемый» с полями (система вправе вписать его в круг) и 180 для iPhone.
Требования
PHP с openssl (создание ключа P-256) и curl. Отправку выполняет
minishlink/web-push, он лежит в vendor/ плагина.
Plain names
The add-on now uses the familiar terms: push notifications and a PWA app. The notification channel and the settings tabs are named the same way.
Phones now offer to install your shop
The storefront answers even without the internet — with a «no connection» page instead of a browser error — and phones finally offer to add it to the home screen.
A list of subscribers
You can see who is subscribed: device and browser, a known shopper or a guest, when they subscribed and when they last got a notification. Any device can be unsubscribed by hand.
Allowed means subscribed
If the browser already has permission, the shop subscribes by itself. Before that a shopper could end up with no notifications while being sure they had subscribed.
Subscribing from a phone, and an install offer
Permission given on a phone now reaches the shop, and the storefront offers to add itself to the home screen. The settings explain that an app icon is required for that.
A subscriber is not lost to a network glitch
A failed send no longer deletes a live subscriber — the shop will try again.
Broadcasts reach everyone
One broken subscriber no longer aborts delivery for the rest: previously nobody in the batch received the notification.
Ready right after installation
Everything notifications need appears with the very first page of your shop, not once you reach the settings.
Notifications work on every page
The notification handler now sits in the shop root. On some servers requests never reached it, and notifications quietly did not work.
Browser notifications and the shop on a phone
A shopper allows notifications once and hears about their order, restocked items and discounts even with the site closed — with no per-message fee like SMS. The same add-on lets them put your storefront on the phone home screen.