Natrag na nadzornu ploču

Dokumentacija

Naučite kako koristiti Asyntai

Kako dodati Asyntai AI chatbot na MODX

Vodič korak po korak za MODX CMS 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: Dodajte u MODX predložak (Preporučeno)

Preporuceni nacin za dodavanje chatbota je izravno uredivanje vaseg MODX predloska u MODX Manageru:

  1. Prijavite se u svoj MODX Manager (administratorski panel)
  2. U lijevoj bočnoj traci idite na Elements > Templates
  3. Otvorite predlozak stranice (obicno nazvan "BaseTemplate" ili vas aktivni predlozak)
  4. Pronađite završnu oznaku </body> u kodu predloška
  5. Zalijepite svoj Asyntai ugradni kod neposredno prije zavrsne oznake </body>
  6. Kliknite "Save" za spremanje predloška
<!-- Your existing template content -->

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

Savjet: Dodavanje koda neposredno prije zavrsne oznake </body> osigurava ucitavanje chatbota nakon svog sadrzaja stranice, sto je preporuceni smjestaj za widgete za razgovor i nece usporiti ucitavanje stranice.

Alternativna metoda 1: Korištenje MODX Chunka

Možete koristiti MODX Chunk za odvajanje i ponovnu upotrebu koda za ugradnju:

  1. U MODX Manageru idite na Elements > Chunks
  2. Kliknite "New Chunk" za izradu novog chunka
  3. Imenujte chunk "asyntaiWidget"
  4. Zalijepite svoj Asyntai ugradni kod u područje sadržaja chunka
  5. Kliknite "Spremi"
  6. Otvorite svoj predložak (pod Elements > Templates)
  7. Dodajte poziv chunka [[$asyntaiWidget]] neposredno prije zavrsne oznake </body>
  8. Spremite predložak
<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Savjet: Koristenje Chunka olaksava upravljanje i azuriranje ugradnog koda na jednom mjestu, posebno ako koristite vise predlozaka na svom webu.

Alternativna metoda 2: Korištenje MODX sistemskih postavki (HTML zaglavlje/podnožje)

Neke MODX instalacije ukljucuju mjesta za skripte podnozja putem sistemskih postavki:

  1. U MODX Manageru idite na System > System Settings
  2. Filtrirajte po "htmlhead" ili potrazite prilagodenu sistemsku postavku za skripte podnozja
  3. Ako vasa instalacija ima mjesto za skripte podnozja (poput [[++footer_scripts]]), mozete ga koristiti
  4. Postavite vrijednost sistemske postavke na svoj Asyntai ugradni kod
  5. Provjerite je li odgovarajuce mjesto [[++footer_scripts]] prisutno u vasem predlosku prije zavrsne oznake </body>
  6. Spremite sistemsku postavku
<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Napomena: Ova metoda ovisi o tome ima li vasa MODX instalacija prilagodenu sistemsku postavku za skripte podnozja. Ako ne postoji, mozete izraditi prilagodenu sistemsku postavku i referencirati je u svom predlosku koristeci sintaksu [[++setting_key]].

Alternativna metoda 3: Korištenje MODX dodatka (OnWebPagePrerender)

Za napredni pristup mozete izraditi MODX dodatak koji automatski ubacuje kod chatbota na svaku stranicu:

  1. U MODX Manageru idite na Elements > Plugins
  2. Kliknite "New Plugin" za izradu novog dodatka
  3. Imenujte dodatak "AsyntaiChatbot"
  4. Zalijepite sljedeći PHP kod u područje koda dodatka:
$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);
  1. Kliknite na karticu "System Events"
  2. Oznacite kucicu pored "OnWebPagePrerender" za pokretanje ovog dodatka na tom dogadaju
  3. Kliknite "Spremi"

Važno: Zamijenite YOUR_WIDGET_ID svojim stvarnim ID-jem widgeta s Asyntai nadzorne ploce. Ovaj dodatak ce automatski ubaciti skriptu chatbota na svaku stranicu vaseg MODX weba prije nego sto se prikazhe.

Korak 3: Očistite predmemoriju i provjerite

Nakon dodavanja ugradnog koda koristeci bilo koju od gore navedenih metoda, morate ocistiti MODX predmemoriju i provjeriti instalaciju:

  1. U MODX Manageru idite na Manage > Clear Cache (ili kliknite ikonu za ciscenje predmemorije u gornjem izborniku)
  2. Otvorite svoju web stranicu u novoj kartici preglednika ili anonimnom prozoru
  3. Trebali biste vidjeti gumb widgeta za razgovor u donjem desnom kutu stranice
  4. Kliknite na njega kako biste provjerili otvara li se i radi li ispravno

Ne vidite widget? Provjerite jeste li ocistili MODX predmemoriju iz Manage > Clear Cache u MODX Manageru. Takoder pokusajte ocistiti predmemoriju preglednika ili pregledavati stranicu u anonimnom prozoru. Ako ste koristili metodu dodatka, potvrdite da je sistemski dogadaj "OnWebPagePrerender" oznacen za vas dodatak.