Da bismo obezbedili koherentnije iskustvo za vašu korisničku bazu, FastComments pruža rešenje za prilagođavanje e-poruka tako da e-poruke koje FastComments šalje vašim korisnicima, mogu odgovarati vašem brendu.
U ovoj dokumentaciji pokrićemo funkcionalnosti ovog rešenja, jezik šablona, lokalizaciju, i još mnogo toga.
Kreiranje šablona 
Administratorski deo za kreiranje šablona može se naći tako što ćete otići na Prilagodi -> Šabloni e-pošte.
Ovde ćete videti listu različitih vrsta e-poruka koje platforma šalje, sa opisom za svaki šablon koji objašnjava kada se koristi.
Na primer, možemo prilagoditi Commenter Comment Notification email, 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 editor
za podrazumevani šablon i isprobati prikaz, i neće biti nikakvog efekta
dok ne kliknete Save.
Jezik šablona
FastComments Email Templates koristi EJS jezik za šablone.
Primer sintakse je <%= object.someValue %> za ispis promenljivih, a uslovne izjave se mogu napisati ovako:
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>Ispis sirovog HTML-a, na primer za sadržaj komentara, radi se ovako: <%- comment.commentHTML %>. Obratite pažnju na - umesto =.
Pogledajte gore navedeni link za dodatnu dokumentaciju o sintaksi.
Lokalizacija i prilagođeni tekst
FastComments je lokalizovana platforma. Svi naši widgeti, imejlovi i obaveštenja su lokalizovani.
Lokalizovano znači da prikazujemo drugačiji jezik i formatiranje, zasnovano na lokaciji korisnika i preferiranom jeziku. Ovo određujemo na osnovu informacija koje nam pruža korisnikov pregledač.
Možemo prilagoditi tekst u imejlu tako što ćemo otići na karticu Translations, odabrati Locale i izmeniti tekst. Tekst koji je promenjen u odnosu na podrazumevani je označen u UI. Možete se prebacivati između locale-a i sačuvati na kraju, bez gubitka izmena.
Lokalizovani tekst se pristupa preko TEXT objekta, na primer: <%= TEXT.INTRO %>.
Napomena o SSO
Za SSO integracije, ako locale nije naveden, on će se ažurirati svaki put kada korisnik pristupi widgetu za komentare sa drugim locale-om. To znači da se njihovo jezičko podešavanje automatski ažurira i budući imejlovi će biti poslati na tom locale-u.
Ovo se takođe može ručno podesiti pružanjem locale u SSO payload-u.
Šabloni po domenu
Šabloni mogu biti podešeni da budu globalni - za ceo vaš tenant za taj tip šablona, ili po domenu. U kartici Settings izaberite željeni domen.
Imajte na umu da, ako podesite više šablona za isti domen, samo će prvi biti izabran pri izvršavanju. Lista šablona će vas upozoriti kada se ova situacija dogodi.
Podaci i promenljive
Svaki šablon radi u drugačijem kontekstu, što znači da su dostupni različiti podaci.
Brz način da na prvi pogled vidite koji su podaci dostupni je da proverite test podatke
obezbeđene za šablon. Kada uređujete šablon, kliknite na karticu Test Data da biste videli
JSON strukturu.
Takođe možemo prilagoditi test podatke u ovom delu, da vidimo kako naš šablon izgleda
u različitim situacijama. Test podatke je moguće vratiti na podrazumevane vrednosti pomoću dugmeta Reset.
Greške pri renderovanju
Pošto email šabloni podržavaju promenljive i logiku, moguće je napraviti šablone koji ne uspeju da se renderuju, ili ponekad ne uspeju da se renderuju.
Ovo može biti veoma frustrirajuće za dijagnostikovanje i otklanjanje grešaka, naročito ako je u pitanju povremeni problem, ili ako se javlja samo kada podaci izgledaju na određeni način.
Da bi pomogao, FastComments Email Templates ima nekoliko funkcija:
- Ako šablon ne uspe da se prikaže u pregledu, ne može se sačuvati. Prikazaće se poruka o grešci.
- Greške pri renderovanju šablona se prate i izveštavaju u administratorskom interfejsu.
Druga tačka opisuje greške pri renderovanju koje se događaju u produkciji. Kao, kreirate šablon koji se u pregledu prikazuje ispravno - ali kasnije iz nekog razloga zakaže. Na primer, ako imamo ovo u našem šablonu:
<% if (comment.commenterEmail.includes('test') { %>Ovo može ponekad da zakaže ako imamo omogućeno anonimno komentarisanje, pošto email neće uvek biti dostupan. Pa kako to saznamo?
Odgovor je da se greške prikazuju na dva mesta. Prvo, sama lista šablona prikazuje broj grešaka pri renderovanju uz svaki šablon.
Zatim, kada pregledamo šablon možemo videti broj, po grešci, koliko puta je šablon nije uspeo da se renderuje.
Dugme za reset se nalazi pored svake greške i njenog broja, tako da možemo resetovati brojač nakon što smo rešili problem.
Primena izmena
Kreiranje i uređivanje email šablona se primenjuje odmah. To znači da u trenutku kada pritisnete dugme Save, platforma će početi da koristi najnoviju verziju tog emaila.