Как вывести переменные на страницу
Страницы по умолчанию поддерживают все переменные.
Если необходимо вывести глобальную переменную, то просто добавьте её текстом в любой блок.
Например: {global:system_name.number}
Если вам необходимо вывести пользовательские переменные, то нам необходимо сперва идентифицировать пользователя, либо задать это значение внутри ссылки.
Давайте рассмотрим все варианты
Значение внутри ссылки
Самый простой вариант - задать значение внутри ссылки.
Например, выдаем ссылку:
https://kirill.uki.ai/prodazhnik?name=Кирилл
И на страницу выводим переменную: {var:request.query.name}, которая выведет текст "Кирилл".
Если мы выдаем ссылку ботом, то можем подставить переменную:
https://kirill.uki.ai/prodazhnik?name={user:first_name}
Однако в этом случае мы просто выводим текст из ссылки на страницу, но данных о пользователе у нас нет.
Поиск пользователя в макете
Второй вариант похож на первый, но подходит, когда нам нужно достать данные пользователя.
При этом мы не используем MiniApp и авторизацию.
Формируем ссылку с id пользователя
https://kirill.uki.ai/prodazhnik?id={user:platform.id}
Затем в макете открываем вкладку "Функции" и создаем действие "Перед открытием" - "Найти пользователя по контакту"
Выбираем типа контакта. Например, Telegram ID.
Вводим значение {var:request.query.id}
И ставим галочку "Заменить текущего пользователя"
Теперь все пользовательские переменные будут подтягиваться на страницу.
Например: {user:full_name} или {contact:phone}
Используем MiniApp
Если мы используем MiniApp, то пользователь по умолчанию будет авторизирован и все его данные будут подтягиваться автоматически.
Мы можем спокойно подставлять переменные пользователя. Например: {user:full_name} или {contact:phone}
Для этого достаточно внутри макета страницы на вкладке "Доступ" поставить галочку "Поддержка Telegram Mini App"
А саму ссылку на страницу необходимо разместить в кнопке с типом "Приложение"
Авторизация пользователя
Как и с MiniApp, после авторизации, мы будем знать все данные пользователя.
Однако, пользователь должен быть ранее зарегистрирован и авторизирован.
Регистрация и авторизация - отдельные блоки внутри страниц.
После авторизации, вы также сможете подставлять пользовательские переменные.
Если нужно ограничить возможность видеть страницу без авторизации, то можно внутри настроек макета поставить галочку "Авторизация обязательна".
Все переменные страницы
{var:object} — объект страницы. Содержит идентификатор, название, описание и некоторые другие данные - например, данные заполненной формы.{var:platform} — данные платформы. помогает определить, например, в каком MiniApp открыта страница. {var:request} — данные ссылки (query, form, json, domain, url, hash, data){var:users} — все данные пользователя
- или
{user:} — основные данные пользователя
{var:data} — значения дополнительных полей на вкладке Данные, если такие настроены в макете