כיצד להוסיף צ'אטבוט AI של Asyntai ל-Moodle
מדריך צעד אחר צעד לאתרי Moodle LMS
שלב 1: קבל את קוד ההטמעה שלך
ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:
<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, השתמשו בשיטת ה-Additional 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 כדי להתקין את התוסף
- נקו מטמונים לאחר ההתקנה
חשוב: שיטת התוסף המקומי דורשת גישה לשורת הפקודה ליצירת קבצים. עבור רוב המשתמשים, שיטת ה-Additional HTML פשוטה ומספיקה.
חלופה: עריכת תבנית פוטר של התבנית
ניתן גם לערוך ישירות את תבנית הפוטר של התבנית שלכם:
- נווטו לתיקיית התבנית שלכם:
theme/YOUR_THEME/ - מצאו את קבצי הlayout (למשל,
layout/columns2.phpאוtemplates/columns2.mustache) - מצאו את תגית הסגירה
</body>או את קטע הפוטר - הוסיפו את קוד ההטמעה של Asyntai ממש לפני
</body> - שמור את הקובץ
- נקו מטמוני Moodle
חשוב: עריכת קבצי תבנית ישירות אומרת שהשינויים עלולים לאבד בעת עדכון התבנית. השתמשו בתבנית ילד או בשיטת Additional HTML לפתרון קבוע יותר.
שלב 3: אמת את ההתקנה
לאחר שמירת השינויים וניקוי המטמונים, בקרו באתר ה-Moodle שלכם בלשונית דפדפן חדשה או בחלון גלישה פרטית. אתם אמורים לראות את כפתור הצ'אט בפינה הימנית התחתונה. לחצו עליו כדי לוודא שהוא נפתח ופועל כראוי.
לא רואה את הווידג'ט? הקפידו לנקות את כל מטמוני Moodle: עברו אל Site administration → Development → Purge all caches. נסו גם לנקות את מטמון הדפדפן או לצפות בחלון גלישה פרטית. אם אתם משתמשים בתוסף מטמון או reverse proxy, נקו גם את המטמונים האלה.
Weebly