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