Τα πρότυπα email του FastComments χρησιμοποιούν τη γλώσσα προτύπων EJS.

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

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

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

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

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

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

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

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

Σημείωση SSO

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Η δημιουργία και επεξεργασία προτύπων email είναι άμεση.

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