Späť na panel

Dokumentácia

Naučte sa používať Asyntai

Ako pridať Asyntai AI Chatbot do Moodle

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

Získať vkladací kód

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

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

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné 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 Správa stránky
  3. Prejdite na Appearance → Additional HTML
  4. Prejdite nadol do sekcie "Before BODY is closed"
  5. Vložte svoj vkladací kód 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. Nahraďte YOUR_WIDGET_ID vaším skutočným 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.

Nevidíte 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.