חזרה ללוח הבקרה

תיעוד

למד כיצד להשתמש ב-Asyntai

כיצד להוסיף צ'אטבוט 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 מותאם אישית לכל הדפים:

  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 שלמעלה.

חלופה: יצירת תוסף מקומי

לשליטה רבה יותר, ניתן ליצור תוסף מקומי פשוט:

  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 במזהה הווידג'ט האמיתי שלך
  6. עברו אל Site administration → Notifications כדי להתקין את התוסף
  7. נקו מטמונים לאחר ההתקנה

חשוב: שיטת התוסף המקומי דורשת גישה לשורת הפקודה ליצירת קבצים. עבור רוב המשתמשים, שיטת ה-Additional HTML פשוטה ומספיקה.

חלופה: עריכת תבנית פוטר של התבנית

ניתן גם לערוך ישירות את תבנית הפוטר של התבנית שלכם:

  1. נווטו לתיקיית התבנית שלכם: theme/YOUR_THEME/
  2. מצאו את קבצי הlayout (למשל, layout/columns2.php או templates/columns2.mustache)
  3. מצאו את תגית הסגירה </body> או את קטע הפוטר
  4. הוסיפו את קוד ההטמעה של Asyntai ממש לפני </body>
  5. שמור את הקובץ
  6. נקו מטמוני Moodle

חשוב: עריכת קבצי תבנית ישירות אומרת שהשינויים עלולים לאבד בעת עדכון התבנית. השתמשו בתבנית ילד או בשיטת Additional HTML לפתרון קבוע יותר.

שלב 3: אמת את ההתקנה

לאחר שמירת השינויים וניקוי המטמונים, בקרו באתר ה-Moodle שלכם בלשונית דפדפן חדשה או בחלון גלישה פרטית. אתם אמורים לראות את כפתור הצ'אט בפינה הימנית התחתונה. לחצו עליו כדי לוודא שהוא נפתח ופועל כראוי.

לא רואה את הווידג'ט? הקפידו לנקות את כל מטמוני Moodle: עברו אל Site administration → Development → Purge all caches. נסו גם לנקות את מטמון הדפדפן או לצפות בחלון גלישה פרטית. אם אתם משתמשים בתוסף מטמון או reverse proxy, נקו גם את המטמונים האלה.