Natrag na nadzornu ploču

Dokumentacija

Naučite kako koristiti Asyntai

Kako dodati Asyntai AI chatbot na Moodle

Vodič 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: Korištenje dodatnog HTML-a (Preporučeno)

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. Pomaknite se prema dolje do odjeljka \"Before BODY is closed\"
  5. Zalijepite svoj Asyntai ugradni kod u tekstualno područje
  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: Korištenje 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 više kontrole možete 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. Očistite 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 predložak podnožja teme

Također možete izravno urediti predložak podnožja teme:

  1. Idite do mape teme: theme/VAŠA_TEMA/
  2. Pronadite datoteke rasporeda (npr. layout/columns2.php ili templates/columns2.mustache)
  3. Pronađite završnu oznaku </body> ili odjeljak podnožja
  4. Dodajte svoj Asyntai ugradni kod prije oznake </body>
  5. Spremite datoteku
  6. Očistite 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.