كيفية إضافة روبوت الدردشة Asyntai AI إلى 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>
ملاحظة: الكود أعلاه مجرد مثال. يجب عليك نسخ كود التضمين الفريد الخاص بك من لوحة التحكم لأنه يحتوي على معرف الأداة الشخصي الخاص بك.
الخطوة 2: استخدام HTML إضافي (مُوصى به)
يحتوي Moodle على ميزة مدمجة لإضافة HTML/JavaScript مخصص إلى جميع الصفحات:
- سجّل الدخول إلى موقع Moodle كمسؤول
- انتقل إلى Site administration
- انتقل إلى Appearance → Additional HTML
- مرر لأسفل إلى قسم "Before BODY is closed"
- الصق كود Asyntai المضمّن في منطقة النص
- انقر على "Save changes"
نصيحة: إضافة الكود إلى "Before BODY is closed" يضعه قبل وسم الإغلاق </body> مباشرة، وهو الموضع الموصى به لأدوات الدردشة ويضمن تحميله بعد محتوى الصفحة الرئيسي.
بديل: استخدام إعدادات القالب
تحتوي العديد من قوالب Moodle (بما في ذلك Boost ومتغيراته) على إعداداتها الخاصة لإضافة JavaScript مخصص:
- انتقل إلى Site administration → Appearance → Themes
- انقر على Theme settings للقالب النشط (مثل Boost)
- ابحث عن قسم "Raw SCSS" أو "Additional HTML" أو "Custom JavaScript"
- إذا كان هناك حقل JavaScript، الصق كود التضمين الخاص بـ Asyntai هناك
- انقر على "Save changes"
- امسح ذاكرات التخزين المؤقت: Site administration → Development → Purge caches
ملاحظة: تختلف إعدادات القالب بين القوالب. إذا لم يكن القالب الخاص بك يحتوي على حقل JavaScript، استخدم طريقة HTML الإضافي أعلاه.
بديل: إنشاء إضافة محلية
لمزيد من التحكم، يمكنك إنشاء إضافة محلية بسيطة:
- أنشئ بنية المجلدات:
local/asyntaichatbot/في تثبيت Moodle الخاص بك - أنشئ version.php:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - أنشئ lib.php:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - أنشئ مجلد 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);
}
};
}); - استبدل
YOUR_WIDGET_IDبمعرف الأداة الفعلي الخاص بك - انتقل إلى Site administration → Notifications لتثبيت الإضافة
- امسح ذاكرات التخزين المؤقت بعد التثبيت
مهم: تتطلب طريقة الإضافة المحلية الوصول إلى سطر الأوامر لإنشاء الملفات. بالنسبة لمعظم المستخدمين، طريقة HTML الإضافي أبسط وكافية.
بديل: تحرير قالب تذييل القالب
يمكنك أيضًا تحرير قالب تذييل القالب مباشرة:
- انتقل إلى مجلد القالب:
theme/YOUR_THEME/ - ابحث عن ملفات التخطيط (مثل
layout/columns2.phpأوtemplates/columns2.mustache) - ابحث عن وسم الإغلاق
</body>أو قسم التذييل - أضف كود التضمين الخاص بـ Asyntai قبل
</body>مباشرة - احفظ الملف
- امسح ذاكرات التخزين المؤقت لـ Moodle
مهم: تحرير ملفات القالب مباشرة يعني أن التغييرات قد تُفقد عند تحديث القالب. استخدم قالبًا فرعيًا أو طريقة HTML الإضافي لحل أكثر ديمومة.
الخطوة 3: التحقق من التثبيت
بعد حفظ التغييرات ومسح ذاكرات التخزين المؤقت، قم بزيارة موقع Moodle الخاص بك في علامة تبويب جديدة أو نافذة تصفح خاص. يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى. انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح.
لا ترى الأداة؟ تأكد من مسح جميع ذاكرات التخزين المؤقت لـ Moodle: انتقل إلى Site administration → Development → Purge all caches. حاول أيضًا مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح خاص. إذا كنت تستخدم إضافة تخزين مؤقت أو وكيل عكسي، امسح ذاكرات التخزين المؤقت تلك أيضًا.
Weebly