ProcessWire में Asyntai AI चैटबॉट कैसे जोड़ें

ProcessWire CMS वेबसाइटों के लिए चरण-दर-चरण गाइड

प्लेटफ़ॉर्म:

चरण 1: अपना एम्बेड कोड प्राप्त करें

सबसे पहले, अपने Asyntai डैशबोर्ड पर जाएँ और नीचे "Embed Code" अनुभाग तक स्क्रॉल करें। अपना यूनिक एम्बेड कोड कॉपी करें, जो कुछ इस तरह दिखेगा:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

नोट: ऊपर दिया गया कोड केवल एक उदाहरण है। आपको अपने डैशबोर्ड से अपना अद्वितीय एम्बेड कोड कॉपी करना होगा क्योंकि इसमें आपकी व्यक्तिगत विजेट ID होती है।

चरण 2: टेम्पलेट फ़ाइल में जोड़ें (अनुशंसित)

ProcessWire site/templates/ डायरेक्टरी में स्थित PHP टेम्पलेट फ़ाइलों का उपयोग करता है। सबसे आसान तरीका एम्बेड कोड को सीधे अपनी मुख्य टेम्पलेट फ़ाइल में जोड़ना है:

FTP, SSH, या अपने फ़ाइल मैनेजर के माध्यम से अपनी ProcessWire इंस्टॉलेशन फ़ाइलों तक पहुँचें
site/templates/ पर नेविगेट करें
अपनी मुख्य टेम्पलेट फ़ाइल खोलें — यह अक्सर आपकी साइट प्रोफ़ाइल के आधार पर _main.php या basic-page.php होती है
यदि आप delayed output strategy (अधिकांश साइट प्रोफ़ाइलों के लिए डिफ़ॉल्ट) का उपयोग कर रहे हैं, तो _main.php खोलें
क्लोज़िंग </body> टैग खोजें
इसके ठीक पहले अपना Asyntai एम्बेड कोड पेस्ट करें:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
</body>

सुझाव: क्लोजिंग </body> टैग से ठीक पहले स्क्रिप्ट रखने से यह सुनिश्चित होता है कि चैटबॉट पेज कंटेंट के बाद लोड हो, जो इष्टतम प्रदर्शन के लिए अनुशंसित है और आपके पेज रेंडरिंग को धीमा नहीं करेगा।

वैकल्पिक विधि 1: _foot.inc या _main.php एपेंड फ़ाइल का उपयोग

यदि आपकी ProcessWire साइट अपेंड फ़ाइल दृष्टिकोण का उपयोग करती है (कई साइट प्रोफ़ाइलों में सामान्य), तो आप साझा फ़ुटर इन्क्लूड में एम्बेड कोड जोड़ सकते हैं:

site/templates/ पर नेविगेट करें
_foot.inc (या अपनी समकक्ष फ़ुटर इन्क्लूड फ़ाइल) खोलें
क्लोज़िंग </body> टैग से ठीक पहले अपना Asyntai एम्बेड कोड पेस्ट करें
फ़ाइल सहेजें

ProcessWire की delayed output strategy आमतौर पर तीन प्रमुख फ़ाइलों के साथ काम करती है:

_init.php — हर टेम्पलेट से पहले चलता है, वेरिएबल्स को इनिशियलाइज़ करता है
आपकी टेम्पलेट फ़ाइल (जैसे, basic-page.php) — कंटेंट वेरिएबल्स को भरती है
_main.php — उन वेरिएबल्स का उपयोग करके अंतिम HTML मार्कअप आउटपुट करती है

यदि आपकी साइट इस दृष्टिकोण का उपयोग करती है, तो </body> से पहले _main.php में स्क्रिप्ट जोड़ने से यह सुनिश्चित होता है कि यह हर पेज पर दिखाई दे।

नोट: The file names _init.php and _main.php are configured अपने site/config.php via the $config->prependTemplateFile and $config->appendTemplateFile settings. Check your config if your files are named differently.

वैकल्पिक विधि 2: $config->scripts ऐरे का उपयोग

ProcessWire provides a $config->scripts FilenameArray that you can use to manage JavaScript files. In your _init.php or individual template file, add:

<?php
$config->scripts->add('https://asyntai.com/static/js/chat-widget.js');
?>

फिर अपने _main.php (या फ़ुटर इन्क्लूड) में, उन्हें आउटपुट करने के लिए स्क्रिप्ट ऐरे के माध्यम से लूप करें:

<?php foreach($config->scripts as $file): ?>
<script src="<?php echo $file; ?>"></script>
<?php endforeach; ?>

महत्वपूर्ण: The $config->scripts approach handles the script src attribute, but the data-asyntai-id attribute needs to be handled separately. You will need to either add the data attribute manually in the loop output, or use the direct script tag method from Step 2 instead for the simplest setup.

वैकल्पिक विधि 3: हुक का उपयोग (ready.php)

अधिक उन्नत दृष्टिकोण के लिए, आप हर पेज में चैटबॉट स्क्रिप्ट को स्वचालित रूप से इंजेक्ट करने के लिए ProcessWire के हुक सिस्टम का उपयोग कर सकते हैं। अपनी site/ready.php फ़ाइल में निम्नलिखित जोड़ें:

<?php
$wire->addHookAfter('Page::render', function(HookEvent $event) {
    $html = $event->return;
    $script = '<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>';
    $html = str_replace('</body>', $script . '</body>', $html);
    $event->return = $html;
});
?>

यह हुक हर पेज के रेंडर किए गए HTML आउटपुट को इंटरसेप्ट करता है और क्लोजिंग </body> टैग से ठीक पहले स्वचालित रूप से Asyntai स्क्रिप्ट इंजेक्ट करता है।

सुझाव: यदि आप किसी टेम्पलेट फ़ाइल को संशोधित किए बिना हर पेज पर चैटबॉट चाहते हैं तो ready.php हुक दृष्टिकोण आदर्श है। यह टेम्पलेट परिवर्तनों और थीम अपडेट के बाद भी बना रहता है क्योंकि यह टेम्पलेट फ़ाइलों के बाहर रहता है।

चरण 3: इंस्टॉलेशन सत्यापित करें

अपने परिवर्तन सहेजने के बाद, एक नए ब्राउज़र टैब या इनकॉग्निटो विंडो में अपनी ProcessWire साइट पर जाएँ। आपको नीचे दाएं कोने में चैट विजेट बटन दिखाई देना चाहिए। यह सुनिश्चित करने के लिए इस पर क्लिक करें कि यह खुलता है और सही ढंग से काम करता है।

विजेट दिखाई नहीं दे रहा? सुनिश्चित करें कि आपने सभी संशोधित फ़ाइलों को सहेज लिया है। अपना ब्राउज़र कैश साफ़ करने या इनकॉग्निटो विंडो में देखने का प्रयास करें। यदि ProcessWire का टेम्पलेट कैश सक्षम है, तो आपको Modules → Core → Template Engine Cache पर जाकर या अपने URL में ?nocache=1 जोड़कर इसे साफ़ करने की आवश्यकता हो सकती है। यह भी सत्यापित करें कि आपकी टेम्पलेट फ़ाइल वास्तव में उन पेजों द्वारा उपयोग की जा रही है जिन्हें आप देख रहे हैं।