Настройка модуля «Реферальная программа»

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

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

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

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

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

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

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

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

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

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

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

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

• «Модуль включён». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Активировать реферальную программу. Каждый юзер получит реф-код; с покупок приведённых будет начисляться процент.
• «Процент вознаграждения». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 5. Процент от суммы каждой покупки реферала, который начисляется приведшему на бонусный баланс. Например, 5 = 5%.

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

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

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

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

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

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