
भाषा 🇮🇳 हिन्दी
इंस्टॉलेशन
कमेंट काउंट APIs
कमेंट काउंट विजेट
FastComments हल्के, स्वतंत्र कमेंट काउंट विजेट प्रदान करता है जो विशिष्ट पेजों या पोस्टों के लिए कमेंट की संख्या दिखा सकते हैं। ये विजेट मुख्य कमेंटिंग विजेट से अलग हैं और उन जगहों पर उपयोग के लिए बनाए गए हैं जहाँ आप पूरी कमेंटिंग इंटरफ़ेस के बिना कमेंट काउंट दिखाना चाहते हैं।
दो प्रकार के कमेंट काउंट विजेट उपलब्ध हैं:
- Comment Count Widget - किसी एक पेज का कमेंट काउंट दिखाने के लिए
- Bulk Comment Count Widget - एक ही पेज पर कई पेजों के कमेंट काउंट कुशलतापूर्वक दिखाने के लिए
यह लेख VanillaJS विजेट को कवर करता है। हमारी React/Angular/आदि लाइब्रेरीज़ में भी उनके अपने विजेट हैं।
कमेंट काउंट विजेट इंस्टॉलेशन 
कमेंट काउंट विजेट किसी एक पेज की कमेंट संख्या दिखाने के लिए बनाया गया है। यह हल्का है और कॉन्फ़िगर किए जाने पर रीयल-टाइम अपडेट प्रदान करता है।
बेसिक इंस्टॉलेशन
Run 
कॉन्फ़िगरेशन विकल्प
FastCommentsCommentCount फ़ंक्शन निम्नलिखित कॉन्फ़िगरेशन विकल्प स्वीकार करता है:
- tenantId (आवश्यक): आपकी FastComments टेनेंट ID
- urlId (वैकल्पिक): पेज पहचानकर्ता। यदि निर्दिष्ट नहीं किया गया है तो डिफ़ॉल्ट रूप से
window.location.hrefहोता है - numberOnly (वैकल्पिक): यदि
trueहै, तो केवल संख्या बिना किसी टेक्स्ट के रेंडर होती है। डिफ़ॉल्टfalseहै - isLive (वैकल्पिक): यदि
trueहै, तो संख्या स्वचालित रूप से अपडेट होगी। डिफ़ॉल्टfalseहै
उन्नत उदाहरण
कस्टम URL ID
Run 
केवल संख्या डिस्प्ले
Run 
लाइव अपडेट
Run 
विजेट मेथड्स
विजेट निम्नलिखित मेथड्स के साथ एक ऑब्जेक्ट लौटाता है:
- destroy(): विजेट को हटाता है और सभी टाइमर साफ़ करता है
- update(config): नई कॉन्फ़िगरेशन के साथ विजेट को अपडेट करता है
उपयोग का उदाहरण
Run 
स्टाइलिंग
विजेट कमेंट संख्या के साथ सादा HTML रेंडर करता है और इसमें न्यूनतम स्टाइलिंग शामिल है। आप CSS के साथ उपस्थिति को अनुकूलित कर सकते हैं:
Run 
बल्क कमेंट काउंट विजेट इंस्टॉलेशन 
बल्क कमेंट काउंट विजेट एक ही पेज पर कई पेजों के लिए कमेंट काउंट कुशलतापूर्वक प्रदर्शित करने के लिए डिज़ाइन किया गया है। प्रत्येक कमेंट काउंट के लिए अलग-अलग API कॉल करने के बजाय, यह विजेट बेहतर प्रदर्शन के लिए अनुरोधों को बैच में भेजता है।
बेसिक इंस्टॉलेशन
Run 
यह कैसे काम करता है
बल्क विजेट इस तरह काम करता है:
- पेज पर
fast-comments-countक्लास वाले एलिमेंट्स को स्कैन करता है - प्रत्येक एलिमेंट से
data-fast-comments-url-idएट्रिब्यूट पढ़ता है - कई कमेंट काउंट कुशलतापूर्वक प्राप्त करने के लिए API अनुरोधों को बैच में भेजता है
- प्रत्येक एलिमेंट को उपयुक्त कमेंट काउंट के साथ अपडेट करता है
कॉन्फ़िगरेशन विकल्प
FastCommentsCommentCountBulk फ़ंक्शन निम्नलिखित कॉन्फ़िगरेशन विकल्प स्वीकार करता है:
- tenantId (आवश्यक): आपकी FastComments टेनेंट ID
- apiHost (वैकल्पिक): कस्टम API होस्ट, यदि आप सेल्फ-होस्टेड इंस्टेंस का उपयोग कर रहे हैं
वास्तविक दुनिया का उदाहरण
यहाँ एक व्यावहारिक उदाहरण है जो दिखाता है कि आप ब्लॉग पोस्ट लिस्टिंग में बल्क विजेट का उपयोग कैसे कर सकते हैं:
Run 
प्रदर्शन संबंधी विचार
बल्क विजेट स्वचालित रूप से प्रदर्शन को अनुकूलित करता है:
- अनुरोधों का बैचिंग: कई कमेंट काउंट एक ही API कॉल में प्राप्त किए जाते हैं
- अनुरोध आकार सीमाएँ: यदि URL सूची बहुत बड़ी हो जाती है (1,000 से अधिक वर्ण) तो अनुरोध स्वचालित रूप से विभाजित हो जाते हैं
- डीप्लिकेशन: समान
data-fast-comments-url-idवाले कई एलिमेंट्स एक ही काउंट साझा करते हैं
समान URL ID वाले कई एलिमेंट्स
आप पेज पर समान data-fast-comments-url-id वाले कई एलिमेंट्स रख सकते हैं। उन सभी को एक ही काउंट के साथ अपडेट किया जाएगा:
Run 
स्थानीयकरण
बल्क विजेट आपकी FastComments भाषा सेटिंग्स के आधार पर कमेंट काउंट को स्वचालित रूप से फ़ॉर्मेट करता है। यह निम्नलिखित के लिए उपयुक्त टेक्स्ट प्रदान करता है:
- शून्य कमेंट
- एक कमेंट
- कई कमेंट
बल्क बनाम सिंगल विजेट का उपयोग कब करें
बल्क विजेट का उपयोग करें जब:
- आपके पास एक ही पेज पर कई कमेंट काउंट हों
- आप कमेंट काउंट के साथ पोस्ट/आर्टिकल की सूची प्रदर्शित कर रहे हों
- प्रदर्शन महत्वपूर्ण हो (API कॉल कम करता है)
सिंगल विजेट का उपयोग करें जब:
- आपको पेज पर केवल एक कमेंट काउंट की आवश्यकता हो
- आपको लाइव अपडेट की आवश्यकता हो (सिंगल विजेट रियल-टाइम अपडेट का समर्थन करता है)
- आप अलग-अलग विजेट व्यवहार पर अधिक नियंत्रण चाहते हों
कमेंट काउंट APIs 
गिनतियाँ प्राप्त करने के लिए कुछ endpoints हैं, जो इस बात पर निर्भर करता है कि आप क्या चाहते हैं और आप उन्हें ब्राउज़र से, सर्वर से, या API SDK का उपयोग करके प्राप्त करना चाहते हैं।
सार्वजनिक कमेंट गिनतियाँ
आप ऊपर दिए गए widgets का उपयोग करके या उन APIs का उपयोग करके सार्वजनिक कमेंट गिनतियाँ प्राप्त कर सकते हैं जिनका वे उपयोग करते हैं। ये APIs 2019 से अपरिवर्तित हैं और कभी नहीं बदलेंगी।

यह इस तरह की एक संरचना लौटाएगा:

postfix प्रॉपर्टी हमेशा शामिल रहती है।

यह इस तरह की एक संरचना लौटाएगा:

counts ऑब्जेक्ट केवल उन पेजों के लिए भरा जाता है जिनकी गिनतियाँ होती हैं। translations मैप हमेशा मौजूद रहता है क्योंकि इसका उपयोग widget के लिए किया जाता है।
सार्वजनिक एंडपॉइंट व्यवहार / कैशिंग
सार्वजनिक endpoints में ट्रैफ़िक के शिखरों को संभालने के लिए 60-सेकंड की कैशिंग प्रणाली है। आंतरिक रूप से यह सर्वर पर मेमोरी में प्रति-थ्रेड LRU कैश है, इसलिए जब लोग बहुत सारे कमेंट छोड़ रहे हों तो आप गिनतियों में थोड़ा बदलाव देख सकते हैं (अस्थायी रूप से ऊपर जाकर फिर नीचे आ जाना)।
सार्वजनिक endpoints हमेशा कुल कमेंट गिनती लौटाते हैं, न कि रूट कमेंट गिनती।
सर्वर-साइड APIs / SDK
अपने सर्वर से कमेंट प्राप्त करने का तरीका है Pages API को कॉल करना और पेज ऑब्जेक्ट प्राप्त करना, जिसमें कुल कमेंट गिनती और रूट कमेंट गिनती शामिल होती है। हम SDKs प्रदान करते हैं जो आपको API अनुरोध को मैन्युअल रूप से बनाए बिना इस API को कॉल करने की अनुमति देते हैं, और टाइप किए गए रिटर्न मान प्रदान करते हैं।
FastComments कमेंट काउंट विजेट आपकी साइट पर कमेंट की संख्या दिखाने का एक सरल और कुशल तरीका प्रदान करते हैं।
हमें उम्मीद है कि आपको यह दस्तावेज़ीकरण उपयोगी लगा होगा।