วิธีเพิ่มแชทบอท AI Asyntai ไปยัง TYPO3
คู่มือทีละขั้นตอนสำหรับเว็บไซต์ TYPO3
ขั้นตอนที่ 1: รับโค้ดฝังตัวของคุณ
ก่อนอื่น ไปที่แดชบอร์ด Asyntai ของคุณและเลื่อนลงไปที่ส่วน "Embed Code" คัดลอกโค้ดฝังตัวเฉพาะของคุณซึ่งจะมีลักษณะดังนี้:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
หมายเหตุ: โค้ดด้านบนเป็นเพียงตัวอย่าง คุณต้องคัดลอกโค้ดฝังตัวเฉพาะของคุณจากแดชบอร์ดเนื่องจากมี widget ID ส่วนตัวของคุณ
ขั้นตอนที่ 2: การใช้ TypoScript footerData (แนะนำ)
วิธีที่ง่ายที่สุดในการเพิ่มแชทบอทไปยังทุกหน้าคือใช้ TypoScript footerData:
- เข้าสู่ระบบ TYPO3 Backend ของคุณ
- ไปที่ Web → Template
- เลือกหน้ารากในโครงสร้างหน้า
- คลิก "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ด้วย widget ID จริงของคุณจากแดชบอร์ด - คลิก "Save"
- ล้างแคช TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
เคล็ดลับ: การใช้ footerData วางสคริปต์ก่อนแท็กปิด </body> ซึ่งแนะนำสำหรับวิดเจ็ตแชทเนื่องจากจะไม่ทำให้หน้าโหลดช้าลง
ทางเลือก: การใช้ Site Package (สำหรับ Site Packages)
หากคุณใช้ site package คุณสามารถเพิ่มสคริปต์ผ่านไฟล์การกำหนดค่า TypoScript:
- นำทางไปยังโฟลเดอร์ site package ของคุณ:
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ด้วย widget ID จริงของคุณ - ล้างแคชใน TYPO3 backend
ทางเลือก: การใช้ Fluid Template (FooterAssets)
สำหรับเว็บไซต์ที่ใช้ Fluid templates คุณสามารถใช้ส่วน FooterAssets:
- นำทางไปยังไฟล์ Fluid template ของคุณ (โดยปกติอยู่ใน
Resources/Private/Templates/) - เพิ่มส่วน FooterAssets ใน layout หรือเทมเพลตของคุณ:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - ตรวจสอบให้แน่ใจว่า page layout ของคุณแสดงผลส่วน FooterAssets:
<f:render section="FooterAssets" optional="true" /> - ล้างแคช TYPO3
สำคัญ: ฟีเจอร์ FooterAssets ต้องการ TYPO3 v8 หรือใหม่กว่า สำหรับเวอร์ชันเก่า ให้ใช้วิธี TypoScript footerData
ทางเลือก: การใช้ AssetCollector (สำหรับนักพัฒนา)
สำหรับนักพัฒนา extension TYPO3 v10.3+ มี AssetCollector API:
- ในโค้ด PHP ของคุณ (เช่น controller หรือ middleware) ให้ inject AssetCollector
- เพิ่มสคริปต์พร้อม custom attributes:
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 ให้ตรวจสอบว่าเทมเพลตของคุณถูกรวมอย่างถูกต้องในลำดับชั้นของหน้า
Weebly