Да би пружио усклађеније искуство за вашу базу корисника, FastComments пружа решење за прилагођавање е-порука тако да е-поруке које FastComments шаље вашим корисницима, могу одговарати вашем бренду.
У овој документацији покрићемо функције овог решења, језик шаблона, локализацију,
и још.
Креирање шаблона 
Administratorsko područje za kreiranje predložaka možete pronaći odlaskom na Prilagodi -> Predlošci e-pošte.
Ovdje ćete vidjeti listu različitih tipova e-poruka koje platforma šalje, sa opisom za svaki predložak koji objašnjava kada se koristi.
Na primjer, možemo prilagoditi Commenter Comment Notification e-poruku, koja je Sent when a commenter has a reply to their comment.
Klikom na Create Template promjene se neće odmah primijeniti. Možete otvoriti uređivač
za zadani predložak i isprobati pregled, i neće biti nikakvog 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.
Неуспеси при рендеровању
Pošto email predlošci podržavaju varijable i logiku, moguće je napraviti predloške koji neće da se renderuju, ili povremeno neće da se renderuju.
Ovo može biti veoma frustrirajuće za dijagnostikovanje i otklanjanje grešaka, posebno ako je problem povremen, ili ako se javlja samo kada podaci izgledaju na određeni način.
Da bi pomogao, FastComments Email Templates ima nekoliko funkcija:
- Ako se predložak ne može pregledati, ne može se sačuvati. Prikaže se poruka o grešci.
- Greške pri renderovanju predložaka se prate i prijavljuju u administratorskom korisničkom interfejsu.
Druga tačka opisuje greške pri renderovanju koje se dešavaju u produkciji. Kao u: kreirate predložak koji se u pregledu prikazuje ispravno - ali kasnije iz nekog razloga ne uspe. Na primjer, ako u našem predlošku imamo ovo:
<% if (comment.commenterEmail.includes('test') { %>Ovo ponekad može da ne uspe ako imamo omogućeno anonimno komentarisanje, jer email adresa neće uvek biti dostupna. Kako to da saznamo?
Odgovor je da se greške prikazuju na dva mjesta. Prvo, sama lista predložaka prikazuje broj grešaka pri renderovanju uz svaki predložak.
Zatim, prilikom pregleda predloška možemo vidjeti broj, po grešci, koliko puta se predložak nije uspeo renderovati.
Dugme za resetovanje nalazi se pored svake greške i njenog brojača, kako bismo mogli da resetujemo brojilac nakon što otklonimo problem.
Примена промена
Креирање и уређивање шаблона е-поште је тренутно. То значи, чим притиснете дугме Save,
платформа ће почети да користи најновију верзију те е-поруке.