Модуль для реализации бонусной реферальной программы.
Установка
Создать таблицы в базе.
mysql -D abills < db/Referral.sql
Подключение модуля. abills/libexec/config.pl
@MODULES = (
'Referral'
);
Настройка реферальной системы
Меню Настройка>Реферальная система>Тарифный план
В данном меню можно добавить тарифный план, в котором можно установить параметры, которые относятся к бонусам, начисляемым пользователям.
| Параметр | Описание |
|---|---|
| Название | Имя, которое будет отображаться в списке |
| Количество бонусов | Сумма вознаграждения, которая будет начислена за реферала. Начисляется, если пользователь сделал регистрацию через URL, который предоставил пользователь или как статическое начисление |
| Максимальный бонус начисления | Максимальный бонус, который может получить пользователь за реферала |
| Задолженность в оплатах | Не начислять бонус, если задолженность больше, чем Х месяцев: 0 - не учитывать задолженность; 1 - не начислять бонус, если задолженность больше 1-го месяца; 2 - не начислять бонус, если задолженность больше 2-х месяцев и т.д. |
| Период начисления | Бонус будет начисляться на протяжении Х месяцев, введите нужное количество месяцев: 0 - бонус начисляется сразу после подключения реферала; 2 - бонус будет начисляться на протяжении 2-х месяцев НЕ ВЛИЯЕТ НА ТАРИФ "ПО УМОЛЧАНИЮ", для рефералов пришедших через ссылку, % от пополнения и трат будет начисляться все время! |
| Количество неактивных дней реферала | Задать количество дней, которое будет сравнивается с датой перевода пользователя (реферала) в любой другой статус кроме "Активно". Если количество неактивных дней пользователя больше чем указано в данном поле - бонус за этого пользователя не будет начислен
|
| % от пополнения | Сколько % будет начислено пользователю от суммы пополнений счета рефералом |
| Тип оплаты | Поле относится к "% от пополнения". Процент от пополнение реферала будет зависеть от разрешенного типа оплаты реферала |
| % от трат | Сколько % будет начислено пользователю от суммы всех трат реферала |
| Тип списания | Поле относится к "% от трат". Процент от трат (списания) реферала будет зависеть от разрешенного типа списания реферала |
| Денежный счёт | Выбор счёта, на который будут поступать средства: Основной, Дополнительный |
| По умолчанию | Тариф, который будет использован для рефералов пришедших через ссылку |
| Начисление, которое происходит раз в месяц, размер указанный в параметре количество бонусов, происходит начисление первого числа | |
| Мультиначисление | Начисления, которые будут добавлены основному пользователю:
|
Заявки на подключения
Меню Обслуживание>Заявки реферальные
Если пользователь подаст заявку на регистрацию друга то она будет тут.
| Иконка | Описание |
|---|---|
| Перенаправляет на регистрацию пользователя Заполняет телефон, ФИО |
| Изменить заявку или прочитать подробнее |
| Удалить заявку. Также удаляется реферальная связь |
В списке Статус можно выбрать фильтр для отображения (показывает все по стандарту) чтобы убрать фильтр можно нажать на крестик справа на списке
Пригласил - фильтр для отображения только заявок одного пользователя
Настройка заявок
| Параметр | Описание |
|---|---|
| Пользователь | Если в системе уже есть реферальный пользователь, можно выбрать его через данное поле и не создавать нового. После создания нового пользователя из заявки или привязки существующего пользователя поля ФИО, телефон и выбор адреса будет недоступен |
| Статус | Статус заявки. Отображается в кабинете пользователя. На смену данного поля нужно поставить права в Настройка>Администраторы>Права → 8.Обслуживание (Смена статуса) |
| Тарифный план | Тариф для зачисления бонусов. Можно изменить после выполнения, но старые бонусы не уберутся, так же при изменении бонусы не начисляться из-за того, что прошлый тариф был выплачен, а в новом период начисления больше или равен старому |
| Комментарий | текстовое поле, куда абонент вносит дополнительные данные |
| Внутренний комментарий | текстовое поле, куда администратор вносит информацию. Информация отображается только в админ портале |
Отчёт реферальной системы
Меню Отчёт>Реферальная система. В данном меню удобно просматривать всех возможных рефералов в системе. По умолчанию, показывает всех пользователей, у которых есть рефералы.
- ссылка на редактирования реферальной заявки
- удаление привязки реферала от реферера
Можно выбрать пользователя в верхней панели, для отображения дерева рефералов, начиная с этого пользователя.
В списке выбора отображаются только пользователи, у которых есть приглашенные рефералы.
Использование реферальной системы
Интерфейс Администратора
Переходим на страницу пользователя Клиенты>Логины>Информация
На панели сервисов появляется вкладка Реферальная система
Если у пользователя нет пригласившего и приглашённых пользователей, вкладка выглядит так:
По нажатию на кнопку Поиск можно выбрать пригласившего пользователя:
В открывшемся модальном окне поиска, вводим критерии поиска.
Нажимаем кнопку «Search».
Нажимаем на кнопку с логином пригласившего.
Ждём результат.
Обновляем страницу.
Если у пользователя есть приглашенные ним пользователи, появляется кнопка «Показать Список рефералов».
По нажатию на кнопку, в модальном окне отображается дерево рефералов:
Можно задать дополнительную проверку на добавления реферрера и реферрала. Если UID реферрера (тот, кто привел) больше чем UID реферрера (кого привели), то система не выполнит привязку и выдаст ошибку (потому что UID реферрера должен быть меньше). Настройка работает для ручного добавления (Клиенты>Логины>Информация>Сервисы>Реферальная система и Обслуживание>Заявки реферальные - Редактировать)
$conf{REFERRAL_MORE_REFERRER} = 1;
Интерфейс Пользователя (Личный кабинет)
Используя данный модуль пользователи имеют возможность зарегистрировать новых клиентов через меню в личном кабинете Приведи друга с целью получения вознаграждения. Пользователям будут начислены средства в виде бонуса в начале следующего месяца.
Приглашение через ссылку
Если в настройках тарифов, хоть один установлен по умолчанию - в кабинете пользователя будет ссылка, перейдя по которой пользователь сможет сам зарегистрироваться
Для корректного использования данного функционала, включите Регистрацию клиентов через веб интерфейс
После успешной регистрации пользователю сразу будет начислен Бонус, поле "Количество бонусов".
Пользователь может самостоятельно выводить средства, которые будут ему доступны.
Кнопка появиться, если бонус превышает число заданное в конфиге:
$conf{REFERRAL_MIN_WITHDRAW} = '10';
Также, бонусы будут автоматически начисляться после отработки periodic monthly.
Тест на начисления бонуса
/usr/abills/libexec/periodic monthly MODULES=Referral
Запрос на выплату:
После нажатия на кнопку Вывести в кабинете пользователя бонусы начисляются на бонусный счет, а также будет выслан XML c данными на почту, которая указана в $conf{ADMIN_MAIL}
Экспорт запросов:
Если нужно Экспортировать список запросов, можно использовать кнопку в верхнем правом углу.
