Программа лояльности и бонусы

«Программа лояльности и бонусы» — модуль бонусной системы для ocStore 3. Покупатели получают кешбэк за заказы, подарки за регистрацию и ко дню рождения, а затем оплачивают часть покупки баллами. Владелец магазина управляет лимитами, уровнями клиентов, сроками активации и сгорания.

Техническое название — Smart Loyalty Pro, версия 1.0.1. Проверена установка и работа на ocStore 3.0.3.9 с PHP 8.2, стандартной темой и штатным оформлением заказа.

Возможности бонусной программы

• Приветственные баллы новым зарегистрированным покупателям.
• Кешбэк за покупки с настраиваемым процентом и периодом ожидания.
• Уровни клиентов по накопленному опыту XP и группе покупателей.
• Оплата части заказа баллами по заданному курсу.
• Бонус за отзыв с проверкой покупки и модерации.
• 200 баллов пригласителю за первый завершённый заказ друга.
• Ежегодный подарок ко дню рождения.
• Ручное начисление и списание, история операций в админке и личном кабинете.
• Возврат действующих баллов и отмена начислений при отмене заказа.

Кешбэк и уровни покупателей

Уровень определяет процент кешбэка и долю заказа, которую можно оплатить баллами. Названия уровней редактируются на языках магазина. Уровни выбираются внутри группы покупателя по порогу XP.

XP начисляется при активации бонусов, включая ручные начисления. Расход и сгорание баллов не уменьшают XP; отмена начисления уменьшает его. Нулевой процент уровня отключает соответствующий кешбэк или оплату баллами.

Оплата заказа бонусными баллами

Покупатель входит в аккаунт, раскрывает блок «Оплата бонусными баллами» в корзине, вводит целое количество и нажимает «Применить». Итог пересчитывается до оформления. «Отменить» убирает применение. Списание выполняется при подтверждении заказа.

Пример: подходящие товары без налогов стоят 500, курс равен 1, а уровень допускает оплату 30%. Максимум — 150 баллов при достаточном остатке. Если применить 100, конечный итог уменьшится ровно на 100. Кешбэк 3% от базы 500 составит 15 баллов.

Можно установить минимальную сумму корзины, исключить спеццены и запретить совмещение с купоном. Лимит уровня имеет приоритет над общим. Доставка не входит в базу кешбэка. Скидка не перераспределяет налоговые строки.

Отзывы, приглашения друзей и день рождения

Бонус за отзыв. Можно требовать завершённую покупку товара и одобрение отзыва администратором. Один клиент получает один бонус за конкретный товар. Отзывы, созданные до первой установки, не премируются.

Приглашение друга. В личном кабинете доступна персональная ссылка. Приглашение сохраняется на 30 дней. За первый завершённый заказ приглашённого клиента его пригласитель получает 200 баллов с установленным сроком ожидания. При отмене заказа начисление отзывается у пригласителя.

Подарок ко дню рождения. Клиент сохраняет дату один раз. Размер подарка, срок действия и число дней до даты задаёт магазин. Планировщик выдаёт один подарок в год в установленном интервале. Для 29 февраля в невисокосный год используется 28 февраля. Пропущенный целиком интервал не компенсируется задним числом.

Контроль баланса и возвраты

В личном кабинете покупатель видит доступные и ожидаемые баллы, ближайшее сгорание, уровень и историю. Администратору доступны журнал и отдельная вкладка в карточке клиента.

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

Если клиент уже потратил начисленные баллы, их отзыв может привести к отрицательному остатку; последующие начисления покрывают задолженность. Штатные бонусы и партнёрская программа движка сохраняются и учитываются отдельно.

Установка модуля

1. В админке откройте «Расширения → Установка расширений» и загрузите smart-loyalty-pro_oc3_v1.0.1.ocmod.zip. Не распаковывайте файл перед загрузкой.
2. В разделе «Модификаторы» нажмите «Обновить», затем очистите кеш темы на панели состояния.
3. В «Расширения → Расширения» выберите тип «Модули». В версии 1.0.1 строка называется «Smart Loyalty Pro — Система лояльности и бонусов». Нажмите установку и редактирование.
4. Включите модуль, задайте курс и статусы заказа, сохраните. Компонент учёта итогов заказа устанавливается автоматически.
5. Настройте ежедневный планировщик и выполните проверочный заказ.

Модуль использует OCMOD: исходные файлы ядра не заменяются.

Настройка после установки

Основное. Установите стоимость одного балла в основной валюте магазина. При курсе 1 один балл уменьшает итог на одну денежную единицу. Выберите округление кешбэка вниз, до ближайшего целого или вверх.

Начисление. Исходные значения: 100 баллов за регистрацию на 90 дней, 50 за отзыв, холд 14 дней, подарок ко дню рождения 300 баллов на 14 дней с начислением за 3 дня до даты. Значения меняются в настройках. Нулевой срок начисления означает отсутствие срока, нулевой холд — немедленную активацию.

Статусы заказа. Выберите реальный статус завершения для начисления и отдельный статус отмены для отката. Произвольный переход в другой статус с названием «Возврат» не заменяет выбранную настройку. Размер кешбэка фиксируется при оформлении заказа.

Списание. Задайте минимальную сумму товаров (исходно 500), процент оплаты, исключение спеццен и запрет сочетания с купоном. Проверьте также пределы уровней клиентов.

Ручные операции. В настройках или карточке клиента укажите ID покупателя, начисление либо списание, целое количество и описание. Для начисления задайте срок в днях; 0 — бессрочно. Нажмите «Применить» и проверьте журнал. Ручное начисление добавляет XP, списание его не уменьшает.

Настройка планировщика

1. Откройте вкладку «Журнал и планировщик» и скопируйте полный URL с ключом.
2. В панели хостинга настройте ежедневное обращение по этому адресу. Если требуется команда, используйте поддерживаемый хостингом HTTP-клиент или передайте задачу его поддержке.
3. Для проверки откройте URL вручную один раз и проверьте результат обработки, историю и балансы.

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

Проверочный сценарий

1. Зарегистрируйте тестового клиента и проверьте приветственный баланс.
2. Добавьте подходящий товар, примените баллы в корзине и оформите заказ.
3. Переведите заказ в настроенный статус начисления и проверьте кешбэк.
4. Проверьте одобрение отзыва, ручную операцию и личный кабинет.
5. Переведите заказ в настроенный статус отката: действующие списанные баллы должны вернуться, начисления за заказ — отмениться.

Обновление и отключение

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

Для временного отключения выключите статус и сохраните. Удаление версии 1.0.1 отключает обработчики, но сохраняет балансы, историю и настройки восстановления. Повторная установка не обнуляет данные и не выдаёт приветственные подарки повторно. Старые заказы 1.0.0 не содержат надёжного снимка списания и требуют отдельной проверки.

Частые вопросы

Почему в корзине нет оплаты баллами?

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

Почему кешбэк остаётся в ожидании?

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

Почему не начислен бонус за отзыв?

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

Что означает «Недостаточно бонусов» в заказе?

Баланс изменился между расчётом корзины и подтверждением. Модуль не подменяет полное списание частичным. Проверьте историю, пересчитайте или переоформите заказ либо восстановите достаточный баланс до повторного подтверждения.

Почему после установки не видно изменений?

Обновите модификаторы и кеш темы. Проверьте совместимость шаблона. При ошибке каталога используйте исправленный установочный ZIP и сообщите поддержке точную версию и текст ошибки.

Совместимость и требования

Проверены ocStore 3.0.3.9, PHP 8.2, стандартная тема и штатное оформление заказа. В пакете есть русская и английская локализации, ключ активации и ionCube не требуются. Нужны MySQL/MariaDB с InnoDB и GET_LOCK, один магазин и ежедневный планировщик.

OpenCart 3.0.4.1 проверен по исходникам, путям и OCMOD, но без отдельной установки через его админку. PHP 7.4 проверен на синтаксис; это не полный тест работы. Сторонние темы, ускоренное оформление и налоговые интеграции требуют отдельной проверки. Мультимагазинность и OpenCart/ocStore 4 этим пакетом не поддерживаются.