Бонусная система для Woo (B2B)

Раздел представляет собой таблицу всех пользователей системы с колонками: ФИО/Email, текущий баланс бонусов и процент прогресса (вероятно, до следующего порога или цели). Для каждой записи доступны три действия — «Баланс» (открывает окно изменения баланса с возможностью указать сумму +/- и причину изменения), «Прогресс» (окно ручной корректировки процента прогресса 0-100%) и «История» (модальное окно с лентой всех операций по бонусам данного пользователя с датами, типами изменений и примечаниями). Доступен поиск по имени и email пользователя.

Этот раздел содержит полный список всех событий, связанных с изменением бонусов (начисление, списание, возврат, корректировка) всех пользователей. В таблице выводятся следующие данные: ID операции, дата и время, пользователь (с ID), тип операции, сумма изменения, баланс после операции, номер заказа (если операция связана с заказом) и примечание. Доступна фильтрация по типам событий (например, только «Списание» или «Начисление») и удобный поиск по ID пользователя с возможностью сброса фильтров.

Раздел служит справочной информацией по интеграции бонусной системы с контентом сайта и email-уведомлениями WooCommerce. Описываются шорткоды:

• [your_bonus] — вывод текущего баланса авторизованного пользователя.

• [bonus_per_unit] — вывод количества бонусов за единицу товара (на странице товара или для конкретного product_id).

• [bonus_order_total] / [bonus_redeemed] — вывод начисленных или списанных бонусов за конкретный заказ (особенно полезно в email-шаблонах WooCommerce).

• [bonus_history] — вывод полной таблицы истории операций текущего пользователя с параметром limit.
  Также дана пошаговая инструкция по созданию кастомной страницы «История моих бонусов» через шорткод [bonus_history] и её привязке в настройках плагина.

Раздел позволяет администратору создать многоуровневую систему мотивации крупных покупок. В табличном виде задаются пороговые значения: диапазон суммы заказа (в рублях, например «от 50 000 до 100 000») и соответствующее количество бонусов, которое получит пользователь при достижении этой суммы. Бонусы за порог суммируются с бонусами за отдельные товары в заказе. Для каждого правила доступно действие «Удалить». Пример из данных показывает прогрессивную шкалу от 2000 бонусов за 50-100к руб. до 16000 бонусов за 400-450к руб.

Ключевой раздел для конфигурации бизнес-логики бонусов. Включает несколько блоков:

• Начисление бонусов: Выбор статуса заказа (например, «Выполнен»), при котором бонусы будут зачислены пользователю.

• Списание бонусов: Режим «Скидка деньгами»; курс (1 бонус = X рублей); максимальный процент от суммы заказа, который можно оплатить бонусами (например, не более 5%); правило округления (Вниз/Floor).

• Поведение гостей: Опция «Запретить бонусы» для неавторизованных покупателей.

• Применение скидки: Настройка порядка применения скидки (до налогов или после других купонов).

• Интерфейс пользователя: Поле для вставки кастомной ссылки на страницу «Мои бонусы» в личном кабинете.

• Логирование: Включение/отключение записи системных логов и выбор уровня логирования (например, «Дебаг»).

Раздел для интеграции с мессенджером Telegram с целью оперативного информирования о новых заказах. Администратор должен заполнить обязательные поля: «Токен бота Telegram» (получается у @BotFather) и «Chat ID / ID группы» (получается через специальных ботов). Встроенная кнопка «Проверить подключение» отправляет тестовое сообщение для валидации настроек. Чекбокс «Включить уведомления» активирует отправку. Предусмотрена кнопка для перехода к настройке шаблона сообщения.

Этот раздел позволяет гибко настроить внешний вид и содержание уведомлений в Telegram. Администратор может создавать сообщение, используя текстовые поля, эмодзи и специальные переменные-плейсхолдеры. Доступные переменные: {order_id}, {customer_name}, {customer_email}, {order_total}, {bonuses_accrued}, {bonuses_redeemed}, {order_items}, {order_link}, {payment_method}, {customer_inn}, {customer_company} и другие. Есть кнопка «Сохранить шаблон», сброс к стандартному, а также блок «Предварительный просмотр», демонстрирующий, как сообщение будет выглядеть в Telegram на основе текущего шаблона.

Раздел отображает последние 20 заказов, затронувших бонусную систему. Для каждого заказа предоставляется расширенная карточка: номер заказа, дата, статус, клиент (имя и ID), сумма заказа, количество начисленных (+) и списанных (-) бонусов. Особую ценность представляет блок «Баланс пользователя», показывающий состояние баланса «До списания: X → После списания: Y (изменение)». Также выводится список товаров в заказе и кнопка для перехода к заказу в админке. Кроме того, здесь доступна вкладка «Системные логи» для более глубокой технической отладки.

• Статистика: Дашборд с метриками: всего пользователей, с бонусами, активных, с балансом >0, глобальные суммы начисленных (310 165) и списанных (143 583) бонусов.

• Бонусы пользователей: Таблица (ID, Email, Баланс, Прогресс). Для каждого — три действия:

  • Редактирование баланса: ручное изменение (+100 или -50) с обязательным примечанием причины.

  • Редактирование прогресса: установка процента от 0 до 100.

  • История: модальное окно со всеми транзакциями пользователя (дата, тип, изменение, баланс после, примечание, заказ).

• Глобальная история операций: Все транзакции системы с фильтрацией по типу (начисление, списание, возврат, корректировка) и поиском по ID пользователя. Отображает ID операции, дату, пользователя, тип, изменение, баланс после, заказ и примечание.

Администратор задает диапазоны сумм заказа и соответствующие бонусы, которые начисляются поверх бонусов за товары. Пример из настроек:

• 50 000 – 100 000 ₽ → +2000 бонусов
• 100 000 – 150 000 ₽ → +4000 бонусов
• …
• 400 000 – 450 000 ₽ → +16000 бонусов

• Начисление: Статус заказа для начисления (например, «Выполнен»).
• Списание: Режим «Скидка деньгами», курс (1 бонус = 1 ₽), макс. списание в % от заказа (5%), округление (вниз/floor).
• Гости: Запрет бонусов для неавторизованных.
• Применение скидки: До налогов или после купонов.
• Интерфейс: Поле для кастомной ссылки на страницу «Мои бонусы».
• Логирование: Включение записи логов и выбор уровня (debug).

• Настройки подключения: Токен бота (8330317429:AAGZa0Y8q…), Chat ID (-1003104670205), кнопка проверки подключения.
• Шаблон сообщения: Редактор с поддержкой эмодзи и 15+ переменными:
• {order_id}, {customer_name}, {customer_email}, {customer_phone}
• {bonuses_accrued}, {bonuses_redeemed}
• {order_items} (список товаров с количеством и ценой)
• {customer_inn}, {customer_company}, {customer_city}
• {order_link} (ссылка на заказ в админке)
• Предварительный просмотр шаблона в реальном времени.

Доступные шорткоды:

• [your_bonus] — текущий баланс пользователя.
• [bonus_per_unit product_id=»123″] — бонусы за единицу товара.
• [bonus_order_total order_id=»456″] — начислено за заказ.
• [bonus_redeemed order_id=»456″] — списано за заказ.
• [bonus_history limit=»50″] — таблица истории операций.

Интеграция с WooCommerce: Шорткоды работают в email-шаблонах (тема и тело письма), на странице «Спасибо за заказ», в виджетах, описаниях товаров.

Пример использования в email:

• Заказ #{order_number} — начислено [bonus_order_total] бонусов!
• Ваш текущий баланс: [your_bonus]