Natrag na nadzornu ploču

Dokumentacija

Naučite kako koristiti Asyntai

Kako dodati Asyntai AI chatbot na Moodle

Vodic korak po korak za Moodle LMS web stranice

Nabavite kod za ugradnju

Korak 1: Nabavite svoj kod za ugradnju

Prvo idite na svoju Asyntai nadzornu ploču i pomaknite se prema dolje do odjeljka "Kod za ugradnju". Kopirajte svoj jedinstveni kod za ugradnju koji će izgledati ovako:

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

Napomena: Gornji kod je samo primjer. Morate kopirati svoj vlastiti jedinstveni kod za ugradnju sa svoje Nadzorne ploče jer sadrži vaš osobni ID widgeta.

Korak 2: Koristenje dodatnog HTML-a (Preporuceno)

Moodle ima ugradenu znacajku za dodavanje prilagodenog HTML-a/JavaScripta na sve stranice:

  1. Prijavite se na svoj Moodle web kao administrator
  2. Idite na Site administration
  3. Navigirajte do Appearance → Additional HTML
  4. Scroll down to the "Before BODY is closed" section
  5. Zalijepite svoj Asyntai ugradni kod u tekstualno podrucje
  6. Kliknite "Save changes"

Savjet: Dodavanje koda u "Before BODY is closed" smjesta ga neposredno prije zavrsne oznake </body>, sto je preporuceni smjestaj za widgete za razgovor i osigurava ucitavanje nakon glavnog sadrzaja stranice.

Alternativa: Koristenje postavki teme

Mnoge Moodle teme (ukljucujuci Boost i njegove varijante) imaju vlastite postavke za dodavanje prilagodenog JavaScripta:

  1. Idite na Site administration → Appearance → Themes
  2. Kliknite na Theme settings za svoju aktivnu temu (npr. Boost)
  3. Potrazite odjeljak "Raw SCSS", "Additional HTML" ili "Custom JavaScript"
  4. Ako postoji polje za JavaScript, zalijepite svoj Asyntai ugradni kod tamo
  5. Kliknite "Save changes"
  6. Ocistite predmemorije: Site administration → Development → Purge caches

Napomena: Postavke specificne za temu razlikuju se izmedu tema. Ako vasa tema nema polje za JavaScript, koristite gore navedenu metodu dodatnog HTML-a.

Alternativa: Izrada lokalnog dodatka

Za vise kontrole mozete izraditi jednostavan lokalni dodatak:

  1. Izradite strukturu mapa: local/asyntaichatbot/ u svojoj Moodle instalaciji
  2. Izradite version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Izradite lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Izradite mapu amd/src/ i datoteku 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. Zamijenite YOUR_WIDGET_ID svojim stvarnim ID-jem widgeta
  6. Idite na Site administration → Notifications za instalaciju dodatka
  7. Ocistite predmemorije nakon instalacije

Važno: Metoda lokalnog dodatka zahtijeva pristup naredbenom retku za izradu datoteka. Za vecinu korisnika metoda dodatnog HTML-a je jednostavnija i dovoljna.

Alternativa: Uredite predlozak podnozja teme

Takoder mozete izravno urediti predlozak podnozja teme:

  1. Navigirajte do mape teme: theme/VASA_TEMA/
  2. Pronadite datoteke rasporeda (npr. layout/columns2.php ili templates/columns2.mustache)
  3. Pronadite zavrsnu oznaku </body> ili odjeljak podnozja
  4. Add your Asyntai embed code just before </body>
  5. Spremite datoteku
  6. Ocistite Moodle predmemorije

Važno: Izravno uredivanje datoteka teme znaci da se promjene mogu izgubiti prilikom azuriranja teme. Koristite podtemu ili metodu dodatnog HTML-a za trajnije rjesenje.

Korak 3: Provjerite instalaciju

Nakon spremanja promjena i ciscenja predmemorija, posjetite svoju Moodle stranicu u novoj kartici preglednika ili anonimnom prozoru. Trebali biste vidjeti gumb widgeta za razgovor u donjem desnom kutu. Kliknite ga kako biste provjerili otvara li se i radi li ispravno.

Ne vidite widget? Obavezno ocistite sve Moodle predmemorije: idite na Site administration → Development → Purge all caches. Takoder pokusajte ocistiti predmemoriju preglednika ili pregledavati u anonimnom prozoru. Ako koristite dodatak za predmemoriranje ili obrnuti proxy, ocistite i te predmemorije.