Cara Menambah Chatbot AI Asyntai ke Moodle

Panduan langkah demi langkah untuk laman web Moodle LMS

Dapatkan Kod Benam

Langkah 1: Dapatkan Kod Benam Anda

Pertama, pergi ke Papan Pemuka Asyntai anda dan tatal ke bawah ke bahagian "Kod Benam". Salin kod benam unik anda yang akan kelihatan seperti ini:

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

Nota: Kod di atas hanyalah contoh. Anda mesti menyalin kod benam unik anda sendiri dari Papan Pemuka anda kerana ia mengandungi ID widget peribadi anda.

Langkah 2: Menggunakan HTML Tambahan (Disyorkan)

Moodle mempunyai ciri terbina dalam untuk menambah HTML/JavaScript tersuai ke semua halaman:

  1. Log masuk ke laman Moodle anda sebagai pentadbir
  2. Pergi ke Site administration
  3. Navigasi ke Appearance → Additional HTML
  4. Tatal ke bawah ke bahagian "Before BODY is closed"
  5. Tampal kod benam Asyntai anda dalam kawasan teks
  6. Klik "Save changes"

Petua: Menambah kod ke "Before BODY is closed" meletakkannya sejurus sebelum tag penutup </body>, yang merupakan penempatan yang disyorkan untuk widget sembang dan memastikan ia dimuatkan selepas kandungan halaman utama.

Alternatif: Menggunakan Tetapan Tema

Banyak tema Moodle (termasuk Boost dan variannya) mempunyai tetapan sendiri untuk menambah JavaScript tersuai:

  1. Pergi ke Site administration → Appearance → Themes
  2. Klik pada Theme settings untuk tema aktif anda (contohnya, Boost)
  3. Cari bahagian "Raw SCSS", "Additional HTML", atau "Custom JavaScript"
  4. Jika terdapat medan JavaScript, tampal kod benam Asyntai anda di situ
  5. Klik "Save changes"
  6. Kosongkan cache: Site administration → Development → Purge caches

Nota: Tetapan khusus tema berbeza antara tema. Jika tema anda tidak mempunyai medan JavaScript, gunakan kaedah HTML Tambahan di atas.

Alternatif: Mencipta Plugin Tempatan

Untuk kawalan lebih, anda boleh mencipta plugin tempatan yang mudah:

  1. Cipta struktur folder: local/asyntaichatbot/ dalam pemasangan Moodle anda
  2. Cipta version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Cipta lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Cipta folder amd/src/ dan fail 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. Gantikan YOUR_WIDGET_ID dengan ID widget sebenar anda
  6. Pergi ke Site administration → Notifications untuk memasang plugin
  7. Kosongkan cache selepas pemasangan

Penting: Kaedah plugin tempatan memerlukan akses baris arahan untuk mencipta fail. Bagi kebanyakan pengguna, kaedah HTML Tambahan lebih mudah dan mencukupi.

Alternatif: Edit Templat Footer Tema

Anda juga boleh mengedit templat footer tema anda secara langsung:

  1. Navigasi ke folder tema anda: theme/YOUR_THEME/
  2. Cari fail layout (contohnya, layout/columns2.php atau templates/columns2.mustache)
  3. Cari tag penutup </body> atau bahagian footer
  4. Tambah kod benam Asyntai anda sejurus sebelum </body>
  5. Simpan fail
  6. Kosongkan cache Moodle

Penting: Mengedit fail tema secara langsung bermakna perubahan mungkin hilang semasa mengemaskini tema anda. Gunakan tema anak atau kaedah HTML Tambahan untuk penyelesaian yang lebih kekal.

Langkah 3: Sahkan Pemasangan

Selepas menyimpan perubahan anda dan mengosongkan cache, lawati laman Moodle anda dalam tab pelayar baharu atau tetingkap inkognito. Anda sepatutnya melihat butang widget sembang di sudut kanan bawah. Klik padanya untuk memastikan ia dibuka dan berfungsi dengan betul.

Tidak nampak widget? Pastikan untuk mengosongkan semua cache Moodle: pergi ke Site administration → Development → Purge all caches. Cuba juga kosongkan cache pelayar anda atau lihat dalam tetingkap inkognito. Jika anda menggunakan plugin caching atau proksi terbalik, kosongkan cache tersebut juga.