Шаблоны позволяют один раз сверстать общие части писем — стили CSS, шапку и подвал — и использовать их во всех письмах.
Без шаблонов общий код приходится поддерживать в каждом письме отдельно. С шаблонами счета, приветственные письма и письма для сброса пароля используют общие элементы, а в коде вашего приложения остаётся только содержание конкретного письма.
Добавление шаблона
Для быстрого старта в Haskimail есть готовые стартовые шаблоны. Можно создать и свой шаблон с нуля.
- Откройте нужный сервер и перейдите в раздел Шаблоны.
- Нажмите Добавить шаблон.
- Haskimail покажет стартовые шаблоны. Для примера выберем «Добро пожаловать!».
Редактирование шаблонов
Чтобы изменить шаблон, откройте его из списка на вкладке Шаблоны. Во встроенном редакторе можно поправить HTML, CSS и текстовую версию, а результат посмотреть на вкладке Предпросмотр. Подробнее о редакторе — в статье «Стартовый шаблон».
В стартовых шаблонах стили CSS собраны в блоке <style> в заголовке письма. Многие почтовые клиенты лучше понимают стили, встроенные прямо в теги, поэтому при отправке Haskimail автоматически переносит стили в разметку. Так шаблон удобно редактировать, а письмо корректно отображается у получателей.
Переменные в шаблоне
Чтобы подставить в письмо имя клиента, номер заказа или другие данные, добавьте в тему, HTML и текстовую версию шаблона переменные в двойных фигурных скобках, например {{name}} или {{order}}. При отправке передайте значения в поле TemplateModel. Ключ — это переменная вместе со скобками: {"{{name}}": "Иван", "{{order}}": "1042"}. Переменные {{SENDDATE}} и %SENDDATE% заменяются датой отправки автоматически.
Текстовая версия шаблона
Письмо по шаблону содержит две части: HTML и текстовую версию из шаблона. Текстовую версию показывают почтовые клиенты без поддержки HTML, умные часы и программы для чтения с экрана, а письмо с обеими частями лучше доставляется. Заполняйте её тем же содержанием, что и HTML, без вёрстки, и с теми же переменными. Если копируете текст из HTML, проверьте, что в нём не остались теги вроде <p> и </p> — получатели увидят их как есть. Убедиться, что текстовая версия дошла, можно в исходнике письма: там будут части text/plain и text/html.
Проверка шаблона
Перед отправкой шаблон можно проверить: API покажет, что получит получатель, и найдёт переменные без значения. Для этого используйте метод POST /templates/validate. Подробнее — в статье «Проверка шаблона перед отправкой».