FastComments Email predlošci koriste EJS jezik predložaka.

Primjer sintakse je <%= object.someValue %> za ispis varijabli, a uvjetne izjave mogu se napraviti ovako:

<% if (some_condition) { %>
    <div>Some content.</div>
<% } else { %>
    <div>Some other content.</div>
<% } %>

Ispisivanje sirovog HTML-a, kao za sadržaj komentara, radi se ovako: <%- comment.commentHTML %>. Primijetite - umjesto =.

Pogledajte gornju poveznicu za daljnju dokumentaciju o sintaksi.

FastComments je lokalizirana platforma. Svi naši widgeti, e-mailovi i obavijesti su lokalizirani.

Lokalizirano znači da prikazujemo različiti jezik i formatiranje, ovisno o lokaciji korisnika i njegovom preferiranom jeziku. To određujemo na temelju informacija koje nam pruža preglednik korisnika.

Tekst u e-mailu možemo prilagoditi odlaskom na karticu Translations, odabirom Locale i uređivanjem teksta. Tekst koji je promijenjen u odnosu na zadani je istaknut u korisničkom sučelju. Možete se prebacivati između lokala i spremiti na kraju, bez gubitka promjena.

Lokalizirani tekst se pristupa putem objekta TEXT, na primjer: <%= 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 s drugačijim lokalom. To znači da se njihova jezična preferencija automatski ažurira, i budući e-mailovi bit će poslani na taj lokal.

To se također može postaviti ručno pružajući locale u SSO payloadu.

Predlošci se mogu postaviti kao globalni - za cijeli vaš tenant za tu vrstu predloška, ili po domenu. U kartici Settings odaberite željeni domen.

Imajte na umu da ako postavite više predložaka za isti domen, samo će prvi biti odabran tijekom izvođenja (runtime). Popis predložaka će vas upozoriti kada se ta situacija dogodi.

Svaki predložak radi unutar drugačijeg konteksta, što znači da su dostupni različiti podaci.

Brzi pregled koji na prvi pogled pokazuje koji su podaci dostupni je provjeriti testne podatke priložene uz predložak. Kada uređujete predložak, kliknite karticu Test Data da vidite JSON strukturu.

Također možemo prilagoditi testne podatke u ovom području, da vidimo kako naš predložak izgleda u različitim situacijama. Testne podatke moguće je vratiti na zadane postavke pomoću gumba Reset.

Budući da e-mail predlošci podržavaju varijable i logiku, moguće je stvoriti predloške koji neće uspješno renderirati, ili ponekad ne uspiju renderirati.

To može biti vrlo frustrirajuće za dijagnosticirati i otkloniti pogreške, posebno ako je riječ o povremenom problemu, ili ako se pojavljuje samo kada podaci izgledaju na određeni način.

Da bi pomoglo, FastComments Email Templates ima nekoliko značajki:

1. Ako predložak ne uspije u pretpregledu, ne može se spremiti. Prikazat će se poruka o pogrešci.
2. Kvarovi pri renderiranju predložaka prate se i prikazuju u administratorskom sučelju.

Druga točka opisuje kvarove pri renderiranju koji se događaju u produkciji. Kao u slučaju da stvorite predložak koji se u pretpregledu prikazuje ispravno — ali kasnije iz nekog razloga ne uspije. Na primjer, ako u našem predlošku imamo ovo:

<% if (comment.commenterEmail.includes('test') { %>

Ovo ponekad može ne uspjeti ako imamo omogućeno anonimno komentiranje, budući da e-mail adresa neće uvijek biti dostupna. Pa kako to saznati?

Odgovor je da se pogreške prikazuju na dva mjesta. Prvo, sam popis predložaka pokazuje broj pogrešaka pri renderiranju uz svaki predložak.

Zatim, kada pregledavamo predložak, vidimo broj, po svakoj pogrešci, koliko puta je predložak zakazao pri renderiranju.

Gumb za resetiranje nalazi se pored svake pogreške i njenog broja, kako bismo mogli resetirati brojač nakon što smo riješili problem.

Stvaranje i uređivanje predložaka e-pošte događa se odmah. To znači, u trenutku kada pritisnete gumb Save, platforma će početi koristiti najnoviju verziju te e-pošte.