Щоб забезпечити більш узгоджений досвід для вашої аудиторії користувачів, FastComments надає рішення для налаштування електронної пошти, щоб листи, які надсилаються вашим клієнтам від FastComments, відповідали вашому бренду.
У цій документації ми розглянемо можливості цього рішення, мову шаблонів, локалізацію, та інше.
Створення шаблонів 
Розділ адміністратора для створення шаблонів можна знайти, перейшовши в Налаштування -> Шаблони електронної пошти.
Тут ви побачите список різних типів електронних листів, які надсилає платформа, з описом для кожного шаблону, що пояснює, коли він використовується.
Наприклад, ми можемо налаштувати електронний лист Commenter Comment Notification, який Sent when a commenter has a reply to their comment.
Натискання Create Template не застосує зміни негайно. Ви можете відкрити редактор для шаблону за замовчуванням і попрацювати з попереднім переглядом, і ніяких змін не буде, поки ви не натиснете Save.
Мова шаблонів
Шаблони електронної пошти FastComments використовують мову шаблонів EJS.
Приклад синтаксису: <%= object.someValue %> для виведення змінних, а умовні вирази можна записати так:
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>Виведення сирого HTML, наприклад вмісту коментаря, робиться так: <%- comment.commentHTML %>. Зверніть увагу на - замість =.
Детальніше про синтаксис див. у наведеному вище посиланні.
Локалізація та власний текст
FastComments — це локалізована платформа. Усі наші віджети, електронні листи та сповіщення локалізовано.
Локалізованість означає, що ми показуємо іншу мову й форматування залежно від місцезнаходження користувача та його переважної мови. Ми визначаємо це на основі інформації, яку надає нам браузер користувача.
Ми можемо налаштувати текст у листі, перейшовши на вкладку Translations, обравши Locale
та відредагувавши текст. Текст, змінений відносно значення за замовчуванням, підсвічується в інтерфейсі. Ви можете
перемикатися між локалями й зберегти наприкінці, не втрачаючи змін.
Локалізований текст доступний через об'єкт TEXT, наприклад: <%= TEXT.INTRO %>.
Примітка щодо SSO
Для інтеграцій SSO, якщо locale не вказано, він буде оновлюватися щоразу, коли користувач
заходить у віджет коментарів з іншою локаллю. Це означає, що його мовні налаштування
автоматично оновлюються, і майбутні електронні листи будуть надсилатися тією локаллю.
Це також можна встановити вручну, передавши locale у SSO payload.
Шаблони на рівні домену
Шаблони можна налаштувати глобально — для всього вашого орендаря для цього типу шаблонів, або для окремих доменів. На вкладці Settings виберіть потрібний домен.
Зверніть увагу, якщо ви налаштуєте кілька шаблонів для одного й того ж домену, під час виконання буде обрано лише перший. Список шаблонів попередить вас, коли виникне така ситуація.
Дані та змінні
Кожен шаблон працює в іншому контексті, тобто доступні різні дані.
Швидкий спосіб з одного погляду дізнатися, які дані доступні — це перевірити тестові дані
надані для шаблону. Під час редагування шаблону натисніть вкладку Test Data, щоб побачити
структуру JSON.
Ми також можемо налаштувати тестові дані в цій області, щоб побачити, як наш шаблон виглядає
в різних ситуаціях. Тестові дані можна скинути до значень за замовчуванням за допомогою кнопки Reset.
Помилки рендерингу
Оскільки шаблони електронної пошти підтримують змінні та логіку, можливо створити шаблони які не вдається відрендерити, або іноді не відображаються.
Це може бути дуже фруструючим для діагностики та налагодження, особливо якщо проблема періодична, або якщо вона виникає лише за певних даних.
Щоб допомогти, FastComments Email Templates має кілька функцій:
- Якщо шаблон не вдається попередньо переглянути, його не можна зберегти. Буде показано повідомлення про помилку.
- Збої рендерингу шаблону відстежуються та відображаються в інтерфейсі адміністратора.
Другий пункт описує збої рендерингу, що трапляються в продакшені. Тобто ви створюєте шаблон, який у попередньому перегляді відображається нормально - але пізніше з якихось причин дає збій. Наприклад, якщо в нашому шаблоні є таке:
<% if (comment.commenterEmail.includes('test') { %>Це може інколи зламатися, якщо в нас увімкнено анонімні коментарі, оскільки email не завжди буде доступний. Тож як ми про це дізнаємося?
Відповідь: помилки відображаються в двох місцях. По-перше, сам список шаблонів показує для кожного шаблону кількість помилок рендерингу.
Потім, при перегляді конкретного шаблону ми бачимо для кожної помилки окремий лічильник, який показує, скільки разів шаблон не вдалося відрендерити.
Кнопка скидання розташована поруч з кожною помилкою та її лічильником, щоб ми могли скинути лічильник після вирішення проблеми.
Застосування змін
Створення та редагування шаблонів електронної пошти відбувається миттєво. Це означає, що щойно ви натиснете кнопку Save,
платформа почне використовувати останню версію цього листа.