Per offrire un'esperienza più coerente alla tua base di utenti, FastComments fornisce una soluzione di personalizzazione delle email in modo che le email inviate ai tuoi clienti, da FastComments, possano rispecchiare il tuo branding.
In questa documentazione tratteremo le funzionalità di questa soluzione, il linguaggio dei template, la localizzazione, e altro.
Creazione dei modelli 
L'area di amministrazione per la creazione dei template può essere trovata andando su Personalizza -> Modelli e-mail.
Qui vedrai un elenco dei diversi tipi di e-mail inviate dalla piattaforma, con una descrizione per ogni modello che spiega quando viene utilizzato.
Ad esempio, possiamo personalizzare l'e-mail Commenter Comment Notification, che è Sent when a commenter has a reply to their comment.
Fare clic su Create Template non applicherà immediatamente le modifiche. Puoi aprire l'editor
del modello predefinito e sperimentare con l'anteprima, e non ci sarà alcun effetto
fino a quando non premi Save.
Linguaggio dei modelli
FastComments Email Templates utilizza il linguaggio di template EJS.
La sintassi di esempio è <%= object.someValue %> per stampare variabili, e le istruzioni condizionali possono essere fatte così:
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>La stampa di HTML non elaborato, come per il contenuto del commento, si fa così: <%- comment.commentHTML %>. Nota il - invece di =.
Consulta il link sopra per ulteriore documentazione sulla sintassi.
Localizzazione e testo personalizzato
FastComments è una piattaforma localizzata. Tutti i nostri widget, email e notifiche sono localizzati.
Localizzato significa che mostriamo una lingua e una formattazione diverse, basate sulla posizione dell'utente e sulla lingua preferita. Determiniamo questo in base alle informazioni che il browser dell'utente ci fornisce.
Possiamo personalizzare il testo nell'email andando nella scheda Translations, selezionando una Locale
e modificando il testo. Il testo modificato rispetto al valore predefinito è evidenziato nell'interfaccia utente. Puoi
passare tra le locale e salvare alla fine, senza perdere le modifiche.
Il testo localizzato è accessibile tramite l'oggetto TEXT, per esempio: <%= TEXT.INTRO %>.
Nota SSO
Per le integrazioni SSO, se locale non è specificato, verrà aggiornato ogni volta che l'utente
accede al widget dei commenti con una locale diversa. Ciò significa che la loro preferenza linguistica
viene aggiornata automaticamente e le email future saranno inviate in quella locale.
Questo può anche essere impostato manualmente fornendo locale nel payload SSO.
Modelli per dominio
I modelli possono essere configurati per essere globali - in tutto il tenant per quel tipo di modello, oppure
per dominio. Nella scheda Settings seleziona il dominio desiderato.
Nota che se configuri più modelli per lo stesso dominio, solo il primo viene scelto durante l'esecuzione. L'elenco dei modelli ti avviserà quando si verifica questa situazione.
Dati e variabili
Ogni template funziona in un contesto diverso, il che significa che sono disponibili dati diversi.
Un modo rapido a colpo d'occhio per vedere quali dati sono disponibili è controllare i dati di test
forniti per il template. Durante la modifica di un template, cliccare sulla scheda Test Data per vedere
una struttura JSON.
Possiamo anche personalizzare i dati di test in quest'area, per vedere come appare il nostro template
in diverse situazioni. I dati di test possono essere ripristinati ai valori predefiniti con il pulsante Reset.
Errori di rendering
Poiché i template email supportano variabili, e logica, è possibile creare template che non riescono a essere renderizzati, o che a volte falliscono nel rendering.
Questo può essere molto frustrante da diagnosticare e fare il debug, specialmente se si tratta di un problema intermittente, o se si verifica solo quando i dati hanno un certo aspetto.
Per aiutare, FastComments Email Templates ha un paio di funzionalità:
- Se il template non riesce ad essere antevisualizzato, non può essere salvato. Verrà mostrato un messaggio di errore.
- I fallimenti nel rendering dei template vengono tracciati e riportati nell'interfaccia di amministrazione.
Il secondo punto descrive i fallimenti di rendering che avvengono in produzione. Cioè, crei un template che in anteprima va bene - ma in seguito fallisce per qualche motivo. Per esempio, se abbiamo questo nel nostro template:
<% if (comment.commenterEmail.includes('test') { %>Questo può fallire alcune volte se abbiamo i commenti anonimi abilitati, poiché l'email non sarà sempre disponibile. Quindi come scopriamo questo?
La risposta è che gli errori vengono resi visibili in due punti. Primo, la lista dei template stessa mostra un conteggio degli errori di rendering per ogni template.
Inoltre, quando si visualizza un template possiamo vedere un conteggio, per errore, del numero di volte in cui il template ha fallito nel rendering.
Un pulsante di reset è posizionato accanto a ciascun errore e al suo conteggio, in modo da poter azzerare il contatore dopo aver risolto il problema.
Applicazione delle modifiche
La creazione e la modifica dei template email sono immediate. Questo significa, nel momento in cui premi il pulsante Save, la
piattaforma inizierà a usare l'ultima versione di quell'email.