Общая сумма Бонусов или Выводов средств

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

Способ применим как для специализированных кнопок типа: Бонус, Вывод Средств, кнопки Обмена 1 и 2, так и для созданных вами при помощи Action-ов собственных функций.

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

❖ Приобретение функционала

Весь функционал приобретается В ВАШЕМ БОТЕ, для этого перейдите в свой бот:
☞ 🔐Админ | 🧩Расширения

ВАЖНО: Приобретение функционала для бота доступно только Создателю (владельцу) бота. Админы покупать функционал - НЕ МОГУТ!

Вам понадобится:

1. Переменная - 1 штука
☞ 🔐Админ | 🧩Расширения | 📂Переменные

2. Action-ы - 1 штука
☞ 🔐Админ | 🧩Расширения | 📂Action-ы

3. Плагин - Макросы и Выражения для Кнопок
☞ 🔐Админ | 🧩Расширения | 📂Кнопки

4. Плагин - Бонус в Глобальной Переменной
☞ 🔐Админ | 🧩Расширения | 📂Кнопки

❖ Создание общей суммы Бонусов или Выводов

Как это работает

В каждой кнопке которая изменяет значение в Цифровых Переменных доступен специальный макрос %varname_v% - содержащий значение НА которое была изменена та или иная переменная. Макрос содержит имя переменные и постфикс _v который говорит Системе о том что нужно отобразить именно значение НА которое переменная была изменена.

Подробнее о макросе _v смотрите в руководстве по Action-ам.

Суть способа состоит в том чтобы при помощи указанного выше Action-а, дублировать в отдельную Глобальную Переменную все изменения в нужных вам переменных для каждой транзакции инициированной юзерами.

1. Создаём переменную

Глобальная:
• total_bonus (можете задать своё имя для переменной)

ВАЖНО: Сразу после создания глобальной переменной - задайте её значение "0" (ноль) нажав кнопку «Задать Значение» - так Система будет знать что эта глобальная переменная будет использоваться как цифровая. Если не задать ей инициирующее значение - ваша новая функция может выдавать ошибку.

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

2. Добавляем Action

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

Как вы знаете из руководства по Action-ам существует два типа экшенов по времени исполнения «Pre-Action-ы» и «Post-Action-ы». Какой из них использовать в вашем конкретном случае зависит от того, в какой момент происходит изменение в пользовательской переменной. Для большинства специализированных кнопок, таких как кнопки Бонусов, Выводов и Обменов - вам необходимо использовать «Post-Action-ы», потому как изменения переменных в этих кнопках происходят обычно ПОСЛЕ ввода юзером необходимых данных.

Если же вы создаёте свои собственные функции при помощи Action-ов, то в них изменения могут происходить и сразу после нажатия кнопки - в этом случае вы можете использовать «Pre-Action-ы» - главное чтобы они были расположены ниже в цепочке исполняемых экшенов - ПОСЛЕ того как все необходимые изменения были внесены.

О том как добавлять Action-ы смотри в руководстве по Action-ам.

В "Редакторе Кнопок" нажимаем инлайн кнопку настроек [ * ]. Нажимаем "Назначить Pre-Action" или "Назначить Post-Action":
● Выбираем "Action Чисел"
Переменная для изменения: "total_bonus" (созданная нами глобальная переменная)
Тип операции: Изменить Значение
Значение: %varname_v% (где varname - имя изменённой переменной)
Условие: нет

Например: Если имя переменной в которую начисляется бонус было «balance», то макрос будет выглядеть как «%balance_v%».

ИНДИВИДУАЛЬНАЯ СУММА: описанный выше способ позволяет вам вести ОБЩУЮ статистику бота для всех юзеров. Однако, используя представленную механику вы можете добавить и персональную статистику для каждого пользователя - дублируя его индивидуальные бонусы в отдельную - индивидуальную переменную. Для этого вместо Глобальной переменной создайте индивидуальную Цифровую переменную и используйте её для дублирующих начислений.

Оба способа можно комбинировать начисляя Action-ами как в Глобальную так и в индивидуальную Цифровую переменную.

❖ Создание отдельной статистики для Реферальных начислений

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

Осуществляйте реферальные начисления при помощи «Action-а Рефералов» и затем дублируйте начисленную сумму в отдельную переменную.