Форматирование переменных в вёрстке
Конструкции и фильтры для текста, числе и дат
Оглавление
Возможности шаблонизатора
Примеры использования:
- отображать имена и фамилии с большой буквы, даже если в значении переменной они написаны с маленькой;
- отображать название компании полностью заглавными буквами, даже если в значении название записано в разном регистре.
А с помощью математических операций с датами и числами в триггерах можно производить базовые вычисления и выводить корректное значение в вёрстке.
Фильтры для текстовых переменных
Подобные конструкции на вёрстке называются «фильтрами», потому что они накладывают стиль отображения (фильтр) на значение внутри переменной.
Задаётся с помощью следующей базовой конструкции:
{% filter %}{{text_variable}}{endfilter %}В примере выше {{text_variable}} — это любая переменная формата «текст». Это может быть {{name}}, {{company}} и другие.
В значение {% filter} задаётся нужное форматирование.
Upper — преобразование в верхний регистр
{% filter upper %}
Lower — преобразование в нижний регистр
{% filter lower %}
Title — заглавные первые буквы каждого слова
{% filter title %}
Urlencode — кодирование строки для использования в URL
{% filter urlencode %}Этот фильтр нужен для кейсов, когда надо в url подставить значение из переменной. Если не обернуть в конструкцию, то у подписчика ссылка может отображаться некорректно.
Таблица фильтров
Upper
Преобразует весь текст в верхний регистр
{% filter upper %}
Lower
Преобразует весь текст в нижний регистр
{% filter lower %}
Title
Преобразует первые буквы каждого слова в заглавные
{% filter title %}
Urlencode
Кодирует строку для использования в ссылке
{% filter urlencode %}
Продвинутая работа с персонализацией контента рассылок — использование операторов if и for.
Подробнее об условиях и циклах в вёрстке ›
Математические операции
В вёрстке триггеров доступно использование специальных конструкций для работы с числами и датами.
num — пример названия переменной типа «число»
Х — заданное число (целое или дробное)Сложение
add
Прибавляет заданное число к значению переменной
{{ num|add:"Х" }}
Вычитание
subtract
Вычитает заданное число из значения переменной
{{ num|subtract:"Х" }}
Умножение
multiply
Умножает значение переменной на заданное число
{{ num|multiply:"Х" }}
Деление
divide
Делит значение переменной на заданное число
{{ num|divide:"Х" }}
Округление до 2 знаков
round_number
Округляет значение переменной до 2 знаков после запятой
{{ 3.14159|round_number:"X" }}
Пример работы операции:
если num = 1500 то {{ num|add:"500" }} = 2000- В письме о начислении бонусов отображать новое количество на балансе (прибавить Х бонусов к текущему значению у клиента).
Например, есть письмо, в котором начисляется всегда ровно 100 бонусов. Тогда можно использовать фиксированную конструкцию:
{{ bon|add:"100" }}
bon — количество бонусов на счету
date — пример названия переменной типа «дата»
N — количество дней/месяцевПрибавить дни
add_days
Прибавляет указанное количество дней к дате в значении переменной
{{ date|add_days:"N"|date:"d-m-Y" }}
Вычесть дни
sub_days
Вычитает указанное количество дней из даты в значении переменной
{{ date|sub_days:"N"|date:"d.m.Y" }}
Прибавить месяц(ы)
add_months
Добавляет указанное количество месяцев к дате в значении переменной
{{ date|add_months:"N"|date:"d-m-Y" }}
Прибавить год и отформатировать
add_years
Добавляет год к дате в значении переменной и выводит только его
{{ date|add_years:"N"|date:"Y" }}
Форматирование даты напрямую
—
Задаёт нужный порядок отображения дня, месяца и года
{{ date|date:"Y.m.d" }}
Пример работы операции:
если date = 20.01.2025 то {{ date|add_days:"3"|date:"d-m-Y" }} = 23.01.2025- В письме с напоминанием об оплате указать рекомендуемую дату оплаты (например, за 3 дня до даты окончания срока действия тарифа).
- В письмо-благодарность после визита добавить предложение записаться на следующий (например, на стрижку через месяц).
Пример использования в триггерах с привязкой к дате вебинара:
Например, напоминания настроены на отправку за три дня, за два дня и в день мероприятия. Чтобы каждый раз не исправлять вёрстку этих писем, можно использовать конструкцию с вычитанием дней:
{{ date|sub_days:"N"|date:"d.m.Y" }}
date — дата вебинара
N — количество оставшихся дней до вебинараHTML-код
Также есть возможность через API-запрос передавать HTML-код в пользовательской переменной — и получать отрендеренную вёрстку с нужным форматированием.
Например, если вы используете товарные рекомендации и передаёте в запросе HTML-код товарного блока с картинкой, выделением текста жирным и т.д.
Фича включается по запросу. Обратитесь в поддержку, если вам нужно использовать HTML в переменных.
Помогает перевести клиентские запросы на язык, понятный команде разработки. Отслеживает баги и тестирует новые фичи. Собирает идеи по улучшению продукта — и следит, чтобы они доехали до прода.
Стать автором блога Mailganer ›
Технический специалист поддержки Mailganer
