Обработчики тегов

Общие и объектные шорткоды для подстановки данных в тексты и шаблоны

Раздел создаёт шорткоды, которые подставляют подготовленное значение в поддерживаемые тексты и шаблоны. В самом экране раздел называется «Шорткоды».

В панели управления откройте:

«Утилиты» — «Шорткоды»

Доступ открывает любое из прав «Общие настройки» из блока «Админпанель», «Основные настройки сайта» из блока «Настройки» или «Настройки уведомлений» из блока «Настройки».

Права выдаются по пути «Пользователи» — «Список групп пользователей». Откройте нужную группу. Достаточно одного точного права из перечисленных; не выдавайте «Общие настройки» из блока «Админпанель» сотруднику, которому нужен только каталог шорткодов и настройки уведомлений.

Общие шорткоды

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

Заполните:

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

Ключ допускает латинские буквы, цифры, точку, дефис и нижнее подчёркивание. Итоговая конструкция показана внизу формы в формате [custom:ключ].

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

Шорткоды для объектов

На вкладке «Для объектов» нажмите «Добавить для объекта». Такой шорткод действует только для выбранной заявки, пользователя или направления обмена.

Дополнительно выберите:

• тип объекта;
• конкретный объект;
• что подставлять: заданный текст или данные выбранного объекта;
• поле объекта, если выбрана подстановка данных.

Итоговый формат — [entity:ключ]. При смене типа объекта выбранный объект и поле сбрасываются, поэтому заполните их заново.

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

Изменение и удаление

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

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

Проверка

1. Создайте шорткод с безопасным тестовым значением.
2. Скопируйте показанную конструкцию.
3. Вставьте её в поддерживаемый тестовый шаблон.
4. Сохраните и вызовите реальный предпросмотр или тестовую отправку.
5. Проверьте каждый язык и, для объектного шорткода, правильный объект.
6. Выключите шорткод и убедитесь, что редактор больше не предлагает его для нового использования.

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