Модуль "Бонусный счет"
Возможности
Модуль добавляет в биллинг 2 фичи (могут быть задействованы как обе, так и только одна):
- Услуга, которая при завершении пополняет основной и/или бонусный счет
- При пополнении основного счета, с бонусного, если на нем достаточно финансов, на основной счет будет переведена сумма, эквивалентная пополнению.
Бонусная услуга
Может быть применена в акциях «Пополни счет на 100$ и через 3 месяца будет зачислено 110$» или «Пополни счет на 100$ и через 3 месяца будет зачислено 100$, а на бонусный счет 10$».
Пример:
- Абонент пополняет счет на 100$
- Баланс увеличивается на 100$
- Подключает услугу «Депозит» с описанием «Пополни счет на 100$ и через 3 месяца будет зачислено 110$»
- Со счета списывается 100$
- Через 3 месяца завершается услуга и основной счет пополняется на 110$
Естественно, все параметры (деньги, время, комментарий) настраиваемы:
При настройке услуги поставьте галку «Запретить клиентам продлевать эту услугу» чтобы при переустановке услуги она не замораживалась когда включена такая фича.
Обратите внимание, после подключения услуги, деньги как бы резервируются и абонент не сможет ими распоряжаться.
Бонусный счет
Создайте дополнительное поле:
Имя поля : Бонусный баланс Имя поля в бд : _bonus_balance Тип поля : деньги
Автоматический перевод финансов с бонусного на основной счет при пополнении
Создайте услугу типа «Бонус при завершении»:
Имя услуги: С бонусного на основной (можно иное название) Стоимость: неважно (использоваться не будет) Описание, которое будут видеть клиенты: неважно (использоваться не будет) Автопродление: не ставим галку Запрет продления: ставим галку Группы: не ставим ни одной галки! Пополнение основного счета: неважно (вычисляется динамически) Комментарий к пополнению (основного счета): «перевод бонусов на основной счет» Пополнение бонусного счета: неважно (использоваться не будет) Комментарий к пополнению (бонусного счета): неважно (использоваться не будет) Режим: неважно (использоваться не будет) Срок действия: неважно (устанавливается mysql процедурой)
В mysql:
DROP TRIGGER IF EXISTS `tr_bb_pays_insert`;
DELIMITER $$
CREATE TRIGGER tr_bb_pays_insert AFTER INSERT ON pays
FOR EACH ROW
IF NEW.mid > 0 AND NEW.cash > 0 AND NEW.category NOT IN (2, 3) THEN
BEGIN
DECLARE money FLOAT;
SELECT IF(_bonus_balance >= NEW.cash, NEW.cash, _bonus_balance) INTO money
FROM data0 WHERE uid = NEW.mid LIMIT 1;
IF money > 0 THEN
BEGIN
UPDATE data0 SET _bonus_balance = _bonus_balance - money WHERE uid = NEW.mid LIMIT 1;
INSERT INTO users_services SET uid=NEW.mid, service_id=98, next_service_id=0,
pay_id=0, tm_start=UNIX_TIMESTAMP(), tm_end=UNIX_TIMESTAMP()+2,
tags=CONCAT(',main_money=', money, ',');
END;
END IF;
END;
END IF;
$$
DELIMITER ;
DROP TRIGGER IF EXISTS `tr_bb_pays_update`;
DELIMITER $$
CREATE TRIGGER tr_bb_pays_update AFTER UPDATE ON pays
FOR EACH ROW
IF NEW.mid > 0 AND NEW.cash > 0 AND NEW.category NOT IN (2, 3) AND OLD.category IN (444, 445) THEN
BEGIN
DECLARE money FLOAT;
SELECT IF(_bonus_balance >= NEW.cash, NEW.cash, _bonus_balance) INTO money
FROM data0 WHERE uid = NEW.mid LIMIT 1;
IF money > 0 THEN
BEGIN
UPDATE data0 SET _bonus_balance = _bonus_balance - money WHERE uid = NEW.mid LIMIT 1;
INSERT INTO users_services SET uid=NEW.mid, service_id=98, next_service_id=0,
pay_id=0, tm_start=UNIX_TIMESTAMP(), tm_end=UNIX_TIMESTAMP()+2,
tags=CONCAT(',main_money=', money, ',');
END;
END IF;
END;
END IF;
$$
DELIMITER ;
В этом sql нужно в service_id=98 число 98 заменить на id услуги, что мы создали выше.
Тестирование
- В настройках абонента устанавливаем поле «Бонусный баланс», например, в 10$
- Пополняем счет любым небонусным платежом на 2$
- Основной баланс увеличится на 2$
- Бонусный счет уменьшится на 2$
- Через несколько секунд основной баланс увеличится еще на 2$
- Появится бонусный платеж на 2$ с комментарием про перевод денег с бонусного на основной счет
Проверка, что с бонусного не спишется больше чем на нем есть:
- Создаем платеж на 10$
- Баланс увеличится на 10 + 8, а на бонусном счете станет 0$
- Дальнейшие любые пополнения не будут менять бонусный счет и пополнять основной баланс бонусами т.к на бонусном счете будет 0
Обратите внимание, что ядро должно быть запущено с модулем услуг services, хотя скорее всего он запущен ибо это один из основных модулей в NoDeny.
Принцип работы
В mysql создается триггер, который реагирует на создание записей в таблице платежей (pays). Это означает, что неважно как пополняется счет, хоть через платежную систему, хоть карточкой пополнения - триггер это «увидит», подключит услугу перевода баланса (с длительностью 2 секунды), а также уменьшит бонусный счет.
Обратите внимание, что бонусный счет уменьшается в триггере. А основной пополняется именно при завершении услуги.
Вывод бонусного счета в личном кабинете
Бонусный счет - это дополнительное поле с именем _bonus_balance. Чтобы вывести его значение в личном кабинете, нужно найти соответствующий шаблон и в нужное место вставить вывод значения поля _bonus_balance. Чтобы вы понимали, что будете делать, рекомендуется прочитать:
После прочтения документации по переменным, становится ясно, что баланс можно вывести таким образом:
{{ user_info.dopdata._bonus_balance.show() }}
Из документации по изменению дизайна личного кабинета становится ясно, что не нужно менять файлы с шаблонами, а следует скопировать нужный шаблон в раздел «Документы» и уже там сделать изменения. Если мы хотим, чтобы баланс отображался на всех страницах личного кабинета, нужно править общий шаблон:
cat /usr/local/nodeny/web/tmpl/user/base.html
Скопируйте весь текст из этого файла. В разделе «Документы» создайте папку с именем «Кабинет клиента». Справа в поле «теги» обязательно введите system. В папке «Кабинет клиента» создайте документ с именем «Base» и установите ему теги:
system template=base role=user
Вставьте содержимое файла /usr/local/nodeny/web/tmpl/user/base.html. При этом в тексте после
<div id='main_block_header'>
вставьте следующее:
Бонусный баланс: <span>{{ user_info.dopdata._bonus_balance.show() }} {{cfg::gr}}</span>