- 13 Mar 2024
- 2 минуты
- Темная темаСветлая тема
- формат pdf
Что такое «Шаблонизатор»
- Обновлено 13 Mar 2024
- 2 минуты
- Темная темаСветлая тема
- формат pdf
Шаблонизатор - это специальная разметка и переменные для создания писем с динамическим контентом.
Другими словами: мы обращаемся к данным по клиенту через переменную и выводим для каждого клиента ту информацию, которая относится именно к нему.
Обращаться при этом мы можем к личным данным (имя, пол, дата рождения), действиям (регистрация через форму, просмотр товара), заказам, балансу и т.д.
Чтобы перейти к разделу, нажимаем Помощь → Параметры в шаблонах рассылок:
Также к нему можно перейти из рассылки:
Какие данные есть в разделе параметров
Название
Собирается из названий всей цепочки до нужного параметра.
Например, хотим вывести дополнительное поле "Любимый цвет".
Чтобы до него добраться сначала выбираем базовый параметр (Recipient), далее группу дополнительных полей (CustomField) и уже потом само доп. поле (смотря как назвали, например Color)
Нужный нам параметр состоит из перечисления этих параметров через точку:
Recipient.CustomField.Color
О том, как выводить параметр в письме - в статье .
Тип
Типы данных можно разделить на две группы:
примитивы
- строка
- дата и время
- число
- целое число
- логическое
композиты
- коллекция
Вывести в письме можно только примитивы (логическое - в условии ).
Коллекция содержит элементы, каждый из которых содержит поля-примитивы. Сначала нужно обратиться к элементу коллекции с помощью цикла @for...@end for , потом вывести нужные данные по каждому элементу.
Клиент (Recipient), изменение баланса (CustomerBalanceChange), заказ (Order) - это наборы параметров. Они не являются коллекциями, но тоже относятся к композитам. Вывести их в письме просто так нельзя, нужно обратиться к строке/числу и т.д. "внутри" параметра.
Например, вывести клиента в письме (Recipient) нельзя. Не понятно, к каким данным мы обращаемся.
А вот имя (Recipient.FirstName - строка) или дату рождения (Recipient.BirthDate - дата и время) - можно.
Описание
Название выводимого поля.
Доступность
Некоторые параметры зависят от определённого события. Это не просто данные по клиенту, а данные про определённое действие, заказ, сессию - такие параметры могут использоваться только в автоматических рассылках с запуском по подходящему действию.
Например:
Подробнее про такие события и тестирование рассылок с ними - в статье .
Какие операторы можно использовать
Применение операторов зависит от типа данных, с которыми они используются.
логические and и or
со всеми примитивами
арифметические + - * /
с любыми числами
конкатенация &
со всеми примитивами
сравнение <>
с любыми числами
= и != *
Зависит от типа данных. Подробнее - в статье.
В видеоуроках разбираются основы языка шаблонизатора и параметры для механик, а также даются практические задания для закрепления материала.
Урок по основам: что такое шаблонизатор; как собрать и вывести параметр.