Да би пружио усклађеније искуство вашој бази корисника, 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
и уредити текст. Текст који је промијењен у односу на подразумевани је означен у корисничком интерфејсу. Можете
прелазити између локала и на крају сачувати, без губитка промјена.
Локализовани текст се приступа преко објекта TEXT, на примјер: <%= TEXT.INTRO %>.
Напомена о SSO
За SSO интеграције, ако locale није наведено, оно ће бити ажурирано сваки пут када корисник
приступи видџету за коментаре са другом локалом. То значи да ће њихове језичке преференције
бити аутоматски ажуриране, и будући имејлови ће бити послати у тој локали.
Ово се такође може ручно поставити додавањем locale у SSO payload.
Шаблони по домену
Шаблони се могу подесити да буду глобални - за цео ваш налог за ту врсту шаблона, или
по домену. На картици Settings изаберите жељени домен.
Имајте на уму да ако подесите више шаблона за исти домен, само први се одабира при извршавању. Листа шаблона ће вас упозорити када се ова ситуација појави.
Подаци и променљиве
Сваки предложак ради у другом контексту, што значи да су доступни различити подаци.
Брз начин да на први поглед видите који подаци су доступни јесте да проверите тест податке
обезбеђене за предложак. Када уређујете предложак, кликните на картицу Test Data да видите
JSON структуру.
Такође можемо прилагодити тест податке у овом подручју, да видимо како наш предложак изгледа
у различитим ситуацијама. Тест подаци се могу вратити на подразумеване помоћу дугмета Reset.
Грешке при рендеровању
Пошто шаблони е-поште подржавају променљиве и логику, могуће је креирати шаблоне који не успијевају да се рендерују, или понекад не успијевају да се рендерују.
Ово може бити врло фрустрирајуће за дијагнозу и дебаговање, посебно ако је проблем привремен, или ако се појављује само када подаци изгледају на одређени начин.
Да помогне, FastComments Email Templates има неколико функција:
- Ако шаблон не успије да се прикаже у прегледу, не може бити сачуван. Порука о грешци ће бити приказана.
- Неуспјеси при рендеровању шаблона се прате и пријављују у admin UI.
Друга тачка описује неуспјехе рендера који се дешавају у продукцијском окружењу. У смислу, креирате шаблон који се у прегледу појављује исправно - али касније из неког разлога не успијева. На примјер, ако имамо ово у нашем шаблону:
<% if (comment.commenterEmail.includes('test') { %>Ово понекад може пропасти ако имамо омогућено анонимно коментарисање, јер е-пошта неће увијек бити доступна. Како то да сазнамо?
Одговор је да се грешке приказују на два мјеста. Прво, сама листа шаблона показује број грешака рендера уз сваки шаблон.
Затим, када прегледамо шаблон, можемо видјети број по грешци, односно колико пута се шаблон није могао рендеровати.
Дугме за ресетовање налази се поред сваке грешке и њеног бројача, тако да можемо ресетовати бројач након што смо ријешили проблем.
Примјена промјена
Креирање и уређивање шаблона е-поште је тренутно. То значи да, у тренутку када притиснете дугме Save,
платформа ће почети да користи најновију верзију те е-поруке.