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

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

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

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

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

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

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

चरण 2: TypoScript footerData का उपयोग (अनुशंसित)

सभी पेजों पर चैटबॉट जोड़ने का सबसे आसान तरीका TypoScript footerData का उपयोग करना है:

अपने TYPO3 बैकएंड में लॉग इन करें
वेब → टेम्पलेट पर जाएँ
पेज ट्री में अपना रूट पेज चुनें
"Edit the whole template record" पर क्लिक करें (या \"Info/Modify\" और फिर \"Setup\" चुनें)
Setup फ़ील्ड में, निम्नलिखित TypoScript कोड जोड़ें:
page.footerData.99 = TEXT page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
YOUR_WIDGET_ID को डैशबोर्ड से अपनी वास्तविक विजेट ID से बदलें
"सहेजें" पर क्लिक करें
TYPO3 कैश साफ़ करें: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

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

वैकल्पिक: साइट पैकेज का उपयोग (साइट पैकेज के लिए)

यदि आप साइट पैकेज का उपयोग कर रहे हैं, तो आप अपनी TypoScript कॉन्फ़िगरेशन फ़ाइल के माध्यम से स्क्रिप्ट जोड़ सकते हैं:

अपने साइट पैकेज फ़ोल्डर पर नेविगेट करें: packages/your_sitepackage/Configuration/TypoScript/
setup.typoscript खोलें या बनाएँ
निम्नलिखित कोड जोड़ें:
page.footerData { 99 = TEXT 99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> }
YOUR_WIDGET_ID को अपनी वास्तविक विजेट ID से बदलें
TYPO3 बैकएंड में कैश साफ़ करें

वैकल्पिक: Fluid टेम्पलेट का उपयोग (FooterAssets)

Fluid टेम्पलेट्स का उपयोग करने वाली साइटों के लिए, आप FooterAssets अनुभाग का उपयोग कर सकते हैं:

अपनी Fluid टेम्पलेट फ़ाइल पर नेविगेट करें (आमतौर पर Resources/Private/Templates/ में)
अपने लेआउट या टेम्पलेट में FooterAssets अनुभाग जोड़ें:
<f:section name="FooterAssets"> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </f:section>
सुनिश्चित करें कि आपका पेज लेआउट FooterAssets अनुभाग रेंडर करता है:
<f:render section="FooterAssets" optional="true" />
TYPO3 कैश साफ़ करें

महत्वपूर्ण: FooterAssets सुविधा के लिए TYPO3 v8 या बाद के संस्करण की आवश्यकता होती है। पुराने संस्करणों के लिए, TypoScript footerData विधि का उपयोग करें।

वैकल्पिक: AssetCollector का उपयोग (डेवलपर्स के लिए)

एक्सटेंशन डेवलपर्स के लिए, TYPO3 v10.3+ AssetCollector API प्रदान करता है:

अपने PHP कोड (जैसे, एक कंट्रोलर या मिडलवेयर) में, AssetCollector इंजेक्ट करें
कस्टम एट्रिब्यूट के साथ स्क्रिप्ट जोड़ें:
use TYPO3\CMS\Core\Page\AssetCollector; $this->assetCollector->addJavaScript( 'asyntai_chatbot', 'https://asyntai.com/static/js/chat-widget.js', ['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'] );

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

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

विजेट दिखाई नहीं दे रहा? सभी कैश साफ़ करना सुनिश्चित करें: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache पर जाएँ। अपने ब्राउज़र कैश को साफ़ करने या इनकॉग्निटो विंडो में देखने का भी प्रयास करें। यदि TypoScript का उपयोग कर रहे हैं, तो सत्यापित करें कि आपका टेम्पलेट पेज पदानुक्रम में ठीक से शामिल है।