Модуль для реализации бонусной реферальной программы.
Установка
Создать таблицы в базе.
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 daily. Если у реферала статус не Активно и если есть услуга Интернет, и статус не Активно - бонус не будет начислен
Тест на начисления бонуса
/usr/abills/libexec/periodic daily MODULES=Referral |
Запрос на выплату:
После нажатия на кнопку Вывести в кабинете пользователя бонусы начисляются на бонусный счет, а также будет выслан XML c данными на почту, которая указана в $conf{ADMIN_MAIL}
Экспорт запросов:
Если нужно Экспортировать список запросов, можно использовать кнопку в верхнем правом углу.
