Το FastComments Email Templates χρησιμοποιεί τη γλώσσα προτύπων EJS.

Παράδειγμα σύνταξης είναι <%= object.someValue %> για την εμφάνιση μεταβλητών, και οι δηλώσεις υπό συνθήκη μπορούν να γίνουν ως εξής:

<% if (some_condition) { %>
    <div>Some content.</div>
<% } else { %>
    <div>Some other content.</div>
<% } %>

Η εκτύπωση ακατέργαστου HTML, όπως για το περιεχόμενο του σχολίου, γίνεται ως εξής: <%- comment.commentHTML %>. Σημειώστε το - αντί για το =.

Ανατρέξτε στον παραπάνω σύνδεσμο για περισσότερη τεκμηρίωση σχετικά με τη σύνταξη.

FastComments είναι μια πλατφόρμα τοπικής προσαρμογής. Όλα τα widgets, τα ηλεκτρονικά μηνύματα και οι ειδοποιήσεις μας είναι τοπικοποιημένα.

Τοπικοποιημένο σημαίνει ότι εμφανίζουμε διαφορετική γλώσσα και μορφοποίηση, με βάση την τοποθεσία του χρήστη και την προτιμώμενη γλώσσα του. Το προσδιορίζουμε αυτό βάσει των πληροφοριών που παρέχει ο περιηγητής του χρήστη.

Μπορούμε να προσαρμόσουμε το κείμενο στο email πηγαίνοντας στην καρτέλα Translations, επιλέγοντας ένα Locale και επεξεργαζόμενοι το κείμενο. Το κείμενο που έχει αλλαχθεί σε σχέση με την προεπιλογή επισημαίνεται στο UI. Μπορείτε να μεταβείτε μεταξύ των locales και να αποθηκεύσετε στο τέλος, χωρίς να χάσετε τις αλλαγές.

Το τοπικοποιημένο κείμενο προσπελαύνεται μέσω του αντικειμένου TEXT, για παράδειγμα: <%= TEXT.INTRO %>.

Σημείωση SSO

Για ενσωματώσεις SSO, αν το locale δεν καθοριστεί, θα ενημερώνεται κάθε φορά που ο χρήστης προσπελαύνει το widget σχολίων με διαφορετικό locale. Αυτό σημαίνει ότι η προτίμηση γλώσσας του χρήστη ενημερώνεται αυτόματα και τα μελλοντικά ηλεκτρονικά μηνύματα θα αποστέλλονται σε εκείνο το locale.

Αυτό μπορεί επίσης να οριστεί χειροκίνητα παρέχοντας το locale στο SSO payload.

Τα πρότυπα μπορούν να ρυθμιστούν ώστε να είναι παγκόσμια - σε όλο το tenant σας για αυτόν τον τύπο προτύπου, ή ανά domain. Στην καρτέλα Settings επιλέξτε τον επιθυμητό domain.

Σημειώστε ότι εάν ρυθμίσετε πολλαπλά πρότυπα για τον ίδιο domain, μόνο το πρώτο επιλέγεται κατά το runtime. Η λίστα προτύπων θα σας προειδοποιήσει όταν παρουσιαστεί αυτή η κατάσταση.

Κάθε πρότυπο λειτουργεί σε διαφορετικό πλαίσιο, που σημαίνει ότι διατίθενται διαφορετικά δεδομένα.

Ένας γρήγορος τρόπος με μια ματιά για να δείτε ποια δεδομένα είναι διαθέσιμα είναι να ελέγξετε τα δοκιμαστικά δεδομένα που παρέχονται για το πρότυπο. Όταν επεξεργάζεστε ένα πρότυπο, κάντε κλικ στην καρτέλα Test Data για να δείτε τη δομή JSON.

Μπορούμε επίσης να προσαρμόσουμε τα δοκιμαστικά δεδομένα σε αυτήν την περιοχή, για να δούμε πώς εμφανίζεται το πρότυπό μας σε διαφορετικές καταστάσεις. Τα δοκιμαστικά δεδομένα μπορούν να επαναφερθούν στις προεπιλεγμένες τιμές με το κουμπί Reset.

Επειδή τα πρότυπα email υποστηρίζουν μεταβλητές και λογική, είναι πιθανό να δημιουργηθούν πρότυπα που δεν αποδίδονται, ή που μερικές φορές αποτυγχάνουν να αποδοθούν.

Αυτό μπορεί να είναι πολύ απογοητευτικό για διάγνωση και εντοπισμό σφαλμάτων, ιδιαίτερα αν το πρόβλημα είναι διαλείπον ζήτημα, ή αν συμβαίνει μόνο όταν τα δεδομένα έχουν μια συγκεκριμένη μορφή.

Για να βοηθήσει, το FastComments Email Templates διαθέτει μερικά χαρακτηριστικά:

1. Αν το πρότυπο αποτύχει στην προεπισκόπηση, δεν μπορεί να αποθηκευτεί. Θα εμφανιστεί μήνυμα σφάλματος.
2. Οι αποτυχίες απόδοσης προτύπου παρακολουθούνται και αναφέρονται στο admin UI.

Το δεύτερο σημείο περιγράφει αποτυχίες απόδοσης που συμβαίνουν στην παραγωγή. Δηλαδή, δημιουργείτε ένα πρότυπο που προεπισκοπείται κανονικά - αλλά αργότερα αποτυγχάνει για κάποιο λόγο. Για παράδειγμα, αν έχουμε αυτό στο πρότυπό μας:

<% if (comment.commenterEmail.includes('test') { %>

Αυτό μπορεί να αποτύχει μερικές φορές αν η ανώνυμη σχολιαστική λειτουργία είναι ενεργοποιημένη, καθώς το email δεν θα είναι πάντα διαθέσιμο. Πώς λοιπόν το ανακαλύπτουμε;

Η απάντηση είναι ότι τα σφάλματα εμφανίζονται σε δύο σημεία. Πρώτον, η λίστα προτύπων ίδια εμφανίζει έναν αριθμό σφαλμάτων απόδοσης για κάθε πρότυπο.

Έπειτα, όταν βλέπουμε ένα πρότυπο μπορούμε να δούμε έναν μετρητή, ανά σφάλμα, με τον αριθμό φορών που το πρότυπο απέτυχε να αποδοθεί.

Ένα κουμπί επαναφοράς βρίσκεται δίπλα σε κάθε σφάλμα και στον μετρητή του, ώστε να μπορούμε να επαναφέρουμε τον μετρητή αφού έχουμε επιλύσει το ζήτημα.

Η δημιουργία και επεξεργασία προτύπων email είναι άμεση. Αυτό σημαίνει, μόλις πατήσετε το κουμπί Save, η πλατφόρμα θα αρχίσει να χρησιμοποιεί την τελευταία έκδοση αυτού του email.