ईमेल टेम्पलेट

FastComments ईमेल टेम्पलेट्स EJS टेम्पलेट भाषा का उपयोग करते हैं।

सिंटैक्स का उदाहरण <%= object.someValue %> है जो वेरिएबल प्रिंट करता है, और कंडीशनल स्टेटमेंट इस प्रकार किए जा सकते हैं:

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

रॉ HTML प्रिंट करना, जैसे कमेंट कंटेंट के लिए, इस प्रकार किया जाता है: <%- comment.commentHTML %>। ध्यान दें = के स्थान पर - का उपयोग।

सिंटैक्स पर आगे के दस्तावेज़ीकरण के लिए ऊपर दिए गए लिंक को देखें।

FastComments एक स्थानीयकृत (localized) प्लेटफ़ॉर्म है। हमारे सभी विजेट, ईमेल और सूचनाएँ स्थानीयकृत हैं।

स्थानीयकृत का अर्थ है कि हम उपयोगकर्ता के स्थान और पसंदीदा भाषा के आधार पर अलग भाषा और फ़ॉर्मेटिंग दिखाते हैं। हम यह निर्धारण उपयोगकर्ता के ब्राउज़र द्वारा हमें दी गई जानकारी के आधार पर करते हैं।

हम Translations टैब पर जाकर, एक Locale चुनकर और टेक्स्ट संपादित करके ईमेल में टेक्स्ट को कस्टमाइज़ कर सकते हैं। डिफ़ॉल्ट से बदला गया टेक्स्ट UI में रेखांकित (outlined) दिखाया जाता है। आप विभिन्न locales के बीच स्विच कर सकते हैं और अंत में सहेज सकते हैं, बिना परिवर्तनों को खोए।

स्थानीयकृत टेक्स्ट को TEXT ऑब्जेक्ट के माध्यम से एक्सेस किया जाता है, उदाहरण के लिए: <%= TEXT.INTRO %>।

SSO नोट

SSO इंटीग्रेशन के लिए, यदि locale निर्दिष्ट नहीं किया गया है, तो जब भी उपयोगकर्ता कमेंट विजेट को किसी भिन्न locale के साथ एक्सेस करेगा, यह अपडेट हो जाएगा। इसका अर्थ है कि उनकी भाषा प्राथमिकता स्वचालित रूप से अपडेट हो जाती है, और भविष्य के ईमेल उसी locale में भेजे जाएँगे।

इसे SSO पेलोड में locale प्रदान करके मैन्युअल रूप से भी सेट किया जा सकता है।

टेम्पलेट्स को ग्लोबल (आपके पूरे टेनेंट के लिए उस टेम्पलेट प्रकार के लिए) या प्रति-डोमेन के रूप में सेटअप किया जा सकता है। Settings टैब में वांछित डोमेन चुनें।

ध्यान दें कि यदि आप एक ही डोमेन के लिए कई टेम्पलेट्स सेटअप करते हैं, तो रनटाइम पर केवल पहला चुना जाता है। जब यह स्थिति होती है, तो टेम्पलेट्स सूची आपको चेतावनी देगी।

प्रत्येक टेम्पलेट एक अलग संदर्भ में काम करता है, जिसका अर्थ है कि अलग-अलग डेटा उपलब्ध होता है।

यह देखने का एक त्वरित तरीका कि कौन सा डेटा उपलब्ध है, टेम्पलेट के लिए दिए गए टेस्ट डेटा की जांच करना है। टेम्पलेट संपादित करते समय, JSON संरचना देखने के लिए Test Data टैब पर क्लिक करें।

हम इस क्षेत्र में टेस्ट डेटा को भी कस्टमाइज़ कर सकते हैं, यह देखने के लिए कि हमारा टेम्पलेट विभिन्न स्थितियों में कैसा दिखता है। टेस्ट डेटा को Reset बटन से डिफ़ॉल्ट पर वापस रीसेट किया जा सकता है।

चूंकि ईमेल टेम्पलेट्स वेरिएबल्स और लॉजिक का समर्थन करते हैं, ऐसे टेम्पलेट्स बनाना संभव है जो रेंडर होने में विफल हो जाते हैं, या कभी-कभी रेंडर होने में विफल होते हैं।

इसका निदान और डिबग करना बहुत निराशाजनक हो सकता है, खासकर यदि यह एक रुक-रुक कर होने वाली समस्या है, या यदि यह केवल तब होता है जब डेटा किसी विशेष रूप में दिखता है।

मदद के लिए, FastComments Email Templates में कुछ विशेषताएं हैं:

1. यदि टेम्पलेट प्रीव्यू में विफल होता है, तो इसे सेव नहीं किया जा सकता। एक त्रुटि संदेश दिखाया जाएगा।
2. टेम्पलेट रेंडर विफलताओं को ट्रैक किया जाता है और एडमिन UI में रिपोर्ट किया जाता है।

दूसरा बिंदु प्रोडक्शन में होने वाली रेंडर विफलताओं का वर्णन करता है। अर्थात, आप एक टेम्पलेट बनाते हैं जो प्रीव्यू में ठीक दिखता है - लेकिन बाद में किसी कारण से विफल हो जाता है। उदाहरण के लिए, यदि हमारे टेम्पलेट में यह है:

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

यह कभी-कभी विफल हो सकता है यदि हमारे पास अनाम (anonymous) टिप्पणी सक्षम है, क्योंकि ईमेल हमेशा उपलब्ध नहीं होगा। तो हमें इसके बारे में कैसे पता चलेगा?

उत्तर यह है कि त्रुटियां दो जगहों पर दिखाई देती हैं। सबसे पहले, टेम्पलेट सूची स्वयं प्रत्येक टेम्पलेट के साथ एक रेंडर त्रुटि संख्या दिखाती है।

फिर, जब हम कोई टेम्पलेट देखते हैं तो हम प्रति-त्रुटि, टेम्पलेट के रेंडर होने में विफल होने की संख्या देख सकते हैं।

प्रत्येक त्रुटि के बगल में, और उसकी संख्या के बगल में, एक रीसेट बटन स्थित है, ताकि समस्या हल करने के बाद हम काउंटर को रीसेट कर सकें।

ईमेल टेम्पलेट बनाना और संपादित करना तुरंत प्रभावी होता है। इसका मतलब है कि जैसे ही आप Save बटन दबाते हैं, प्लेटफ़ॉर्म उस ईमेल के नवीनतम संस्करण का उपयोग करना शुरू कर देगा।