Jak přidat Asyntai AI chatbota do Moodle

Podrobný návod pro weby na platformě Moodle LMS

Získat kód pro vložení

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Použití dodatecneho HTML (Doporučeno)

Moodle ma vestavenou funkci pro přidání vlastního HTML/JavaScriptu na všechny stránky:

  1. Přihlaste se na svůj web Moodle jako administrator
  2. Přejděte do Spravy webu
  3. Přejděte na Vzhled → Dodatecne HTML
  4. Rolujte dolu k sekci "Pred uzavrenim BODY"
  5. Vložte váš Asyntai embed kód do textového pole
  6. Klikněte na "Uložit změny"

Tip: Pridanim kódu do "Pred uzavrenim BODY" jej umístíte těsně před uzavírací tag </body>, coz je doporucene umístění pro chatove widgety a zajišťuje načtení až po hlavním obsahu stránky.

Alternativa: Použití nastavení motivu

Mnoho motivu Moodle (včetně Boost a jeho variant) ma vlastní nastavení pro přidání vlastního JavaScriptu:

  1. Přejděte na Správa webu → Vzhled → Motivy
  2. Klikněte na Nastavení motivu pro svůj aktivní motiv (např. Boost)
  3. Hledejte sekci "Raw SCSS", "Dodatecne HTML" nebo "Vlastní JavaScript"
  4. If there's a JavaScript field, paste your Asyntai embed code there
  5. Klikněte na "Uložit změny"
  6. Vymažte mezipaměti: Správa webu → Vyvoj → Vymazat mezipaměti

Poznámka: Nastavení specificka pro motiv se lisi mezi motivy. Pokud váš motiv nema pole pro JavaScript, použijte vyse uvedenou metodu Dodatecne HTML.

Alternativa: Vytvoreni lokalniho pluginu

Pro vetsi kontrolu můžete vytvořit jednoduchy lokalni plugin:

  1. Vytvořte strukturu složek: local/asyntaichatbot/ ve své instalaci Moodle
  2. Vytvořte version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Vytvořte lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Vytvořte slozku amd/src/ a soubor 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 svým skutečným ID widgetu
  6. Přejděte na Správa webu → Oznameni pro instalaci pluginu
  7. Po instalaci vymažte mezipaměti

Důležité: Metoda lokalniho pluginu vyžaduje přístup pres prikazovy řádek pro vytvoření souborů. Pro vetsinu uživatelu je metoda Dodatecne HTML jednodušší a dostatecna.

Alternativa: Úprava šablony zápatí motivu

Můžete také přímo upravit šablonu zápatí svého motivu:

  1. Přejděte do složky svého motivu: theme/YOUR_THEME/
  2. Najděte soubory rozložení (např. layout/columns2.php nebo templates/columns2.mustache)
  3. Najděte uzavírací tag </body> nebo sekci zápatí
  4. Add your Asyntai embed code just before </body>
  5. Uložte soubor
  6. Vymažte mezipaměti Moodle

Důležité: Prima úprava souborů motivu znamena, že změny mohou být při aktualizaci motivu ztraceny. Pro trvalejší řešení použijte podrizeny motiv nebo metodu Dodatecne HTML.

Krok 3: Ověřte instalaci

Po uložení změn a vymazání mezipaměti navštivte svůj web Moodle v nové kartě prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatového widgetu. Klikněte na nej a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Nezapomeňte vymazat všechny mezipaměti Moodle: přejděte na Správa webu → Vyvoj → Vymazat všechny mezipaměti. Zkuste také vymazat mezipaměť prohlížeče nebo stránku zobrazit v anonymním okně. Pokud používáte plugin pro cachovani nebo reverzni proxy, vymažte také tyto mezipaměti.