Ako pridať Asyntai AI Chatbot do Moodle

Podrobný návod pre webové stránky Moodle LMS

Získať vkladací kód

Krok 1: Ziskajte svoj vkladací kod

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii "Vkladaci kod". Skopirujte svoj jedinečný vkladací kod, ktory bude vyzerat takto:

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

Poznámka: Kod vyššie je len priklad. Musite skopirovat svoj vlastný jedinečný vkladací kod zo svojho Dashboardu, pretože obsahuje vase osobne ID widgetu.

Krok 2: Pomocou Additional HTML (Odporúčané)

Moodle má vstavanú funkciu na pridanie vlastného HTML/JavaScript na všetky stránky:

  1. Prihláste sa na svoj web Moodle ako administrátor
  2. Prejdite na Site administration
  3. Prejdite na Appearance → Additional HTML
  4. Prejdite nadol do sekcie "Before BODY is closed"
  5. Vložíte svoj vkladací kod Asyntai do textovej oblasti
  6. Kliknite na "Save changes"

Tip: Pridanie kódu do "Before BODY is closed" ho umiestni tesne pred uzatváraciu značku </body>, čo je odporúčané umiestnenie pre chatové widgety a zabezpečuje, že sa načíta po hlavnom obsahu stránky.

Alternatíva: Pomocou nastavení témy

Mnohé témy Moodle (vrátane Boost a jeho variantov) majú vlastné nastavenia na pridanie vlastného JavaScript:

  1. Prejdite na Site administration → Appearance → Themes
  2. Kliknite na Theme settings pre vašu aktívnu tému (napr. Boost)
  3. Hľadajte sekciu "Raw SCSS", "Additional HTML" alebo "Custom JavaScript"
  4. Ak je tam pole pre JavaScript, vložte tam svoj vkladací kód Asyntai
  5. Kliknite na "Save changes"
  6. Vyčistite vyrovnávacie pamäte: Site administration → Development → Purge caches

Poznámka: Nastavenia špecifické pre tému sa líšia medzi témami. Ak vaša téma nemá pole pre JavaScript, použite metódu Additional HTML uvedenú vyššie.

Alternatíva: Vytvorenie lokálneho pluginu

Pre väčšiu kontrolu môžete vytvoriť jednoduchý lokálny plugin:

  1. Vytvorte štruktúru priečinkov: local/asyntaichatbot/ vo vašej inštalácii Moodle
  2. Vytvorte version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Vytvorte lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Vytvorte priečinok amd/src/ a súbor 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. Nahradte YOUR_WIDGET_ID vasim skutocnym ID widgetu
  6. Prejdite na Site administration → Notifications pre inštaláciu pluginu
  7. Vyčistite vyrovnávacie pamäte po inštalácii

Dôležité: Metóda lokálneho pluginu vyžaduje prístup cez príkazový riadok na vytváranie súborov. Pre väčšinu používateľov je metóda Additional HTML jednoduchšia a postačujúca.

Alternatíva: Úprava šablóny pätičky témy

Môžete tiež priamo upraviť šablónu pätičky vašej témy:

  1. Prejdite do priečinka vašej témy: theme/YOUR_THEME/
  2. Nájdite súbory rozloženia (napr. layout/columns2.php alebo templates/columns2.mustache)
  3. Nájdite uzatváraciu značku </body> alebo sekciu pätičky
  4. Pridajte svoj vkladací kód Asyntai tesne pred </body>
  5. Uložte súbor
  6. Vyčistite vyrovnávacie pamäte Moodle

Dôležité: Priama úprava súborov témy znamená, že zmeny sa môžu stratiť pri aktualizácii témy. Použite podradenú tému alebo metódu Additional HTML pre trvalejšie riešenie.

Krok 3: Overenie inštalácie

Po uložení zmien a vyčistení vyrovnávacích pamätí navštívte svoj web Moodle v novej záložke prehliadača alebo v okne inkognito. V pravom dolnom rohu by ste mali vidieť tlačidlo chatového widgetu. Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne.

Nevidite widget? Uistite sa, že ste vyčistili všetky vyrovnávacie pamäte Moodle: prejdite na Site administration → Development → Purge all caches. Tiež skúste vymazať vyrovnávaciu pamäť prehliadača alebo zobraziť stránku v okne inkognito. Ak používate doplnok pre vyrovnávaciu pamäť alebo reverzný proxy, vyčistite aj tie.