Cara Menambah Chatbot AI Asyntai ke Moodle
Panduan langkah demi langkah untuk laman web Moodle LMS
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:
- Log masuk ke laman Moodle anda sebagai pentadbir
- Pergi ke Site administration
- Navigasi ke Appearance → Additional HTML
- Tatal ke bawah ke bahagian "Before BODY is closed"
- Tampal kod benam Asyntai anda dalam kawasan teks
- 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:
- Pergi ke Site administration → Appearance → Themes
- Klik pada Theme settings untuk tema aktif anda (contohnya, Boost)
- Cari bahagian "Raw SCSS", "Additional HTML", atau "Custom JavaScript"
- Jika terdapat medan JavaScript, tampal kod benam Asyntai anda di situ
- Klik "Save changes"
- 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:
- Cipta struktur folder:
local/asyntaichatbot/dalam pemasangan Moodle anda - Cipta version.php:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Cipta lib.php:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - 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);
}
};
}); - Gantikan
YOUR_WIDGET_IDdengan ID widget sebenar anda - Pergi ke Site administration → Notifications untuk memasang plugin
- 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:
- Navigasi ke folder tema anda:
theme/YOUR_THEME/ - Cari fail layout (contohnya,
layout/columns2.phpatautemplates/columns2.mustache) - Cari tag penutup
</body>atau bahagian footer - Tambah kod benam Asyntai anda sejurus sebelum
</body> - Simpan fail
- 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.
Weebly