Um für Ihre Nutzerbasis ein einheitlicheres Erlebnis zu schaffen, bietet FastComments eine E-Mail-Anpassungslösung an, damit die von FastComments an Ihre Kunden gesendeten E-Mails, Ihrem Branding entsprechen können.
In dieser Dokumentation behandeln wir die Funktionen dieser Lösung, die Vorlagensprache, die Lokalisierung, und mehr.
Vorlagen erstellen 
Den Admin-Bereich zum Erstellen von Vorlagen finden Sie, indem Sie zu Anpassen -> E-Mail-Vorlagen gehen.
Hier sehen Sie eine Liste der verschiedenen vom System versandten E-Mail-Typen, mit einer Beschreibung für jede Vorlage, die erklärt, wann sie verwendet wird.
Zum Beispiel können wir die E-Mail Commenter Comment Notification anpassen, die Sent when a commenter has a reply to their comment.
Wenn Sie auf Create Template klicken, werden die Änderungen nicht sofort angewendet. Sie können den Editor für die Standardvorlage öffnen und die Vorschau ausprobieren, und es hat keine Auswirkungen, bis Sie auf Save klicken.
Vorlagensprache
FastComments-E-Mail-Vorlagen verwenden die EJS-Template-Sprache.
Die Beispielsyntax ist <%= object.someValue %> zum Ausgeben von Variablen, und bedingte Anweisungen können wie folgt geschrieben werden:
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>Die Ausgabe von rohem HTML, z. B. für den Kommentarinhalt, erfolgt so: <%- comment.commentHTML %>. Beachten Sie das - anstelle des =.
Siehe den obigen Link für weitere Dokumentation zur Syntax.
Lokalisierung und benutzerdefinierte Texte
FastComments ist eine lokalisierte Plattform. Alle unsere Widgets, E-Mails und Benachrichtigungen sind lokalisiert.
Lokalisiert bedeutet, dass wir je nach Standort und bevorzugter Sprache des Benutzers eine andere Sprache und Formatierung anzeigen. Wir ermitteln dies anhand der Informationen, die der Browser des Benutzers uns zur Verfügung stellt.
Wir können den Text in der E-Mail anpassen, indem wir auf die Translations-Registerkarte gehen, eine Locale auswählen und den Text bearbeiten. Text, der vom Standard abweicht, ist in der UI hervorgehoben. Sie können zwischen Locales wechseln und am Ende speichern, ohne Änderungen zu verlieren.
Lokalisierten Text greift man über das TEXT-Objekt ab, zum Beispiel: <%= TEXT.INTRO %>.
SSO-Hinweis
Bei SSO-Integrationen: Wenn locale nicht angegeben ist, wird es jedes Mal aktualisiert, wenn der Benutzer mit einer anderen Locale auf das Kommentar-Widget zugreift. Das bedeutet, dass die Sprachpräferenz des Benutzers automatisch aktualisiert wird und zukünftige E-Mails in dieser Locale gesendet werden.
Dies kann auch manuell gesetzt werden, indem locale im SSO-Payload übergeben wird.
Domainspezifische Vorlagen
Vorlagen können so eingerichtet werden, dass sie global sind - für Ihren gesamten Mandanten für diesen Vorlagentyp, oder
pro Domain. Wählen Sie im Tab Settings die gewünschte Domain aus.
Beachten Sie, dass wenn Sie mehrere Vorlagen für dieselbe Domain einrichten, zur Laufzeit nur die erste verwendet wird. Die Vorlagenliste warnt Sie, wenn diese Situation eintritt.
Daten und Variablen
Jede Vorlage arbeitet in einem anderen Kontext, was bedeutet, dass unterschiedliche Daten verfügbar sind.
Eine schnelle Möglichkeit auf einen Blick zu sehen, welche Daten verfügbar sind, ist, die für die Vorlage bereitgestellten Testdaten zu prüfen. Beim Bearbeiten einer Vorlage klicken Sie auf die Registerkarte Test Data, um eine JSON-Struktur zu sehen.
Wir können die Testdaten in diesem Bereich auch anpassen, um zu sehen, wie unsere Vorlage in verschiedenen Situationen aussieht. Die Testdaten können mit der Schaltfläche Reset auf die Standardeinstellungen zurückgesetzt werden.
Fehler beim Rendern
Da E-Mail-Vorlagen Variablen und Logik unterstützen, ist es möglich, Vorlagen zu erstellen die nicht gerendert werden können, oder manchmal fehlschlagen.
Dies kann sehr frustrierend sein, dies zu diagnostizieren und zu debuggen, insbesondere wenn es sich um ein intermittierendes Problem handelt, oder wenn es nur auftritt, wenn die Daten auf eine bestimmte Weise aussehen.
Um zu helfen, verfügt FastComments Email Templates über ein paar Funktionen:
- Wenn die Vorlage nicht in der Vorschau gerendert werden kann, kann sie nicht gespeichert werden. Eine Fehlermeldung wird angezeigt.
- Fehler beim Rendern von Vorlagen werden in der Admin-Oberfläche verfolgt und gemeldet.
Der zweite Punkt beschreibt Renderfehler, die in der Produktion auftreten. Das heißt, Sie erstellen eine Vorlage, die in der Vorschau funktioniert – aber später aus irgendeinem Grund fehlschlägt. Zum Beispiel, wenn wir Folgendes in unserer Vorlage haben:
<% if (comment.commenterEmail.includes('test') { %>Dies kann manchmal fehlschlagen, wenn anonyme Kommentare aktiviert sind, da die E-Mail nicht immer verfügbar sein wird. Wie erfahren wir also davon?
Die Antwort ist, dass Fehler an zwei Stellen sichtbar gemacht werden. Zuerst zeigt die Vorlagenliste selbst bei jeder Vorlage eine Anzahl von Renderfehlern an.
Wenn man dann eine Vorlage ansieht, können wir für jeden Fehler eine Zählung sehen, wie oft die Vorlage nicht gerendert werden konnte.
Neben jedem Fehler und seiner Zählung befindet sich eine Zurücksetzen-Schaltfläche, damit wir den Zähler zurücksetzen können, nachdem wir ein Problem behoben haben.
Änderungen anwenden
Erstellen und Bearbeiten von E-Mail-Vorlagen erfolgt sofort. Das bedeutet, in dem Moment, in dem Sie auf die Schaltfläche Save klicken, die
Plattform wird beginnen, die neueste Version dieser E-Mail zu verwenden.