תבניות הדוא"ל של FastComments משתמשות בשפת התבניות EJS.

דוגמת התחביר היא <%= object.someValue %> להדפסת משתנים, ומשפטי תנאי יכולים להיעשות כך:

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

הדפסת HTML גולמי, כגון עבור תוכן התגובה, נעשית כך: <%- comment.commentHTML %>. שים לב ל-- במקום =.

עיין בקישור שלמעלה לתיעוד נוסף על התחביר.

FastComments היא פלטפורמה עם לוקליזציה. כל הווידג'טים, הודעות הדוא"ל וההתראות שלנו מותאמים באופן מקומי.

לוקליזציה פירושה שאנו מציגים שפה ועימוד שונים בהתבסס על מיקום המשתמש ושפתו המועדפת. אנו קובעים זאת על סמך המידע שהדפדפן של המשתמש מספק לנו.

נוכל להתאים אישית את הטקסט בדוא"ל על ידי מעבר ללשונית Translations, בחירה ב־Locale ועריכת הטקסט. טקסט ששונה מהברירת מחדל מסומן בממשק המשתמש. ניתן לעבור בין לוקאלים ולשמור בסיום, מבלי לאבד את השינויים.

לטקסט המותאם ניגשים דרך האובייקט TEXT, לדוגמה: <%= TEXT.INTRO %>.

הערה לגבי SSO

לשילובי SSO, אם לא צויין locale, הוא יעודכן בכל פעם שהמשתמש ניגש לווידג'ט התגובות עם לוקאל שונה. משמעות הדבר היא שהעדפת השפה שלו תעודכן אוטומטית, ודוא"לים עתידיים ישלחו בלוקאל הזה.

ניתן גם להגדיר זאת ידנית על ידי שילוב locale ב-payload של SSO.

ניתן להגדיר תבניות כך שיהיו גלובליות - ברחבי כל ה-tenant שלך עבור סוג תבנית זה, או לפי דומיין. בלשונית Settings בחר את הדומיין הרצוי.

שים לב שאם תגדיר מספר תבניות עבור אותו דומיין, רק הראשונה נבחרת בזמן הריצה. רשימת התבניות תזהיר אותך כאשר מצב כזה מתרחש.

כל תבנית פועלת בתוך הקשר שונה, כלומר זמין מידע שונה.

דרך מהירה במבט חטוף לראות איזה נתונים זמינים היא לבדוק את נתוני הבדיקה המסופקים עבור התבנית. בעת עריכת תבנית, לחץ על לשונית Test Data כדי לראות מבנה JSON.

ניתן גם להתאים אישית את נתוני הבדיקה באזור זה, כדי לראות כיצד התבנית שלנו נראית במצבים שונים. ניתן לאפס את נתוני הבדיקה חזרה לברירות המחדל באמצעות לחצן Reset.

מכיוון שתבניות דוא"ל תומכות במשתנים ובלוגיקה, ייתכן ליצור תבניות שלא מצליחות לעבור רינדור, או שלפעמים נכשלות ברינדור.

זה יכול להיות מתסכל מאוד לאבחון ולדיבוג, במיוחד אם הבעיה היא מזדמנת, או אם היא מתרחשת רק כאשר הנתונים נראים בצורה מסוימת.

כדי לעזור, ל-FastComments Email Templates יש כמה תכונות:

1. If the template fails to preview, it cannot be saved. An error message will be shown.
2. Template render failures are tracked and reported on in the admin UI.

הנקודה השנייה מתארת כשלונות רינדור שמתרחשים בפרודקשן. כלומר, אתה יוצר תבנית שמציגה תצוגה מקדימה בסדר - אך מאוחר יותר נכשלת מסיבה כלשהי. לדוגמה, אם יש לנו את זה בתבנית שלנו:

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

זה עשוי להיכשל לפעמים אם תגובות אנונימיות מופעלות, מכיוון שכתובת דוא"ל לא תמיד תהיה זמינה. אז איך נגלה את זה?

התשובה היא שהשגיאות מוצגות בשני מקומות. ראשית, רשימת התבניות עצמה מציגה ספירת שגיאות רינדור לצד כל תבנית.

ואז, כאשר צופים בתבנית ניתן לראות ספירה, לכל שגיאה, של מספר הפעמים שהתבנית נכשלה ברינדור.

לחצן איפוס ממוקם לצד כל שגיאה וספירתה, כך שניתן לאפס את המונה לאחר שפתרנו את הבעיה.

יצירה ועריכה של תבניות דואר אלקטרוני מתבצעת באופן מיידי.

משמעות הדבר היא, ברגע שתלחץ על כפתור ה-Save, ה פלטפורמה תתחיל להשתמש בגרסה העדכנית ביותר של אותו דואר אלקטרוני.