Pour aider à offrir une expérience plus cohérente à votre base d'utilisateurs, FastComments fournit une solution de personnalisation des e-mails afin que les e-mails envoyés à vos clients, par FastComments, puissent correspondre à votre image de marque.
Dans cette documentation, nous couvrirons les fonctionnalités de cette solution, le langage de modèles, la localisation, et plus encore.
Création de modèles 
La zone d'administration pour créer des modèles se trouve en allant sur Personnaliser -> Modèles d'e-mail.
Ici vous verrez une liste des différents types d'e-mails envoyés par la plateforme, avec une description pour chaque modèle expliquant 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 du modèle par défaut et jouer avec l'aperçu, et cela n'aura aucun effet tant que vous n'aurez pas cliqué sur Save.
Langage des modèles
FastComments Email Templates utilise le langage de templates EJS.
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, on utilise : <%- comment.commentHTML %>. Notez 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, e-mails et notifications sont localisés.
Localisé signifie que nous affichons une langue et un formatage différents en fonction de l'emplacement de l'utilisateur et de 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 dans l'e-mail en allant dans l'onglet Translations, en sélectionnant une Locale et en modifiant le texte. Le texte modifié par rapport à la valeur par défaut est mis en évidence 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 linguistique est mise à jour automatiquement, et que les futurs e-mails seront envoyés dans cette locale.
Cela peut également être défini manuellement en fournissant locale dans la charge utile SSO.
Modèles par domaine
Les modèles peuvent être configurés pour être globaux - sur 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 choisi à 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 et synthétique de voir quelles données sont disponibles est de vérifier les données de test
fournies pour le modèle. Lorsque vous modifiez 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 ne s'affichent pas, parfois de manière intermittente.
Cela peut être très frustrant à diagnostiquer et à déboguer, surtout si le problème est intermittent ou s'il ne survient que lorsque les données ont un certain aspect.
Pour aider, FastComments Email Templates propose quelques fonctionnalités :
- Si le modèle échoue lors de la prévisualisation, il ne peut pas être enregistré. Un message d'erreur sera affiché.
- Les échecs de rendu des modèles sont suivis et rapportés dans l'interface d'administration.
Le deuxième point décrit les échecs de rendu qui se produisent 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 nous avons l'option de commentaire anonyme activée, car l'e-mail ne sera pas toujours disponible. Alors comment le découvrir ?
La réponse est que les erreurs sont affichées à deux endroits. D'abord, la liste des modèles elle-même montre un nombre d'erreurs de rendu pour chaque modèle.
Ensuite, en consultant un modèle, nous pouvons voir un décompte, par type d'erreur, du nombre de fois où le modèle a échoué à se rendre.
Un bouton de réinitialisation est situé à côté de chaque erreur et de son compteur, afin que nous puissions réinitialiser le compteur après avoir résolu un problème.
Application des modifications
La création et la modification des modèles d'e-mails sont instantanées. Cela signifie que, dès que vous cliquez sur le bouton Save, la
plateforme commencera à utiliser la dernière version de cet e-mail.