Что такое «Шаблонизатор»
  • 13 Mar 2024
  • 2 минуты
  • Темная тема
    Светлая тема
  • формат pdf

Что такое «Шаблонизатор»

  • Темная тема
    Светлая тема
  • формат pdf

Вводный текст

Шаблонизатор - это специальная разметка и переменные для создания писем с динамическим контентом.

Другими словами: мы обращаемся к данным по клиенту через переменную и выводим для каждого клиента ту информацию, которая относится именно к нему.

Обращаться при этом мы можем к личным данным (имя, пол, дата рождения), действиям (регистрация через форму, просмотр товара), заказам, балансу и т.д.

Чтобы перейти к разделу, нажимаем Помощь → Параметры в шаблонах рассылок:

параметры — копия.png

Также к нему можно перейти из рассылки:

Снимок экрана 2021-10-12 в 14.38.56.png

Какие данные есть в разделе параметров

Название

Собирается из названий всей цепочки до нужного параметра.
Например, хотим вывести дополнительное поле "Любимый цвет".
Чтобы до него добраться сначала выбираем базовый параметр (Recipient), далее группу дополнительных полей (CustomField) и уже потом само доп. поле (смотря как назвали, например Color)

Нужный нам параметр состоит из перечисления этих параметров через точку:
Recipient.CustomField.Color

Снимок экрана 2023-08-08 в 23.08.07.png

О том, как выводить параметр в письме - в статье .

Тип

Типы данных можно разделить на две группы:

  • примитивы

    • строка
    • дата и время
    • число
      • целое число
    • логическое

  • композиты

    • коллекция

Вывести в письме можно только примитивы (логическое - в условии ).

Коллекция содержит элементы, каждый из которых содержит поля-примитивы. Сначала нужно обратиться к элементу коллекции с помощью цикла @for...@end for , потом вывести нужные данные по каждому элементу.

Клиент (Recipient), изменение баланса (CustomerBalanceChange), заказ (Order) - это наборы параметров. Они не являются коллекциями, но тоже относятся к композитам. Вывести их в письме просто так нельзя, нужно обратиться к строке/числу и т.д. "внутри" параметра.
Например, вывести клиента в письме (Recipient) нельзя. Не понятно, к каким данным мы обращаемся.
А вот имя (Recipient.FirstName - строка) или дату рождения (Recipient.BirthDate - дата и время) - можно.

Описание

Название выводимого поля.

Доступность

Некоторые параметры зависят от определённого события. Это не просто данные по клиенту, а данные про определённое действие, заказ, сессию - такие параметры могут использоваться только в автоматических рассылках с запуском по подходящему действию.

Например:

Снимок экрана 2021-10-12 в 14.39.36.png

Подробнее про такие события и тестирование рассылок с ними - в статье .

Какие операторы можно использовать

Применение операторов зависит от типа данных, с которыми они используются.

  • логические and и or

    со всеми примитивами

  • арифметические + - * /

    с любыми числами

  • конкатенация &

    со всеми примитивами

  • сравнение <>

    с любыми числами

  • = и != *
    Зависит от типа данных. Подробнее - в статье.

Узнать больше о работе шаблонизатора можно на курсе.

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

Урок по основам: что такое шаблонизатор; как собрать и вывести параметр.

Как ускорить верстку email-рассылок с помощью универсального шаблона