PWA: установка и первый запуск

PWA превращает сайт на Webasyst в веб-приложение, которое посетитель может установить на поддерживаемый телефон или компьютер. Оно работает через манифест, иконки и Service Worker. PWA — самостоятельное приложение Webasyst, Shop-Script для установки не обязателен.

Версия и требования

Это руководство описывает PWA 1.6.2. Для неё нужны PHP 8.2–8.5 и Webasyst Installer 2.7 или новее. Проверьте версию PHP на хостинге до установки или обновления.

Что потребуется

• Сайт на HTTPS (для разработки допустим localhost).
• Адаптивная тема и браузер с поддержкой Service Worker.
• Отсутствие другого Service Worker, который контролирует тот же адресный диапазон (scope). Если он уже есть в теме или другом плагине, сначала разберитесь с совместимостью.
• Установленная коммерческая лицензия «База» или «Премиум» для соответствующей версии. Техническое название Free в исходниках не означает бесплатную лицензию.

Push-функции требуют «Премиум», согласия посетителя и поддержки браузера. Для iPhone нужно установить PWA на экран «Домой» и запросить разрешение в установленном приложении (iOS 16.4+).

Первый запуск версии 1.6.x

1. Установите или обновите PWA через Webasyst Installer, соблюдая требования версии. Перед обновлением сохраните резервные копии базы и wa-data/public/pwa.
2. Откройте PWA в панели администратора, выберите нужную витрину и запустите мастер настройки.
3. Пройдите пять этапов: основные параметры, кеширование, установка, Push (только Премиум) и проверка. Мастер объясняет, какие части подключить в тему сайта. Используйте код, показанный именно в вашей панели, а не со старого скриншота.
4. В разделе установки выберите подходящий способ предложения: баннер, снэк-бар, окно либо кнопку, которую требуется дополнительно разместить в шаблоне темы. Проверьте сайт по QR-коду на телефоне.
5. Откройте Диагностику, выполните проверки и исправьте обнаруженные проблемы. Проверьте установку, навигацию и offline-страницу на реальном устройстве.

Что проверить перед запуском

• Установленное PWA открывает нужную витрину.
• Изображения и обновляемый контент не остаются устаревшими из-за неподходящей стратегии кеширования.
• Корзина, оформление заказа и личный кабинет не обслуживаются из персонального кеша Service Worker PWA.
• При отключении сети появляется ожидаемая offline-страница, а не обещание «весь интернет-магазин офлайн».
• Если есть несколько витрин, каждая проверена отдельно.

Руководство по главам

Глава	О чём
Что такое PWA	Что получает покупатель и какие у технологии границы
Установка и быстрый старт	Мастер из пяти шагов и переход с версии 1.3.6
Настройки приложения	Иконки, Manifest, подключение к теме, несколько витрин
Кеширование и offline	Стратегии, предварительный кеш, offline-страница
Установка на устройства	Баннер, кнопка, окно, QR-код, Android, iPhone, компьютер
Push-уведомления	Подписки, ключи VAPID, рассылки, адресные уведомления
Диагностика	Девять проверок и отчёт для поддержки
Обновление и обслуживание	Резервные копии, безопасное обновление, смена ключей
«База» и «Премиум»	Какая редакция вам нужна
Вопросы и проблемы	Короткие ответы и ссылки на инструкции
Словарь терминов	Простые объяснения слов
Что нового	История выпусков 1.4.2–1.6.2

Если что-то не работает, укажите поддержке версию PWA, PHP и Webasyst, редакцию лицензии, адрес витрины, браузер и результат Diagnostics. Не передавайте секретные VAPID-ключи.