> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/5.-klientskii-sait/06-tags-shortcodes.md).

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

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

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

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

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

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

{% tabs %}
{% tab title="Встроенные теги" %}
Формируются системой из контекста заявки, направления, города, курса, комиссии, реквизита или клиента. Например, `[created_at]` должен выводить дату создания текущей заявки.
{% endtab %}

{% tab title="Мои шорткоды" %}
Создаются администраторами и появляются в каталоге только при включённом переключателе **«Доступен в шаблонах»**.
{% endtab %}
{% endtabs %}

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

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

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

{% stepper %}
{% step %}

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

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

{% step %}

### Укажите ключ

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

{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

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

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

Выберите:

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

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

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

```mermaid
flowchart LR
    A["Шаблон с тегом"] --> B["Страница оплаты"]
    A --> C["Страница отслеживания"]
    A --> D["E-mail"]
    A --> E["Telegram"]
    B --> F["Одинаковый смысл и корректный формат"]
    C --> F
    D --> F
    E --> F
```

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

{% hint style="warning" %}
Перед удалением пользовательского шорткода найдите шаблоны, в которых он сохранён. Удаление определения не переписывает старые тексты автоматически.
{% endhint %}

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

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

Далее создайте [сообщения на клиентском сайте](https://docs.iexexchanger.com/learn/5.-klientskii-sait/07-customer-notifications.md).
