Pour contribuer à offrir une expérience plus cohérente à votre base d'utilisateurs, FastComments fournit une solution de personnalisation des courriels afin que les courriels envoyés à vos clients, par FastComments, correspondent à votre image de marque.
Dans cette documentation, nous couvrirons les fonctionnalités de cette solution, le langage de gabarits, la localisation, et plus encore.
Création de modèles 
La zone d'administration pour créer des modèles se trouve en allant dans Personnaliser -> Modèles d'e-mails.
Ici, vous verrez une liste des différents types d'e-mails envoyés par la plateforme, avec une description pour chaque modèle décrivant quand il est utilisé.
Par exemple, nous pouvons personnaliser l'e-mail Commenter Comment Notification, qui est Sent when a commenter has a reply to their comment.
Cliquer sur Create Template n'appliquera pas immédiatement les modifications. Vous pouvez ouvrir l'éditeur
pour le modèle par défaut et jouer avec l'aperçu, et il n'y aura aucun effet
jusqu'à ce que vous cliquiez sur Save.
Langage des modèles
Les modèles d'e-mails FastComments utilisent le EJS template language.
La syntaxe d'exemple est <%= object.someValue %> pour afficher des variables, et les instructions conditionnelles peuvent être écrites ainsi :
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>Pour afficher du HTML brut, comme le contenu d'un commentaire, faites : <%- comment.commentHTML %>. Remarquez le - au lieu du =.
Consultez le lien ci‑dessus pour plus de documentation sur la syntaxe.
Localisation et texte personnalisé
FastComments est une plateforme localisée. Tous nos widgets, courriels et notifications sont localisés.
Localisé signifie que nous affichons une langue et un format différents, selon l'emplacement de l'utilisateur et sa langue préférée. Nous déterminons cela à partir des informations fournies par le navigateur de l'utilisateur.
Nous pouvons personnaliser le texte du courriel en allant à l'onglet Translations, en sélectionnant un Locale et en modifiant le texte. Le texte modifié par rapport à la valeur par défaut est encadré dans l'interface utilisateur. Vous pouvez basculer entre les locales et enregistrer à la fin, sans perdre les modifications.
Le texte localisé est accessible via l'objet TEXT, par exemple : <%= TEXT.INTRO %>.
Remarque SSO
Pour les intégrations SSO, si locale n'est pas spécifié, il sera mis à jour chaque fois que l'utilisateur accède au widget de commentaires avec une locale différente. Cela signifie que sa préférence de langue est automatiquement mise à jour et que les futurs courriels seront envoyés dans cette locale.
Cela peut aussi être défini manuellement en fournissant locale dans le payload SSO.
Modèles par domaine
Les modèles peuvent être configurés pour être globaux - pour l'ensemble de votre locataire pour ce type de modèle, ou
par domaine. Dans l'onglet Settings sélectionnez le domaine souhaité.
Notez que si vous configurez plusieurs modèles pour le même domaine, seul le premier est utilisé à l'exécution. La liste des modèles vous avertira lorsque cette situation se produit.
Données et variables
Chaque modèle fonctionne dans un contexte différent, ce qui signifie que des données différentes sont disponibles.
Un moyen rapide d’un coup d’œil pour voir quelles données sont disponibles consiste à vérifier les données de test
fournies pour le modèle. Lors de la modification d’un modèle, cliquez sur l’onglet Test Data pour voir
une structure JSON.
Nous pouvons également personnaliser les données de test dans cette zone, pour voir à quoi ressemble notre modèle
dans différentes situations. Les données de test peuvent être réinitialisées aux valeurs par défaut avec le bouton Reset.
Échecs de rendu
Puisque les modèles d'e-mail prennent en charge des variables et de la logique, il est possible de créer des modèles qui échouent à être rendus, ou parfois échouent à être rendus.
Cela peut être très frustrant à diagnostiquer et à déboguer, surtout si c'est un problème intermittent, ou si cela n'arrive que lorsque les données ont une certaine apparence.
Pour aider, FastComments Email Templates offre quelques fonctionnalités :
- Si le modèle ne parvient pas à être prévisualisé, il ne peut pas être enregistré. Un message d'erreur sera affiché.
- Les échecs de rendu des modèles sont suivis et signalés dans l'interface d'administration.
Le deuxième point décrit des échecs de rendu qui surviennent en production. Autrement dit, vous créez un modèle qui se prévisualise correctement - mais qui échoue plus tard pour une raison quelconque. Par exemple, si nous avons ceci dans notre modèle :
<% if (comment.commenterEmail.includes('test') { %>Cela peut parfois échouer si les commentaires anonymes sont activés, puisque l'adresse e-mail ne sera pas toujours disponible. Alors, comment le découvrir ?
La réponse est que les erreurs sont signalées à deux endroits. Tout d'abord, la liste des modèles elle-même affiche un compteur d'erreurs de rendu pour chaque modèle.
Ensuite, en affichant un modèle, nous pouvons voir, pour chaque erreur, le nombre de fois que le modèle n'a pas pu être rendu.
Un bouton de réinitialisation se trouve à côté de chaque erreur et de son compteur, afin que nous puissions remettre le compteur à zéro après avoir résolu le problème.
Application des modifications
La création et la modification des modèles de courriel sont instantanées. Cela signifie que, dès que vous appuyez sur le bouton Save, la
plateforme commencera à utiliser la version la plus récente de ce courriel.