Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Jak dodać chatbota AI Asyntai do Moodle

Przewodnik krok po kroku dla witryn Moodle LMS

Pobierz kod osadzania

Krok 1: Pobierz swój kod osadzania

Najpierw przejdź do swojego Panelu Asyntai i przewiń w dół do sekcji "Kod osadzania". Skopiuj swój unikalny kod osadzania, który będzie wyglądał tak:

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

Uwaga: Powyższy kod to tylko przykład. Musisz skopiować swój własny unikalny kod osadzania z Panelu, ponieważ zawiera on Twój osobisty identyfikator widgetu.

Krok 2: Użycie dodatkowego kodu HTML (zalecane)

Moodle posiada wbudowana funkcje dodawania niestandardowego kodu HTML/JavaScript do wszystkich stron:

  1. Zaloguj się do swojej witryny Moodle jako administrator
  2. Przejdź do Site administration
  3. Przejdź do Appearance → Additional HTML
  4. Przewin w dol do sekcji "Before BODY is closed"
  5. Wklej kod osadzania Asyntai w polu tekstowym
  6. Kliknij "Save changes"

Wskazówka: Dodanie kodu w sekcji "Before BODY is closed" umieszcza go tuz przed zamykającym tagiem </body>, co jest zalecanym umiejscowieniem dla widgetów czatu i zapewnia ładowanie po głównej zawartości strony.

Alternatywa: Użycie ustawień motywu

Wiele motywów Moodle (w tym Boost i jego warianty) ma własne ustawienia do dodawania niestandardowego kodu JavaScript:

  1. Przejdź do Site administration → Appearance → Themes
  2. Kliknij Theme settings dla aktywnego motywu (np. Boost)
  3. Poszukaj sekcji "Raw SCSS", "Additional HTML" lub "Custom JavaScript"
  4. Jeśli istnieje pole JavaScript, wklej tam swoj kod osadzania Asyntai
  5. Kliknij "Save changes"
  6. Wyczyść pamięci podreczne: Site administration → Development → Purge caches

Uwaga: Ustawienia specyficzne dla motywu roznia sie między motywami. Jeśli Twój motyw nie ma pola JavaScript, użyj powyzszej metody Additional HTML.

Alternatywa: Tworzenie lokalnej wtyczki

Aby uzyskać większą kontrolę, możesz utworzyć prosta lokalna wtyczkę:

  1. Utwórz strukture folderow: local/asyntaichatbot/ w swojej instalacji Moodle
  2. Utwórz version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Utwórz lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Utwórz folder amd/src/ i plik 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. Zamień YOUR_WIDGET_ID na rzeczywisty identyfikator widgetu
  6. Przejdź do Site administration → Notifications, aby zainstalować wtyczkę
  7. Wyczyść pamięci podreczne po instalacji

Ważne: Metoda lokalnej wtyczki wymaga dostępu do wiersza polecen w celu tworzenia plików. Dla większości użytkowników metoda Additional HTML jest prostsza i wystarczajaca.

Alternatywa: Edycja szablonu stopki motywu

Możesz również edytować szablon stopki motywu bezpośrednio:

  1. Przejdź do folderu motywu: theme/YOUR_THEME/
  2. Znajdź pliki layout (np. layout/columns2.php lub templates/columns2.mustache)
  3. Znajdź zamykający tag </body> lub sekcję stopki
  4. Dodaj swój kod osadzania Asyntai tuż przed </body>
  5. Zapisz plik
  6. Wyczyść pamięci podręczne Moodle

Ważne: Bezpośrednia edycja plików motywu oznacza, że zmiany mogą zostać utracone podczas aktualizacji motywu. Użyj motywu potomnego lub metody Additional HTML jako bardziej trwałego rozwiązania.

Krok 3: Weryfikacja instalacji

Po zapisaniu zmian i wyczyszczeniu pamięci podręcznych odwiedź swoją witrynę Moodle w nowej karcie przeglądarki lub w oknie incognito. Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu. Kliknij go, aby upewnić się, że otwiera się i działa poprawnie.

Nie widzisz widgetu? Upewnij się, że wyczyściłeś wszystkie pamięci podręczne Moodle: przejdź do Site administration → Development → Purge all caches. Spróbuj również wyczyścić pamięć podręczną przeglądarki lub wyświetlić stronę w oknie incognito. Jeśli używasz wtyczki buforującej lub odwrotnego serwera proxy, wyczyść również te pamięci podręczne.