Настройка модуля «PWA»

Превращает сайт в Progressive Web App — установка на домашний экран, оффлайн-кэш, push-уведомления Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

• Площадкам, которые развивают публичные страницы, профили, карточки или визуальные блоки без доработки кода.
• Владельцам, которым нужно быстро проверить новую функцию на тестовой странице или объявлении.
• Командам, которые хотят управлять контентом из панели ADWOS CMS и не ждать отдельного релиза.

Что изменится на сайте

• В ADWOS CMS появляется новый публичный или визуальный сценарий без правки кода.
• Администратор настраивает поведение модуля из панели управления.
• Результат можно проверить на тестовой странице, профиле, объявлении или блоке.
• Владелец сохраняет контроль над публикацией и отображением контента.

Что подготовить заранее

Подготовьте доступы и тестовые данные до включения модуля. Так вы проверите сценарий спокойно и не затронете реальные заказы, пользователей или публичные страницы.

• Выберите тестовую страницу, профиль, объявление или публичный блок, где можно безопасно проверить результат.
• Проверьте права ролей, которые смогут создавать, редактировать или видеть новый контент.
• Если модуль влияет на публичную страницу, заранее учтите кеш и время обновления.
• Подготовьте текст, изображения или настройки, которые будут выглядеть нормально на desktop и mobile.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «PWA» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «Название приложения». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Полное имя приложения (как будет отображаться при установке).
• «Цвет фона splash-экрана». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: #ffffff. Цвет фона при запуске приложения (до загрузки сайта).
• «Стратегия кэширования». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: network-first. network-first — обычно онлайн, кэш только при сбое; cache-first — отдаёт из кэша, обновляет в фоне (быстрее, но может быть устаревшим); stale-while-revalidate — сначала кэш, потом обновляет.
• «Описание приложения». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий.
• «Режим отображения». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: standalone. standalone — без браузерных контролов (как нативное приложение); fullscreen — полноэкранный без статус-бара; minimal-ui — минимальный UI браузера.
• «Иконка приложения». Загрузите файл в формате, который указан в подсказке поля. Лучше использовать квадратный SVG или PNG, если это иконка. PNG/JPG/SVG/WEBP, рекомендуется квадратная 512×512 px. Используется на домашнем экране устройства, в push-уведомлениях и в shortcuts.
• «Страница оффлайн-режима». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: /offline. Что показать при отсутствии интернета (если страница не закэширована).
• «Короткое название». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Отображается на домашнем экране под иконкой. Если не задано — будет использовано полное имя (обрезано до 12 символов).
• «Начальный URL». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Значение по умолчанию: /. Куда попадает пользователь при открытии приложения с домашнего экрана.
• «Цвет темы». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: #3b82f6. Цвет верхнего бара браузера и системных элементов в режиме standalone.

После сохранения обновите страницу панели управления и убедитесь, что модуль остался включенным. Если есть тестовый режим, сначала завершите проверку в нем, а уже потом переходите на боевые ключи.

Проверка перед запуском

• Создайте или откройте тестовую страницу, профиль, объявление или публичный блок.
• Проверьте, что настройки модуля применились после сохранения.
• Если страница кешируется, очистите кеш или дождитесь обновления TTL.
• Проверьте отображение на desktop и mobile.

Частые ошибки

• Настройки не применились. Сохраните модуль повторно и обновите страницу панели управления.
• Функция не видна пользователю. Проверьте роли, категорию и публичное включение модуля.
• Данные не обновляются. Проверьте кеш, фоновые задачи и журналы модуля.
• Нужно временно остановить сценарий. Отключите модуль в панели управления, не удаляя его настройки.

Когда тест проходит без ошибок, оставьте модуль включенным и зафиксируйте, какие данные использовались для проверки. Это поможет быстро восстановить настройку после обновления или смены ключей.