
Језик 🇷🇸 Српски
Шаблони е-порука
Да би пружио кохерентније искуство вашој бази корисника, FastComments нуди решење за прилагођавање е-порука, тако да е-поруке које FastComments шаље вашим купцима могу одговарати вашем бренду.
У овој документацији покрићемо функције овог решења, језик шаблона, локализацију и још много тога.
Креирање шаблона 
Administratorski deo za kreiranje šablona nalazi se na Prilagodi -> Šabloni e-pošte.
Ovde ćete videti listu različitih tipova imejlova koje platforma šalje, sa opisom za svaki šablon koji objašnjava kada se koristi.
Na primer, možemo prilagoditi imejl Commenter Comment Notification, koji je Sent when a commenter has a reply to their comment.
Klikom na Create Template promene se neće odmah primeniti. Možete otvoriti uređivač
za podrazumevani šablon i eksperimentisati sa pregledom, i neće biti efekta
dok ne pritisnete 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 има неколико функција:
- Ако шаблон не успе да се прегледа, он не може бити сачуван. Биће приказана порука о грешци.
- Неуспеси при рендеровању шаблона се прате и приказују у админ интерфејсу.
Друга тачка описује неуспехе при рендеровању који се дешавају у продукцији. Тако да, направите шаблон који се у прегледу правилно приказује - али касније из неког разлога не успева. На пример, ако у нашем шаблону имамо ово:
<% if (comment.commenterEmail.includes('test') { %>Ово понекад може пропасти ако је омогућено анонимно коментарисање, јер имејл неће увек бити доступан. Како да за то сазнамо?
Одговор је да се грешке приказују на два места. Прво, сама листа шаблона показује бројач грешака при рендеровању уз сваки шаблон.
Затим, када прегледамо шаблон можемо видети, за сваку грешку посебно, број пута колико шаблон није успео да се рендерује.
Дугме за ресетовање се налази поред сваке грешке, и њеног бројача, тако да можемо ресетовати бројач након што смо решили проблем.