Теги и шорткоды

Используйте контекстные теги заявок и создавайте безопасные общие или объектные шорткоды

Что вы получите

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

Используйте каталог редактора

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

Встроенные теги

Формируются системой из контекста заявки, направления, города, курса, комиссии, реквизита или клиента. Например, [created_at] должен выводить дату создания текущей заявки.

Мои шорткоды

Создаются администраторами и появляются в каталоге только при включённом переключателе «Доступен в шаблонах».

Не набирайте встроенный ключ по памяти. Один и тот же редактор может иметь разный контекст на странице направления, оплаты, в письме и в Telegram.

Создайте общий шорткод

Откройте «Утилиты» — «Шорткоды» и вкладку «Общие».

1

Нажмите «Добавить общий шорткод»

Используйте понятное название, например «Телефон поддержки».

2

Укажите ключ

Используйте латинские буквы, цифры, точку, дефис или нижнее подчёркивание. Результат будет иметь вид [custom:key].

3

Выберите формат

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

4

Заполните значение и описание

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

5

Включите доступность

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

Когда нужен объектный шорткод

Во вкладке «Для объектов» ключ вида [entity:key] связывается с конкретной заявкой, пользователем или направлением.

Выберите:

• тип объекта;
• конкретный объект через поиск;
• «Заданный текст» или «Данные выбранного объекта»;
• поле объекта, если используется автоматическое значение;
• формат результата.

Объектный шорткод работает только там, где шаблон получает совместимый контекст. Для общего телефона поддержки используйте [custom:key], а не искусственную привязку к одной заявке.

Проверьте все каналы

Исправление тега в одном рендерере не доказывает остальные каналы. Для используемого текста создайте контрольную заявку и сравните каждое место доставки.

Перед удалением пользовательского шорткода найдите шаблоны, в которых он сохранён. Удаление определения не переписывает старые тексты автоматически.

Этап завершён, если

• встроенные теги выбираются из текущего каталога;
• [created_at] показывает дату создания заявки;
• общий и объектный шорткоды используются по назначению;
• в значениях нет секретов и лишних персональных данных;
• переключатель доступности проверен;
• сырой ключ или пустая подстановка не видны клиенту;
• страница, E-mail и Telegram проверены там, где они используются.

Далее создайте сообщения на клиентском сайте.