Справочник

Переменные и шаблонизатор

В тексты и поля блоков можно подставлять данные через фигурные скобки: {переменная}. Поддерживаются данные события, Списки, Ресурсы, а также модификаторы, условия и циклы.

Переменные события

Данные входящего сигнала:

Платформа

{platform} — платформа, на которой работает программа: vk — ВКонтакте, mx — MAX, tg — Telegram. Пригодится, когда текст или ссылка различаются по сети:

{if '{platform}'=='mx'}https://max.ru/…{else}https://vk.me/…{/if}

Со строкой в условии сравнивайте в кавычках (или через модификатор {platform|equal:mx}): без кавычек |calc слово не разбирает.

Данные Списков

{list.<id>.title} — название списка, {list.<id>.count} — число участников, {list.<id>.has} — состоит ли текущий пользователь в списке. (<id> — номер списка.)

Данные Ресурсов

{res.<id>.val} — значение ресурса у текущего пользователя, {res.<id>.users.<uid>.val} — значение ресурса у пользователя с ID <uid>, {res.<id>.title} — название ресурса. (<id> — номер ресурса.)

Пользователь

{user.<uid>.id} — внутренний ID, {user.<uid>.ext_id} — внешний ID пользователя в сети.

Модификаторы

Значение можно преобразовать цепочкой модификаторов через |, аргументы — через :. Например {text|str_upper} — в верхний регистр, {now|date:2} — дата в заданном формате. Арифметика и сравнения — через |calc: {«2+3»|calc} даст 5.

Условия и циклы

Блок {if <условие>}…{else}…{/if} выводит текст по условию: {if {res.1.val}>0}есть баллы{else}баллов нет{/if}. Блок {foreach <массив> as x}…{/foreach} перебирает элементы (внутри доступны {x.val}, {x.key}, {x.i}). Чтобы вывести фигурные скобки буквально, оберните текст в {literal}…{/literal}.

Где работают переменные

В тексте сообщения, в полях изменения ресурса, в значениях условия «Проверить ресурс», а также в параметрах блоков запроса к API.