Asyntai AI -chatbotin lisääminen Moodleen

Vaiheittainen ohje Moodle LMS -verkkosivustoille

Hae upotuskoodi

Vaihe 1: Hanki upotuskoodisi

Siirry ensin Asyntai-hallintapaneeliin ja vieritä alas "Upotuskoodi"-osioon. Kopioi yksilöllinen upotuskoodisi, joka näyttää tältä:

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

Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.

Vaihe 2: Additional HTML:n käyttö (suositeltu)

Moodlessa on sisäänrakennettu ominaisuus mukautetun HTML/JavaScript-koodin lisäämiseksi kaikille sivuille:

  1. Kirjaudu sisään Moodle-sivustollesi ylläpitäjänä
  2. Siirry kohtaan Site administration
  3. Siirry kohtaan Appearance → Additional HTML
  4. Vieritä alas kohtaan "Before BODY is closed"
  5. Liitä Asyntai-upotuskoodisi tekstialueelle
  6. Napsauta "Save changes"

Vinkki: Koodin lisääminen kohtaan "Before BODY is closed" sijoittaa sen juuri ennen sulkevaa </body>-tagia, mikä on suositeltu sijoitus chat-widgeteille ja varmistaa, että se latautuu pääsisällön jälkeen.

Vaihtoehto: Teema-asetusten käyttö

Monissa Moodle-teemoissa (mukaan lukien Boost ja sen muunnelmat) on omat asetukset mukautetun JavaScriptin lisäämiseksi:

  1. Siirry kohtaan Site administration → Appearance → Themes
  2. Napsauta Theme settings aktiiviselle teemallesi (esim. Boost)
  3. Etsi "Raw SCSS"-, "Additional HTML"- tai "Custom JavaScript" -osio
  4. Jos siellä on JavaScript-kenttä, liitä Asyntai-upotuskoodisi siihen
  5. Napsauta "Save changes"
  6. Tyhjennä välimuistit: Site administration → Development → Purge caches

Huomautus: Teemakohtaiset asetukset vaihtelevat teemoittain. Jos teemassasi ei ole JavaScript-kenttää, käytä yllä olevaa Additional HTML -menetelmää.

Vaihtoehto: Paikallisen lisäosan luominen

Tarkempaa hallintaa varten voit luoda yksinkertaisen paikallisen lisäosan:

  1. Luo kansiorakenne: local/asyntaichatbot/ Moodle-asennukseesi
  2. Luo version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Luo lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Luo kansio amd/src/ ja tiedosto 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. Korvaa YOUR_WIDGET_ID todellisella widget-tunnuksellasi
  6. Siirry kohtaan Site administration → Notifications asentaaksesi lisäosan
  7. Tyhjennä välimuistit asennuksen jälkeen

Tärkeää: Paikallinen lisäosamenetelmä vaatii komentorivin käyttöoikeuden tiedostojen luomiseen. Useimmille käyttäjille Additional HTML -menetelmä on yksinkertaisempi ja riittävä.

Vaihtoehto: Teeman alatunnistemallin muokkaus

Voit myös muokata teemasi alatunnistemallia suoraan:

  1. Siirry teemakansioon: theme/YOUR_THEME/
  2. Etsi layout-tiedostot (esim. layout/columns2.php tai templates/columns2.mustache)
  3. Etsi sulkeva </body>-tagi tai alatunnisteosio
  4. Lisää Asyntai-upotuskoodisi juuri ennen </body>-tagia
  5. Tallenna tiedosto
  6. Tyhjennä Moodlen välimuistit

Tärkeää: Teematiedostojen suora muokkaus tarkoittaa, että muutokset voivat hävitä teemaa päivitettäessä. Käytä lapsiteemaa tai Additional HTML -menetelmää pysyvämpää ratkaisua varten.

Vaihe 3: Vahvista asennus

Kun olet tallentanut muutoksesi ja tyhjäntänyt välimuistit, avaa Moodle-sivustosi uudessa selaimen välilehdessä tai incognito-ikkunassa. Chat-widgetin painikkeen pitäisi näkyä oikeassa alakulmassa. Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein.

Etkö näe widgetiä? Varmista, että tyhjännät kaikki Moodlen välimuistit: siirry kohtaan Site administration → Development → Purge all caches. Kokeile myös tyhjäntää selaimen välimuisti tai katsoa sivua incognito-ikkunassa. Jos käytät välimuistilisäosaa tai käänteistä välityspalvelinta, tyhjennä myös niiden välimuistit.