Drupal साइटों में लाइव कमेंटिंग जोड़ें
क्विक स्टार्ट 
यह Drupal निर्देशों का "too long did not read" संस्करण है।
- मॉड्यूल को
composer require drupal/fcomसे इंस्टॉल करें, या इसेmodules/custom/fastcomments/में डाल दें। - इसे
drush en fastcommentsसे सक्षम करें, या/admin/modulesपर एडमिन UI से करें। Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments) पर जाएँ।- Settings > API/SSO (EU) से अपनी Tenant ID और API Secret दर्ज करें।
Structure > Content types > [type] > Manage fieldsके माध्यम से किसी भी कंटेंट टाइप मेंFastCommentsफ़ील्ड जोड़ें।
मॉड्यूल drupal.org/project/fcom पर प्रकाशित है।
इंस्टॉलेशन
FastComments Drupal मॉड्यूल Drupal के बिल्ट-इन कमेंट्स को एक तेज़, रियल-टाइम कमेंटिंग सिस्टम से बदल देता है। यह मॉड्यूल drupal.org पर प्रकाशित है और Drupal 10 तथा 11 के साथ काम करता है।
इसे इंस्टॉल करने के दो तरीके हैं।
Composer के साथ इंस्टॉल करें
composer require drupal/fcom
drush en fastcommentsमैन्युअल रूप से इंस्टॉल करें
मॉड्यूल को drupal.org/project/fcom से डाउनलोड करें और इसे अपनी साइट की modules/custom/fastcomments/ डायरेक्टरी में रखें। फिर इसे drush en fastcomments से, या एडमिन UI में Extend (/admin/modules) से सक्रिय करें।
ध्यान दें! यह मॉड्यूल केवल Drupal core (user और field) पर निर्भर करता है। किसी अन्य Drupal मॉड्यूल या लाइब्रेरी की आवश्यकता नहीं है।
मॉड्यूल सक्रिय होने के बाद, अपनी Tenant ID और API Secret सेट अप करने के लिए Configuration सेक्शन पर जाएँ।
कॉन्फ़िगरेशन
सभी सेटिंग्स Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments) के अंतर्गत होती हैं।
आवश्यक
- Tenant ID - आपकी FastComments Tenant ID। यह Settings > API/SSO (EU) के अंतर्गत मिलती है।
- API Secret - Secure SSO, webhook सत्यापन, और page sync के लिए आवश्यक। यह Settings > API/SSO (EU) के अंतर्गत मिलता है।
API Secret को संग्रहीत करना
मॉड्यूल इन स्रोतों में से पहले से API Secret पढ़ता है जिसमें मान मौजूद हो:
- Key module - Key इंस्टॉल करें, एक Authentication key बनाएं, और सेटिंग्स फ़ॉर्म पर API Secret key के अंतर्गत उसे चुनें। यह key एक environment variable या web root के बाहर की फ़ाइल द्वारा समर्थित हो सकती है।
- settings.php -
settings.phpयाsettings.local.phpमें$config['fastcomments.settings']['api_secret'] = 'your-secret';जोड़ें। यह secret कभी भी exported configuration में नहीं जाता। - सेटिंग्स फ़ॉर्म - इसे API Secret फ़ील्ड में दर्ज करें। इससे मान
fastcomments.settingsमें संग्रहीत होता है, इसलिए यह configuration exports में समाप्त हो जाता है। जब यह सक्रिय स्रोत होता है, तो Drupal status report चेतावनी देता है।
फ़ॉर्म दिखाता है कि कौन सा स्रोत सक्रिय है। फ़ील्ड खाली छोड़ने पर संग्रहीत secret बना रहता है। Key module या settings.php में secret स्थानांतरित करने के बाद इसे हटाने के लिए Remove the API Secret stored in configuration पर टिक करें।
टिप्पणी शैली
वह विजेट चुनें जो इस बात से मेल खाता हो कि आप चाहते हैं कि लोग आपकी साइट पर कैसे बातचीत करें।
- Live Comments - रीयल-टाइम थ्रेडेड टिप्पणियाँ।
- Streaming Chat - लाइव चैट इंटरफ़ेस, इवेंट्स और लाइवस्ट्रीम के लिए उपयुक्त।
- Collab Chat - मुख्य कंटेंट क्षेत्र पर टेक्स्ट-चयन एनोटेशन। विज़िटर टेक्स्ट हाइलाइट करते हैं और संदर्भ में चर्चा शुरू करते हैं।
- Collab Chat + Comments - एक ही पेज पर collab chat और मानक टिप्पणियाँ दोनों।
SSO Mode
- None - कोई SSO नहीं। उपयोगकर्ता अतिथि के रूप में टिप्पणी करते हैं या FastComments खाता बनाते हैं।
- Simple - Drupal उपयोगकर्ता जानकारी (नाम, ईमेल, अवतार) को बिना सर्वर-साइड सत्यापन के FastComments को भेजता है।
- Secure - Drupal उपयोगकर्ताओं को FastComments के साथ सत्यापित करने के लिए HMAC-SHA256 का उपयोग करता है। जब आपके पास API Secret कॉन्फ़िगर हो, तो यह अनुशंसित है।
विवरण के लिए Single Sign-On (SSO) खंड देखें।
अन्य सेटिंग्स
- CDN URL - डिफ़ॉल्ट
https://cdn.fastcomments.comहै। - Site URL - डिफ़ॉल्ट
https://fastcomments.comहै। - Email notifications - जब किसी कंटेंट लेखक के कंटेंट पर नई टिप्पणी पोस्ट होती है, तो उसे ईमेल भेजें।
EU डेटा रेसिडेंसी के लिए, EU Data Residency खंड देखें।
विजेट ब्लॉक्स
यह मॉड्यूल कई ब्लॉक्स प्रदान करता है जिन्हें आप Structure > Block layout (/admin/structure/block) से जोड़ सकते हैं।
- FastComments Widget - मुख्य कमेंटिंग विजेट। यह वर्तमान एंटिटी को अपने आप पहचान लेता है। यह उन एंटिटीज़ को छोड़ देता है जिनमें FastComments फ़ील्ड पहले से जुड़ा है, इसलिए आपको एक ही पेज पर डुप्लिकेट विजेट नहीं दिखेंगे।
- FastComments Live Chat - रीयल-टाइम स्ट्रीमिंग चैट। इसे उसी पेज पर कमेंट फ़ील्ड के साथ रखा जा सकता है।
- FastComments Collab Chat - टेक्स्ट-सिलेक्शन एनोटेशन और चर्चा।
- FastComments Image Chat - इमेज पर कोऑर्डिनेट-आधारित एनोटेशन। विज़िटर किसी इमेज पर क्लिक करके विशिष्ट स्थानों से जुड़े कमेंट छोड़ सकते हैं।
- FastComments Recent Comments - आपकी साइट भर के हाल के कमेंट दिखाता है। काउंट ब्लॉक पर कॉन्फ़िगर किया जा सकता है।
- FastComments Top Pages - आपकी साइट के सबसे अधिक कमेंट वाले पेज दिखाता है।
कंटेंट-केंद्रित ब्लॉक्स (Live Chat, Collab Chat, Image Chat) वर्तमान एंटिटी को अपने आप पहचान लेते हैं, और गैर-एंटिटी पेजों पर पाथ-आधारित पहचानकर्ता का उपयोग करते हैं। इसका मतलब है कि वे बिना किसी अतिरिक्त सेटअप के टैक्सोनोमी पेजों, व्यूज़ और कस्टम रूट्स पर भी काम करते हैं।
कंटेंट टाइप फ़ील्ड्स
अधिकांश साइटों के लिए, टिप्पणियाँ जोड़ने का सबसे आसान तरीका है FastComments फ़ील्ड को अपने कंटेंट टाइप्स से जोड़ना। Structure > Content types > [type] > Manage fields पर जाएँ और फ़ील्ड जोड़ें।
प्रत्येक एंटिटी जिसमें यह फ़ील्ड है, उसे मिलता है:
- एक status toggle, ताकि संपादक प्रति एंटिटी टिप्पणी को चालू या बंद कर सकें।
- एक वैकल्पिक custom identifier, ताकि आप एक स्थिर ID का उपयोग कर सकें जो Drupal एंटिटी पथ से बंधा न हो।
मुख्य FastComments Widget ब्लॉक इस फ़ील्ड के बारे में जानता है, और उन एंटिटीज़ को छोड़ देगा जिनमें यह पहले से जुड़ा है। इस तरह आप प्रति-एंटिटी टिप्पणियों को ब्लॉक के साथ मिला सकते हैं बिना एक ही पेज पर विजेट दो बार देखे।
सिंगल साइन-ऑन (SSO)
FastComments, Drupal के यूज़र सिस्टम के साथ SSO (single-sign-on) के ज़रिए एकीकृत होता है। आपके यूज़र आपकी Drupal साइट पर साइन इन करते हैं, और मॉड्यूल उनकी पहचान स्वचालित रूप से FastComments को पास कर देता है। कोई अतिरिक्त अकाउंट बनाने की ज़रूरत नहीं, कोई प्रारंभिक सिंक चलाने की ज़रूरत नहीं।
मॉड्यूल तीन SSO मोड का समर्थन करता है, जिन्हें Administration > Configuration > Content > FastComments के अंतर्गत सेट किया जाता है।
None
कोई SSO नहीं। यूज़र अतिथि (guest) के रूप में टिप्पणी करते हैं या FastComments अकाउंट बनाते हैं। यदि आपकी साइट सार्वजनिक है और आपको टिप्पणियों को Drupal यूज़र से जोड़ने की आवश्यकता नहीं है, तो इसका उपयोग करें।
Simple
Drupal यूज़र का नाम, ईमेल और अवतार FastComments को सर्वर-साइड सत्यापन के बिना पास करता है। किसी API Secret की आवश्यकता नहीं। आंतरिक या कम-जोखिम वाली साइटों के लिए उपयुक्त।
Secure (अनुशंसित)
प्रत्येक यूज़र पहचान को FastComments के साथ सत्यापित करने के लिए HMAC-SHA256 का उपयोग करता है। यह वही मोड है जिसकी आपको तब आवश्यकता होती है जब आपके पास API Secret कॉन्फ़िगर हो, और यही एकमात्र मोड है जो किसी विज़िटर को दूसरे यूज़र की नकल करने से रोकता है।
यूज़र पहचान हर बार तब FastComments को पास की जाती है जब कोई यूज़र कोई टिप्पणी थ्रेड देखता है। चलाने के लिए कोई प्रारंभिक या निरंतर सिंक आवश्यक नहीं है।
(वैकल्पिक) अपने एडमिनिस्ट्रेटर्स को Users & Administrators में और मॉडरेटर्स को Comment Moderators में जोड़ें ताकि उनका अनुभव बेहतर हो और मॉडरेटर्स के लिए स्टैट ट्रैकिंग सक्षम हो सके।
SSO कैसे काम करता है, इसकी गहरी जानकारी के लिए कस्टमाइज़ेशन दस्तावेज़ों का SSO सेक्शन देखें।
अनुमतियाँ
यह मॉड्यूल तीन Drupal अनुमतियाँ जोड़ता है जिन्हें आप People > Permissions के अंतर्गत प्रति भूमिका (role) असाइन कर सकते हैं।
- Administer FastComments -
/admin/config/content/fastcommentsपर FastComments सेटिंग्स फ़ॉर्म तक पहुँच। - View FastComments - कमेंटिंग विजेट देखने के लिए आवश्यक। इस अनुमति के बिना विजेट रेंडर नहीं होता।
- Toggle FastComments - उपयोगकर्ताओं को फ़ील्ड विजेट का उपयोग करके प्रति-एंटिटी आधार पर कमेंट सक्षम या अक्षम करने की अनुमति देता है।
डिफ़ॉल्ट रूप से, केवल administer site configuration अनुमति वाले उपयोगकर्ता ही FastComments सेटिंग्स बदल सकते हैं। यदि आप चाहते हैं कि आगंतुक विजेट देख सकें, तो अनाम (anonymous) और प्रमाणित (authenticated) उपयोगकर्ताओं को View FastComments प्रदान करें।
बहुभाषी
यह मॉड्यूल स्वचालित रूप से वर्तमान Drupal साइट की भाषा हर FastComments विजेट को पास करता है। यदि आपकी Drupal साइट कई भाषाओं के लिए कॉन्फ़िगर की गई है, तो कमेंटिंग UI बिना किसी अतिरिक्त कॉन्फ़िगरेशन के संबंधित भाषा में रेंडर होगा।
यह सभी विजेट प्रकारों पर लागू होता है: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, और Top Pages।
EU डेटा रेसिडेंसी
यदि आपका FastComments खाता EU में होस्ट किया गया है, तो Administration > Configuration > Content > FastComments पर दो सेटिंग्स अपडेट करें:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
आप अपना Tenant ID और API Secret भी डिफ़ॉल्ट US डैशबोर्ड के बजाय EU डैशबोर्ड से लेना चाहेंगे, जो eu.fastcomments.com/auth/my-account/api पर उपलब्ध है। मॉड्यूल की बाकी सब चीज़ें उसी तरह काम करती हैं।
अनुकूलन
FastComments को आपकी साइट से मेल खाने के लिए अनुकूलित (customize) करने के लिए डिज़ाइन किया गया है।
यदि आप कस्टम स्टाइलिंग जोड़ना चाहते हैं, या कॉन्फ़िगरेशन में बदलाव करना चाहते हैं, तो हमारे कस्टमाइज़ेशन दस्तावेज़ीकरण देखें और जानें कि कैसे।
आवश्यकताएँ
- Drupal 10 या 11
- PHP 8.1 या नया
- एक FastComments खाता
इस मॉड्यूल को किसी अन्य Drupal मॉड्यूल या थर्ड-पार्टी लाइब्रेरी की आवश्यकता नहीं है। यह केवल Drupal कोर (user, field) पर निर्भर करता है।
एक <noscript> फॉलबैक उन विज़िटरों के लिए सर्वर-रेंडर किए गए कमेंट्स प्रदान करता है जिनके पास JavaScript नहीं है, ताकि Live Comments और Streaming Chat स्क्रिप्टिंग अक्षम वाले ब्राउज़रों पर भी काम करते रहें।
अपनी Drupal साइट में पोल जोड़ें
FastComments आपकी Drupal साइट पर एक बार लग जाने के बाद, आप कमेंट्स के भीतर ही लाइव पोल भी चला सकते हैं। अपनी विजेट कस्टमाइज़ेशन सेटिंग्स में Enable Polls चालू करें और कमेंट टूलबार में एक पोल बटन दिखाई देने लगता है। पोल में 2 से 10 विकल्प हो सकते हैं, परिणाम पेज पर मौजूद सभी के लिए लाइव अपडेट होते हैं, और आप तय करते हैं कि कौन पोल बना सकता है और क्या वोट करने के लिए लॉग इन ज़रूरी है। Drupal पर इसके अलावा कुछ और इंस्टॉल करने की आवश्यकता नहीं है।
Live Polls डेमो आज़माएँ या उन्हें सेट अप करने के लिए Polls दस्तावेज़ीकरण पढ़ें।