Настройка модуля «Колесо призов»

Геймификационный модуль с публичным колесом призов, монетами, заданиями и управлением наградами. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

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

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

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

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

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

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

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

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

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

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

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

• «Ежедневный бонус в монетах». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 25.
• «Лимит спинов в сутки (0 = без лимита)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 5.
• «Включить колесо призов». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true.
• «Цвет фона блока». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: #f97316. Сплошной цвет фона hero-блока. Используется если изображение фона не загружено или поверх него как overlay.
• «Второй цвет (градиент)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Опциональный второй цвет для градиента (linear-gradient от основного к этому). Оставить пустым — будет сплошной цвет.
• «Подзаголовок страницы». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: Крутите колесо, выполняйте задания и забирайте награды каждый день..
• «Цвет текста на фоне». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: #ffffff. Цвет заголовка, подзаголовка и подписи на фоне колеса.
• «Заголовок страницы». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: Колесо призов.
• «Подпись под колесом». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: Шансы и доступность наград управляются администратором. Для физических призов доступна ручная выдача..
• «Стоимость одного спина в монетах». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 25.
• «Фоновое изображение блока». Загрузите файл в формате, который указан в подсказке поля. Лучше использовать квадратный SVG или PNG, если это иконка. Используется в hero-блоке страницы и на карточке колеса.
• «Картинка в центре колеса». Загрузите файл в формате, который указан в подсказке поля. Лучше использовать квадратный SVG или PNG, если это иконка. Логотип или иллюстрация, которая отображается в центре колеса.

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

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

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

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

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

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