תבניות דואר אלקטרוני
כדי לספק חוויה קוהרנטית יותר עבור בסיס המשתמשים שלך, FastComments מספקת פתרון להתאמת דוא"ל כך שההודעות הנשלחות ללקוחותיך, מ-FastComments, יוכלו להתאים למיתוג שלך.
בתיעוד זה נכסה את תכונות פתרון זה, שפת התבניות, לוקליזציה, ועוד.
יצירת תבניות 
את אזור הניהול ליצירת תבניות ניתן למצוא על ידי מעבר ל-התאמה אישית -> תבניות דוא"ל.
כאן תראה רשימה של סוגי המיילים השונים שנשלחים על ידי הפלטפורמה, עם תיאור לכל תבנית המתאר מתי היא משמשת.
לדוגמה, נוכל להתאים אישית את דוא"ל ה-Commenter Comment Notification, שהוא Sent when a commenter has a reply to their comment.
לחיצה על Create Template לא תחיל את השינויים מיידית. ניתן לפתוח את העורך
עבור תבנית ברירת המחדל ולהתנסות בתצוגה המקדימה, ולא יהיה לכך אפקט
עד שתלחץ על Save.
שפת התבנית
תבניות הדוא"ל של 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 כוללת מספר יכולות:
- אם התבנית נכשלת בתצוגה מקדימה, לא ניתן לשמור אותה. תוצג הודעת שגיאה.
- כשלי עיבוד של תבניות נמדדים ומדווחים בממשק הניהול.
הנקודה השנייה מתארת כשלי עיבוד שמתרחשים בסביבת הייצור. כלומר, אתם יוצרים תבנית שתצוגה המקדימה שלה תקינה - אך מאוחר יותר היא נכשלת מסיבה כלשהי. לדוגמה, אם יש לנו זאת בתבנית שלנו:
<% if (comment.commenterEmail.includes('test') { %>קוד זה עשוי להיכשל לעיתים אם התגובות האנונימיות מופעלות, מכיוון שהאימייל לא תמיד יהיה זמין. אז איך נודעים על כך?
התשובה היא שהשגיאות מוצגות בשני מקומות. ראשית, רשימת התבניות עצמה מציגה מספר שגיאות עיבוד עבור כל תבנית.
לאחר מכן, בצפייה בתבנית ניתן לראות מונה, לכל שגיאה, של מספר הפעמים שהתבנית נכשלה בעיבוד.
לצד כל שגיאה והמונה שלה נמצא כפתור איפוס, כך שנוכל לאפס את המונה לאחר שפתרנו את הבעיה.
החלת שינויים
יצירה ועריכה של תבניות דואר אלקטרוני מתבצעת באופן מיידי.
משמעות הדבר היא, ברגע שתלחץ על כפתור ה-Save, ה
פלטפורמה תתחיל להשתמש בגרסה העדכנית ביותר של אותו דואר אלקטרוני.