Nazaj na nadzorno ploščo

Dokumentacija

Naučite se uporabljati Asyntai

Kako dodati klepetalnik Asyntai z UI v Backdrop CMS

Vodič po korakih za spletne strani Backdrop CMS

Pridobite kodo za vgradnjo

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: Dodajte v predlogo teme (priporočeno)

Backdrop CMS uporablja datoteke predlog .tpl.php v svojih temah. Priporočeni pristop je dodajanje vdelovalne kode neposredno v predlogo strani aktivne teme:

  1. Dostopajte do nameščenega Backdrop CMS prek FTP ali Upravljalnika datotek
  2. Pojdite v imenik aktivne teme: themes/yourtheme/
  3. Odprite datoteko page.tpl.php (ali layout.tpl.php glede na vašo temo)
  4. Poiščite zaključno oznako </body> ali vrstico <?php print $page_bottom; ?>
  5. Prilepite svojo vdelovalno kodo Asyntai tik pred to vrstico
  6. Shranite datoteko
<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Nasvet: Umestitev kode tik pred <?php print $page_bottom; ?> ali zaključno oznako </body> zagotavlja, da se klepetalnik naloži po vsebini strani, kar zagotavlja boljše delovanje nalaganja strani. Ta način samodejno doda klepetalnik na vsako stran, ki uporablja to temo.

Alternativni način 1: Uporaba modula po meri

Ustvarite lahko preprost modul Backdrop CMS, ki vstavi skript klepetalnika z uporabo backdrop_add_js():

  1. Ustvarite imenik modula: modules/custom/asyntai_widget/
  2. Ustvarite datoteko modula asyntai_widget.module z naslednjo kodo:
    // modules/custom/asyntai_widget/asyntai_widget.module
    function asyntai_widget_init() {
      backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array(
        'type' => 'external',
        'scope' => 'footer',
        'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'),
      ));
    }
  3. Ustvarite datoteko asyntai_widget.info:
    name = Asyntai AI Chatbot Widget
    description = Adds the Asyntai AI chatbot widget to all pages.
    backdrop = 1.x
    package = Custom
    type = module
  4. Pojdite na Funkcionalnost (admin/modules) v svoji skrbniški plošči Backdrop
  5. Poiščite "Asyntai AI Chatbot Widget" pod paketom Po meri in ga omogočite
  6. Kliknite "Shrani konfiguracijo"

Opomba: Zamenjajte YOUR_WIDGET_ID v kodi modula s svojim dejanskim ID-jem klepetalnika iz Nadzorne plošče Asyntai. Pristop z modulom po meri je varen pri nadgradnjah in ne bo prepisan pri posodabljanju teme.

Alternativni način 2: Uporaba modula "Add to Head" za Backdrop

Prispevani modul "Add to Head" zagotavlja preprost način za vstavljanje skriptov brez urejanja kode:

  1. Prenesite in namestite prispevani modul "Add to Head" s spletne strani Backdrop CMS
  2. Pojdite na Konfiguracija > Razvoj > Add to Head
  3. Dodajte svojo vdelovalno kodo Asyntai v razdelek noge
  4. Kliknite "Shrani konfiguracijo"

Nasvet: Uporaba modula "Add to Head" je najlažji način, če ne želite urejati datotek teme ali ustvarjati modulov po meri. Zagotavlja preprost skrbniški vmesnik za upravljanje vstavljenih skriptov.

Alternativni način 3: Uporaba sistema blokov

Sistem postavitev in blokov Backdrop CMS se lahko uporabi tudi za dodajanje klepetalnika:

  1. Prijavite se v svojo skrbniško ploščo Backdrop CMS
  2. Pojdite na Struktura > Postavitve
  3. Izberite postavitev, ki jo želite urediti (npr. privzeto postavitev)
  4. Kliknite "Dodaj blok" v območju noge
  5. Izberite "Blok po meri"
  6. Nastavite obliko bloka na "Poln HTML" ali "Surov HTML"
  7. Prilepite svojo vdelovalno kodo Asyntai v telo bloka
  8. Dajte bloku naslov (npr. "Klepetalnik Asyntai") in po želji označite "Skrij naslov"
  9. Kliknite "Shrani blok" in nato "Shrani postavitev"

Pomembno: Prepričajte se, da je oblika besedila nastavljena na "Poln HTML" ali "Surov HTML", da oznaka script ni odstranjena. Privzeta oblika "Filtrirani HTML" odstrani oznake script iz varnostnih razlogov.

Korak 3: Počistite predpomnilnik in preverite

Po izvedenih spremembah počistite predpomnilnik Backdrop CMS in preverite namestitev:

  1. Pojdite na Konfiguracija > Zmogljivost v svoji skrbniški plošči
  2. Kliknite "Počisti vse predpomnilnike"
  3. Odprite svoje spletno mesto v novem zavihku brskalnika ali oknu brez beleženja
  4. V spodnjem desnem kotu bi morali videti gumb klepetalnika
  5. Kliknite ga, da preverite, ali se pravilno odpre in deluje

Ne vidite klepetalnika? Prepričajte se, da ste počistili predpomnilnik Backdrop CMS na Konfiguracija > Zmogljivost. Poskusite si ogledati svojo stran v oknu brez beleženja ali počistite predpomnilnik brskalnika. Odprite konzolo brskalnika (F12), da preverite morebitne napake JavaScript. Če ste uporabili način z modulom po meri, preverite, ali je modul omogočen pod Funkcionalnost.