FastComments Email Templates bruger EJS skabelonsprog.

Eksempel på syntaks er <%= object.someValue %> for at udskrive variabler, og betingede udsagn kan laves således:

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

Udskrivning af rå HTML, som for kommentarindholdet, gøres således: <%- comment.commentHTML %>. Bemærk - i stedet for =.

Se linket ovenfor for yderligere dokumentation om syntaks.

FastComments er en lokaliseret platform. Alle vores widgets, e-mails og notifikationer er lokaliserede.

Lokaliseret betyder, at vi viser et andet sprog, og formatering, baseret på brugerens placering og foretrukne sprog. Vi fastsætter dette ud fra de oplysninger, brugerens browser giver os.

Vi kan tilpasse teksten i e-mailen ved at gå til fanen Translations, vælge en Locale og redigere teksten. Tekst, der er ændret fra standarden, er markeret i UI'et. Du kan skifte mellem locales og gemme til sidst, uden at miste ændringer.

Lokaliseret tekst tilgås via TEXT-objektet, for eksempel: <%= TEXT.INTRO %>.

SSO-bemærkning

For SSO-integrationer, hvis locale ikke er angivet, vil det blive opdateret hver gang brugeren får adgang til kommentar-widgeten med en anden locale. Det betyder, at deres sprogpræference automatisk opdateres, og fremtidige e-mails vil blive sendt i den locale.

Dette kan også sættes manuelt ved at angive locale i SSO-payloaden.

Skabeloner kan opsættes som globale - på tværs af hele din tenant for den pågældende skabelontype, eller pr. domæne. I fanen Settings vælg det ønskede domæne.

Bemærk, at hvis du opsætter flere skabeloner for det samme domæne, vælges kun den første ved køretid. Skabelonlisten advarer dig, når denne situation opstår.

Hver skabelon fungerer i en forskellig kontekst, hvilket betyder, at forskellige data er tilgængelige.

En hurtig måde at få et overblik over, hvilke data der er tilgængelige, er at tjekke testdataene der leveres til skabelonen. Når du redigerer en skabelon, skal du klikke på Test Data-fanen for at se en JSON-struktur.

Vi kan også tilpasse testdataene i dette område for at se, hvordan vores skabelon ser ud i forskellige situationer. Testdataene kan nulstilles til standardværdierne med Reset-knappen.

Da e-mail-skabeloner understøtter variabler og logik, er det muligt at oprette skabeloner som fejler ved gengivelse, eller nogle gange undlader at blive gengivet.

Det kan være meget frustrerende at diagnosticere og fejlfinde, især hvis det er et intermitterende problem, eller hvis det kun opstår, når dataene ser ud på en bestemt måde.

For at hjælpe har FastComments Email Templates et par funktioner:

1. Hvis skabelonen ikke kan forhåndsvises, kan den ikke gemmes. En fejlmeddelelse vises.
2. Gengivelsesfejl for skabeloner spores og rapporteres i admin-UI'en.

Den anden punkt beskriver gengivelsesfejl, der sker i produktion. Altså: du opretter en skabelon, som forhåndsvises fint - men som senere fejler af en eller anden grund. For eksempel, hvis vi har dette i vores skabelon:

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

Dette kan nogle gange fejle, hvis vi har anonym kommentering aktiveret, eftersom e-mail ikke altid vil være tilgængelig. Hvordan finder vi så ud af det?

Svaret er, at fejl synliggøres to steder. For det første viser selve skabelonlisten et antal gengivelsesfejl for hver skabelon.

Når man ser en skabelon kan vi se et antal, pr. fejl, af hvor mange gange skabelonen har fejlet ved gengivelse.

En nulstillingsknap er placeret ved siden af hver fejl og dens tæller, så vi kan nulstille tælleren efter at have løst et problem.

Oprettelse og redigering af e-mail-skabeloner sker med det samme. Dette betyder, i det øjeblik du trykker på Save-knappen, platformen begynder at bruge den nyeste version af den pågældende e-mail.