กลับไปที่แดชบอร์ด

เอกสาร

เรียนรู้วิธีใช้ Asyntai

วิธีเพิ่มแชทบอท AI Asyntai ไปยัง Moodle

คู่มือทีละขั้นตอนสำหรับเว็บไซต์ Moodle LMS

รับโค้ดฝัง

ขั้นตอนที่ 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: การใช้ Additional HTML (แนะนำ)

Moodle มีฟีเจอร์ในตัวสำหรับเพิ่ม HTML/JavaScript แบบกำหนดเองไปยังทุกหน้า:

  1. เข้าสู่ระบบเว็บไซต์ Moodle ของคุณในฐานะผู้ดูแลระบบ
  2. ไปที่ Site administration
  3. นำทางไปยัง Appearance → Additional HTML
  4. เลื่อนลงไปที่ส่วน "Before BODY is closed"
  5. วางโค้ดฝัง Asyntai ของคุณในพื้นที่ข้อความ
  6. คลิก "Save changes"

เคล็ดลับ: การเพิ่มโค้ดไปยัง "Before BODY is closed" จะวางไว้ก่อนแท็กปิด </body> ซึ่งเป็นตำแหน่งที่แนะนำสำหรับวิดเจ็ตแชทและทำให้โหลดหลังจากเนื้อหาหลักของหน้า

ทางเลือก: การใช้การตั้งค่าธีม

ธีม Moodle หลายตัว (รวมถึง Boost และรุ่นย่อย) มีการตั้งค่าของตัวเองสำหรับเพิ่ม JavaScript แบบกำหนดเอง:

  1. ไปที่ Site administration → Appearance → Themes
  2. คลิก Theme settings สำหรับธีมที่ใช้งานอยู่ (เช่น Boost)
  3. มองหาส่วน "Raw SCSS", "Additional HTML" หรือ "Custom JavaScript"
  4. หากมีฟิลด์ JavaScript ให้วางโค้ดฝังตัว Asyntai ของคุณที่นั่น
  5. คลิก "Save changes"
  6. ล้างแคช: Site administration → Development → Purge caches

หมายเหตุ: การตั้งค่าเฉพาะธีมแตกต่างกันระหว่างธีม หากธีมของคุณไม่มีฟิลด์ JavaScript ให้ใช้วิธี Additional HTML ข้างต้น

ทางเลือก: สร้าง Local Plugin

สำหรับการควบคุมที่มากขึ้น คุณสามารถสร้าง local plugin อย่างง่าย:

  1. สร้างโครงสร้างโฟลเดอร์: local/asyntaichatbot/ ในการติดตั้ง Moodle ของคุณ
  2. สร้าง version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. สร้าง lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. สร้างโฟลเดอร์ amd/src/ และไฟล์ loader.js:
    define([], function() {
      return {
        init: function() {
          var script = document.createElement('script');
          script.async = true;
          script.src = 'https://asyntai.com/static/js/chat-widget.js';
          script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
          document.body.appendChild(script);
        }
      };
    });
  5. แทนที่ YOUR_WIDGET_ID ด้วย widget ID จริงของคุณ
  6. ไปที่ Site administration → Notifications เพื่อติดตั้ง plugin
  7. ล้างแคชหลังการติดตั้ง

สำคัญ: วิธี local plugin ต้องการการเข้าถึง command-line เพื่อสร้างไฟล์ สำหรับผู้ใช้ส่วนใหญ่ วิธี Additional HTML จะง่ายกว่าและเพียงพอ

ทางเลือก: แก้ไขเทมเพลตส่วนท้ายของธีม

คุณยังสามารถแก้ไขเทมเพลตส่วนท้ายของธีมโดยตรง:

  1. นำทางไปยังโฟลเดอร์ธีมของคุณ: theme/YOUR_THEME/
  2. ค้นหาไฟล์ layout (เช่น layout/columns2.php หรือ templates/columns2.mustache)
  3. ค้นหาแท็กปิด </body> หรือส่วนท้าย
  4. เพิ่มโค้ดฝังตัว Asyntai ของคุณก่อน </body>
  5. บันทึกไฟล์
  6. ล้างแคช Moodle

สำคัญ: การแก้ไขไฟล์ธีมโดยตรงหมายความว่าการเปลี่ยนแปลงอาจหายไปเมื่ออัปเดตธีม ใช้ child theme หรือวิธี Additional HTML สำหรับโซลูชันที่ถาวรกว่า

ขั้นตอนที่ 3: ยืนยันการติดตั้ง

หลังจากบันทึกการเปลี่ยนแปลงและล้างแคชแล้ว ให้เปิดเว็บไซต์ Moodle ของคุณในแท็บเบราว์เซอร์ใหม่หรือหน้าต่างไม่ระบุตัวตน คุณควรเห็นปุ่มวิดเจ็ตแชทที่มุมขวาล่าง คลิกเพื่อตรวจสอบว่าเปิดขึ้นมาและทำงานได้อย่างถูกต้อง

ไม่เห็นวิดเจ็ต? ตรวจสอบให้แน่ใจว่าล้างแคช Moodle ทั้งหมดแล้ว: ไปที่ Site administration → Development → Purge all caches ลองล้างแคชเบราว์เซอร์หรือดูในหน้าต่างไม่ระบุตัวตน หากคุณใช้ปลั๊กอินแคชหรือ reverse proxy ให้ล้างแคชเหล่านั้นด้วย