Nazaj na nadzorno ploščo

Dokumentacija

Naučite se uporabljati Asyntai

Kako dodati klepetalnik Asyntai AI v Moodle

Vodič po korakih za spletna mesta Moodle LMS

Pridobite kodo za vdelavo

Korak 1: Pridobite svojo vdelovalno kodo

Najprej pojdite na svojo Nadzorno ploščo Asyntai in se pomaknite navzdol do razdelka "Vdelovalna koda". Kopirajte svojo edinstveno vdelovalno kodo, ki bo videti takole:

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

Opomba: Zgornja koda je le primer. Svojo edinstveno vdelovalno kodo morate kopirati iz svoje Nadzorne plošče, saj vsebuje vaš osebni ID klepetalnika.

Korak 2: Uporaba dodatnega HTML (priporočeno)

Moodle ima vgrajeno funkcijo za dodajanje HTML/JavaScript po meri na vse strani:

  1. Prijavite se na svoje spletno mesto Moodle kot skrbnik
  2. Pojdite na Skrbništvo spletnega mesta
  3. Pojdite na Videz → Dodaten HTML
  4. Pomaknite se navzdol do razdelka "Pred zaprtjem BODY"
  5. Prilepite svojo vdelovalno kodo Asyntai v besedilno polje
  6. Kliknite "Shrani spremembe"

Nasvet: Dodajanje kode v "Pred zaprtjem BODY" jo umesti tik pred zaključno oznako </body>, kar je priporočena umestitev za pripomocke za klepet in zagotavlja, da se naloži po glavni vsebini strani.

Alternativa: Uporaba nastavitev teme

Številne teme Moodle (vključno z Boost in njenimi različicami) imajo lastne nastavitve za dodajanje JavaScript po meri:

  1. Pojdite na Skrbništvo spletnega mesta → Videz → Teme
  2. Kliknite na Nastavitve teme za svojo aktivno temo (npr. Boost)
  3. Poišcite razdelek "Surov SCSS", "Dodaten HTML" ali "JavaScript po meri"
  4. Če obstaja polje za JavaScript, tja prilepite svojo vdelano kodo Asyntai
  5. Kliknite "Shrani spremembe"
  6. Počistite predpomnilnike: Skrbništvo spletnega mesta → Razvoj → Počisti predpomnilnike

Opomba: Nastavitve, specifične za temo, se razlikujejo med temami. Če vaša tema nima polja za JavaScript, uporabite zgornji način z dodatnim HTML.

Alternativa: Ustvarjanje lokalnega vtičnika

Za več nadzora lahko ustvarite preprost lokalni vtičnik:

  1. Ustvarite strukturo map: local/asyntaichatbot/ v svoji namestitvi Moodle
  2. Ustvarite version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Ustvarite lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Ustvarite mapo amd/src/ in datoteko 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. Replace YOUR_WIDGET_ID with your actual widget ID
  6. Pojdite na Skrbništvo spletnega mesta → Obvestila za namestitev vtičnika
  7. Počistite predpomnilnike po namestitvi

Pomembno: Način z lokalnim vtičnikom zahteva dostop do ukazne vrstice za ustvarjanje datotek. Za večino uporabnikov je način z dodatnim HTML preprostejši in zadosten.

Alternativa: Uredite predlogo noge teme

Neposredno lahko uredite tudi predlogo noge svoje teme:

  1. Pojdite v mapo svoje teme: theme/YOUR_THEME/
  2. Poišcite datoteke postavitve (npr. layout/columns2.php ali templates/columns2.mustache)
  3. Poišcite zaključno oznako </body> ali razdelek noge
  4. Dodajte svojo vdelano kodo Asyntai tik pred </body>
  5. Shranite datoteko
  6. Počistite predpomnilnike Moodle

Pomembno: Neposredno urejanje datotek teme pomeni, da se spremembe lahko izgubijo ob posodobitvi teme. Uporabite podtemo ali način z dodatnim HTML za bolj trajno rešitev.

Korak 3: Preverite namestitev

Po shranjevanju sprememb in cišcenju predpomnilnikov obiščite svoje spletno mesto Moodle v novem zavihku brskalnika ali oknu brez beleženja. V spodnjem desnem kotu bi morali videti gumb pripomocka za klepet. Kliknite nanj, da se prepričajte, da se odpre in pravilno deluje.

Ne vidite klepetalnika? Počistite vse predpomnilnike Moodle: pojdite na Skrbništvo spletnega mesta → Razvoj → Počisti vse predpomnilnike. Poskusite tudi pocistiti predpomnilnik brskalnika ali stran ogledati v oknu brez beleženja. Če uporabljate vtičnik za predpomnjenje ali obratni posrednik, počistite tudi te predpomnilnike.