
Jezik 🇸🇮 Slovenščina
E-poštne predloge
Da bi zagotovili bolj usklajeno izkušnjo za vaše uporabnike, FastComments ponuja rešitev za prilagajanje e-pošte, tako da e-poštna sporočila, poslana vašim strankam s strani FastComments, ujemajo z vašo blagovno znamko.
V tej dokumentaciji bomo obravnavali funkcionalnosti te rešitve, jezik predloge, lokalizacijo, in še več.
Ustvarjanje predlog 
Administratorsko območje za ustvarjanje predlog najdete tako, da pojdite na Prilagodi -> Predloge e-pošte.
Tukaj boste videli seznam različnih vrst e-poštnih sporočil, ki jih pošilja platforma, z opisom za vsako predlogo, ki pojasnjuje, kdaj se uporablja.
Na primer, lahko prilagodimo e-poštno sporočilo Commenter Comment Notification, ki je Sent when a commenter has a reply to their comment.
Klik na Create Template sprememb ne bo takoj uporabil. Lahko odprete urejevalnik
za privzeto predlogo in se poigrate s predogledom, pri čemer spremembe ne bodo imele učinka
dokler ne pritisnete Save.
Jezik predloge 
FastComments Email Templates uporablja jezik predlog EJS.
Primer sintakse je <%= object.someValue %> za izpis spremenljivk, pogojne izjave pa lahko naredite tako:
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>Izpis surovega HTML, na primer za vsebino komentarja, se naredi takole: <%- comment.commentHTML %>. Upoštevajte - namesto =.
Za nadaljnjo dokumentacijo o sintaksi glejte zgornjo povezavo.
Lokalizacija in prilagojeno besedilo 
FastComments je lokalizirana platforma. Vsi naši widgeti, e-pošte in obvestila so lokalizirani.
Lokalizirano pomeni, da prikažemo drugačen jezik in oblikovanje glede na lokacijo uporabnika in njegov želeni jezik. To določimo na podlagi informacij, ki nam jih posreduje uporabnikov brskalnik.
Besedilo v e-pošti lahko prilagodimo tako, da gremo na zavihek Translations, izberemo Locale
in uredimo besedilo. Besedilo, spremenjeno glede na privzeto, je v uporabniškem vmesniku označeno. Lahko
preklapljate med lokalami in na koncu shranite, brez izgube sprememb.
Do lokaliziranega besedila dostopamo preko objekta TEXT, na primer: <%= TEXT.INTRO %>.
Opomba za SSO
Za integracije SSO, če locale ni določen, se bo ta posodobil vsakič, ko uporabnik
dostopa do pripomočka za komentarje z drugo lokalizacijo. To pomeni, da se njihova jezikovna preference
samodejno posodobi in bodo prihodnja e-poštna sporočila poslana v tej lokalizaciji.
To je mogoče nastaviti tudi ročno z vključitvijo locale v SSO payload.
Predloge za posamezno domeno 
Predloge je mogoče nastaviti kot globalne - v celotnem najemniku za ta tip predloge, ali
za posamezno domeno. V zavihku Settings izberite želeno domeno.
Upoštevajte, da če nastavite več predlog za isto domeno, se med izvajanjem uporabi samo prva. Seznam predlog vas bo opozoril, ko do te situacije pride.
Podatki in spremenljivke 
Vsaka predloga deluje v drugačnem kontekstu, kar pomeni, da so na voljo različni podatki.
Hiter način, da na prvi pogled vidite, kateri podatki so na voljo, je, da preverite testne podatke
priložene predlogi. Ko urejate predlogo, kliknite zavihek Test Data, da vidite
strukturo JSON.
V tem območju lahko testne podatke tudi prilagodimo, da vidimo, kako naša predloga izgleda
v različnih situacijah. Testne podatke je mogoče ponastaviti na privzete z gumbom Reset.
Napake pri upodabljanju 
Ker e-poštne predloge podpirajo spremenljivke in logiko, je mogoče ustvariti predloge, ki se ne uspejo upodobiti, ali se včasih ne uspejo upodobiti.
To je lahko zelo frustrirajuče za diagnosticiranje in odpravljanje napak, še posebej, če gre za občasno težavo ali če se pojavi samo, ko podatki izgledajo na določen način.
Da bi pomagali, ima FastComments Email Templates nekaj funkcij:
- Če se predloga pri predogledu ne uspe upodobiti, je ni mogoče shraniti. Prikazano bo sporočilo o napaki.
- Napake pri upodabljanju predlog so spremljane in poročane v upravljalskem vmesniku.
Druga točka opisuje napake pri upodabljanju, ki se zgodijo v produkciji. Torej, ustvarite predlogo, ki se v predogledu prikaže brez težav - vendar pozneje iz neznanega razloga ne uspe. Na primer, če imamo v naši predlogi to:
<% if (comment.commenterEmail.includes('test') { %>To se včasih lahko zatakne, če imamo omogočeno anonimno komentiranje, saj e-pošta ne bo vedno na voljo. Kako torej izvemo za to?
Odgovor je, da se napake pokažejo na dveh mestih. Najprej seznam predlog sam prikaže število napak pri upodabljanju za vsako predlogo.
Ko nato gledamo posamezno predlogo, lahko vidimo število, za vsako napako posebej, kolikokrat se je predloga neuspešno upodobila.
Gumb za ponastavitev se nahaja zraven vsake napake in njenega števila, tako da lahko ponastavimo števec potem ko smo težavo odpravili.