วิธีเพิ่มแชทบอท AI Asyntai ลงใน CrafterCMS
คู่มือทีละขั้นตอนสำหรับเว็บไซต์ CrafterCMS
ขั้นตอนที่ 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: เพิ่มลงในเทมเพลต FreeMarker (แนะนำ)
CrafterCMS ใช้เทมเพลต FreeMarker (.ftl) สำหรับเรนเดอร์หน้าเว็บ วิธีที่ง่ายที่สุดในการเพิ่มแชทบอทในทุกหน้าคือการแก้ไขเทมเพลตหน้าหลักของคุณ:
- ใน Crafter Studio ไปที่ Site Dashboard > Content Types หรือไปที่เทมเพลต
- เปิดเทมเพลตหน้าหลักของคุณ (เช่น
/templates/web/pages/home.ftlหรือเลย์เอาต์หลัก) - ค้นหาแท็กปิด
</body> - วางโค้ดฝัง Asyntai ของคุณก่อนแท็ก
</body>:<!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body> - บันทึกไฟล์และเผยแพร่ผ่าน Crafter Studio
เคล็ดลับ: การเพิ่มสคริปต์ก่อนแท็กปิด </body> ช่วยให้โหลดหลังจากเนื้อหาหน้าเว็บ ซึ่งแนะนำสำหรับวิดเจ็ตแชทและจะไม่ทำให้หน้าเว็บโหลดช้าลง
วิธีทางเลือกที่ 1: การใช้ Crafter Template Components
เพื่อการจัดระเบียบที่ดีขึ้น ให้สร้างเทมเพลตคอมโพเนนต์เฉพาะสำหรับวิดเจ็ตแชทบอท:
- ใน Crafter Studio สร้างไฟล์เทมเพลตใหม่ที่
/templates/web/components/asyntai-widget.ftl - เพิ่มเนื้อหาต่อไปนี้ลงในเทมเพลตคอมโพเนนต์:
<!-- Asyntai AI Chatbot Component --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - รวมไว้ในเทมเพลตเลย์เอาต์หลักของคุณโดยใช้คำสั่ง include ของ FreeMarker:
<#include "/templates/web/components/asyntai-widget.ftl" /> - หรือหากใช้ระบบเรนเดอร์คอมโพเนนต์ของ Crafter ให้ใช้:
<@renderComponent component=contentModel.asyntaiWidget /> - บันทึกทั้งสองไฟล์และเผยแพร่ผ่าน Crafter Studio
หมายเหตุ: การใช้เทมเพลตคอมโพเนนต์แยกต่างหากทำให้ง่ายต่อการเปิดหรือปิดแชทบอทในเว็บไซต์ทั้งหมดของคุณโดยคอมเมนต์บรรทัด include เดียว
วิธีทางเลือกที่ 2: การใช้การตั้งค่า Head/Scripts ของ Crafter
CrafterCMS อนุญาตให้คุณแทรกสคริปต์ทั่วทั้งเว็บไซต์ผ่านการตั้งค่าเว็บไซต์:
- ใน Crafter Studio ไปที่ Site Config > Configuration
- เปิดไฟล์ Engine Site Configuration (
site-config.xml) - เพิ่มการตั้งค่าการแทรกสคริปต์แบบกำหนดเอง:
<site> <!-- Existing configuration... --> <!-- Custom Scripts --> <scripts> <script> <src>https://asyntai.com/static/js/chat-widget.js</src> <async>true</async> <data-asyntai-id>YOUR_WIDGET_ID</data-asyntai-id> </script> </scripts> </site> - หรือแก้ไขเลย์เอาต์ FreeMarker หลักของคุณเพื่ออ่านจากการตั้งค่าเว็บไซต์และแทรกสคริปต์แบบไดนามิก:
<#if siteConfig.getString("scripts.script.src", "")?has_content> <script async src="${siteConfig.getString("scripts.script.src")}" data-asyntai-id="${siteConfig.getString("scripts.script.data-asyntai-id")}"></script> </#if> - บันทึกและเผยแพร่การเปลี่ยนแปลงการตั้งค่า
เคล็ดลับ: การใช้การตั้งค่าเว็บไซต์ช่วยให้คุณจัดการวิดเจ็ตแชทบอทโดยไม่ต้องแก้ไขไฟล์เทมเพลตโดยตรง ทำให้ง่ายต่อการอัปเดตหรือลบในภายหลัง
วิธีทางเลือกที่ 3: การใช้ Groovy Controller
CrafterCMS รองรับสคริปต์ Groovy สำหรับลอจิกฝั่งเซิร์ฟเวอร์ คุณสามารถใช้ controller เพื่อเพิ่มสคริปต์แชทบอทแบบไดนามิก:
- สร้างสคริปต์ Groovy ใน
/scripts/pages/(เช่น/scripts/pages/home.groovyหรือ controller ทั่วทั้งเว็บไซต์ของคุณ) - เพิ่มโค้ดต่อไปนี้เพื่อแทรก URL สคริปต์ลงในโมเดลเทมเพลต:
// /scripts/pages/home.groovy import org.craftercms.engine.service.context.SiteContext def siteContext = SiteContext.current // Add Asyntai chatbot configuration to the model model.asyntaiEnabled = true model.asyntaiWidgetId = "YOUR_WIDGET_ID" model.asyntaiScriptSrc = "https://asyntai.com/static/js/chat-widget.js" - จากนั้นอ้างอิงตัวแปรโมเดลในเทมเพลต FreeMarker ของคุณ:
<#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if> - บันทึกทั้งสคริปต์ Groovy และไฟล์เทมเพลต
- เผยแพร่การเปลี่ยนแปลงผ่าน Crafter Studio
หมายเหตุ: วิธี Groovy controller มีประโยชน์เมื่อคุณต้องการลอจิกแบบมีเงื่อนไข (เช่น เปิดใช้งานแชทบอทเฉพาะบทบาทผู้ใช้หรือประเภทหน้าบางอย่าง) หรือเมื่อคุณต้องการดึงค่าการตั้งค่าจากแหล่งภายนอก
ขั้นตอนที่ 3: เผยแพร่และตรวจสอบ
หลังจากทำการเปลี่ยนแปลง ให้เผยแพร่ผ่าน Crafter Studio:
- ใน Crafter Studio ไปที่ Site Dashboard
- ตรวจสอบการเปลี่ยนแปลงของคุณในส่วน My Recent Activity หรือ Pending Approval
- คลิก Publish เพื่อเผยแพร่การเปลี่ยนแปลงไปยังเว็บไซต์ของคุณ
- เยี่ยมชมเว็บไซต์ CrafterCMS ของคุณในแท็บเบราว์เซอร์ใหม่หรือหน้าต่างส่วนตัว
- คุณควรเห็นปุ่มวิดเจ็ตแชทที่มุมล่างขวา
- คลิกเพื่อให้แน่ใจว่าเปิดและทำงานได้อย่างถูกต้อง
ไม่เห็นวิดเจ็ต? ตรวจสอบให้แน่ใจว่าคุณได้เผยแพร่การเปลี่ยนแปลงผ่าน Crafter Studio ตรวจสอบว่าคุณกำลังแก้ไขไฟล์เทมเพลตที่ถูกต้องที่หน้าเว็บของคุณใช้ ล้างแคชเบราว์เซอร์หรือดูในหน้าต่างส่วนตัว หากใช้การแคชของ Crafter ให้ล้างแคช Engine จากแดชบอร์ด Crafter Studio
ตำแหน่งเทมเพลต: ตำแหน่งเทมเพลต CrafterCMS อาจแตกต่างกันขึ้นอยู่กับโครงสร้างโปรเจกต์ของคุณ ตำแหน่งทั่วไป ได้แก่ /templates/web/pages/ สำหรับเทมเพลตหน้า, /templates/web/components/ สำหรับเทมเพลตคอมโพเนนต์ และ /templates/web/ สำหรับเทมเพลตเลย์เอาต์ ตรวจสอบเทมเพลตที่มีอยู่เพื่อค้นหาว่าแท็ก </body> ถูกกำหนดไว้ที่ใด
Weebly