Шаблоны писем
Любое письмо, которое отправляет Pano, — и письма самой платформы, и письма ваших плагинов — можно переписать из панели на каждом языке вашего сайта. Откройте Панель → Настройки → Шаблоны писем. Сама отправка (SMTP или Pano Mail) настраивается в разделе Сервисы → Электронная почта.
Нужно разрешение Управление шаблонами писем. Каждое сохранение и сброс записываются в журнал активности.
Что можно редактировать
Страница группирует письма по отправителю:
- Платформа: активация аккаунта, подтверждение смены почты, пароль изменён, сброс пароля, блокировка и оповещения о серверах.
- Плагины: каждый установленный и запущенный плагин, который отправляет письма, например ссылка для входа из Auth Guard, письмо о смене имени пользователя из Premium Login и письма магазина из Market. Пока плагин остановлен, его письма пропадают из списка.
У некоторых писем есть варианты: одно письмо с отдельным текстом для каждой ситуации. У оповещений о серверах по варианту на каждое оповещение (сервер упал, узел офлайн, ошибка бэкапа, мало места на диске, низкий TPS, ошибка задачи по расписанию, обновления плагинов); у Market — по варианту на каждое письмо о заказе, подписке и доставке. У писем без таких видов один вариант — По умолчанию.
За раз вы редактируете одну комбинацию письмо × вариант × язык. Языки, которые вы изменили, отмечены значком.
Редактор
Общий вид (логотип, белая карточка, кнопка, строка подвала) задаёт макет, поэтому шаблон — это только тексты:
| Поле | Что это |
|---|---|
| Тема | Строка темы (обязательно, не больше 255 символов) |
| Прехедер | Короткая строка, которую почтовые программы показывают рядом с темой; в самом письме скрыта |
| Текст | Само сообщение, как HTML в редакторе кода (показывается отформатированным, сохраняется сжатым) |
| Текст / URL кнопки | Главная кнопка; оставьте URL пустым, если кнопка не нужна |
| Подвал | Небольшая заметка под карточкой, например «Если вы этого не запрашивали, просто проигнорируйте письмо» |
Вставка переменных. В боковом списке — то, что знает выбранное письмо (имя пользователя, ссылки, суммы…). Нажмите на переменную, и она встанет на место курсора как {{username}}. Переменные работают в любом поле, включая тему и URL кнопки. Некоторые переменные — списки (например, позиции заказа в Market): они вставляются циклом {{#each items}}…{{/each}}, а в списке видны поля каждой строки. Несколько — готовые HTML-блоки (например, реквизиты перевода, указанные в способе оплаты); они вставляются как {{{instructions}}} (три фигурные скобки).
В каждом письме доступны: {{websiteName}}, {{websiteUrl}}, {{websiteLogo}}, {{year}}, {{locale}}.
Расширенный режим (HTML). Вкладка Расширенный показывает всё письмо одним HTML-документом: общий макет с уже подставленными полями. Если сохранить там, сохраняется этот полный HTML, и письмо больше не следует общему макету.
Handlebars. Все поля, текст письма, полный HTML и макет — это шаблоны Handlebars: {{name}} выводит переменную, {{{name}}} — готовый HTML-блок, {{#if name}}…{{else}}…{{/if}} показывает часть только при наличии значения, {{#each list}}…{{/each}} повторяет часть. Работают только встроенные хелперы (if, unless, each, with, lookup); собственные хелперы недоступны. Полный синтаксис — в руководстве Handlebars.
Предпросмотр показывает несохранённые изменения с примерами значений — вы видите письмо раньше получателей. Отправить тестовое письмо шлёт этот предпросмотр на ваш адрес; нужна работающая почта, и если отправка выключена или Pano Mail недоступен, вы об этом узнаете. Сохранить сначала проверяет шаблон и указывает на поле с ошибкой (пустая тема, слишком длинная тема или Handlebars, который не компилируется).
Сбросить к стандартному удаляет вашу версию для этого языка, и возвращается текст по умолчанию.
Макеты
Макет — это HTML, в который оборачивается письмо: шапка с логотипом, карточка, кнопка и подвал. Своего текста в нём нет, поэтому один макет подходит для всех языков; в нём обязательно должен остаться слот {{{content}}}, куда попадает текст письма. Кнопка показывается, только если у письма есть URL кнопки.
Карточка Макеты показывает каждый макет, откуда он и сколько писем его используют:
- Основной макет — макет Pano; его используют все письма, если не выбран другой.
- Макеты плагинов — их приносит плагин для своих писем.
- Свои макеты — созданные кнопкой Новый макет, пустыми или копией другого.
Любой макет можно изменить; Сбросить к стандартному возвращает поставляемую версию основного макета и макетов плагинов. Удалить можно только свои макеты; письма, которые их использовали, возвращаются к основному макету (подтверждение их перечисляет).
В редакторе письма поле Макет выбирает макет для всех языков и вариантов письма: макет по умолчанию, любой другой или Без макета — тогда текст отправляется как всё письмо, без шапки, карточки и подвала.
Какой язык отправляется
Письмо уходит на языке получателя (язык его аккаунта, иначе язык сайта). Для этого языка Pano берёт первый найденный текст:
- вашу отредактированную версию на этом языке,
- текст по умолчанию на этом языке,
- текст по умолчанию на базовом языке (
pt-BR→pt), - вашу отредактированную английскую (
en-US) версию, - английский текст по умолчанию.
Значит, язык, добавленный в Панель → Переводы, отправляет письма на английском, пока вы не напишете для него шаблоны здесь; в редакторе он открывается с английским текстом, и редактор сообщает, с какого языка взят вариант по умолчанию.
Обновления
Ваши правки хранятся в базе данных и переживают обновления Pano и плагинов. Если обновление приносит новый текст по умолчанию, вы увидите его только на языках, которые не меняли; чтобы взять новый текст на изменённом языке, нажмите Сбросить к стандартному.