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. Log in to your Moodle site as an 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. Replace YOUR_WIDGET_ID with your actual widget ID
  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 ukladu (np. layout/columns2.php lub templates/columns2.mustache)
  3. Znajdź zamykający tag </body> lub sekcję stopki
  4. Dodaj swoj kod osadzania Asyntai tuz przed </body>
  5. Zapisz plik
  6. Wyczyść pamięci podreczne Moodle

Ważne: Bezpośrednia edycja plików motywu oznacza, ze zmiany mogą zostac utracone podczas aktualizacji motywu. Użyj motywu potomnego lub metody Additional HTML jako bardziej trwalego rozwiązania.

Krok 3: Weryfikacja instalacji

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

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