Kako dodati Asyntai AI chatbot na Backdrop CMS

Vodič korak po korak za Backdrop CMS web stranice

Platforma:

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 predložak teme (preporučeno)

Backdrop CMS koristi .tpl.php datoteke predložaka u svojim temama. Preporučeni pristup je dodavanje koda za ugradnju izravno u predložak stranice vaše aktivne teme:

Pristupite svojoj Backdrop CMS instalaciji putem FTP-a ili Upravitelja datoteka
Navigirajte do direktorija vaše aktivne teme: themes/vasatema/
Otvorite datoteku page.tpl.php (ili layout.tpl.php ovisno o vašoj temi)
Pronađite zatvarajuću oznaku </body> ili redak <?php print $page_bottom; ?>
Zalijepite svoj Asyntai kod za ugradnju neposredno prije tog retka
Spremite datoteku

<!-- 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>

Savjet: Postavljanje koda neposredno prije <?php print $page_bottom; ?> ili zatvarajuće oznake </body> osigurava da se chatbot učitava nakon sadržaja stranice, pružajući bolje performanse učitavanja stranice. Ova metoda automatski dodaje chatbot na svaku stranicu koja koristi ovu temu.

Alternativna metoda 1: Korištenje prilagođenog modula

Možete kreirati jednostavan Backdrop CMS modul koji ubacuje skriptu chatbota koristeći backdrop_add_js():

Kreirajte direktorij modula: modules/custom/asyntai_widget/
Kreirajte datoteku modula asyntai_widget.module sa sljedećim kodom:
// 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'), )); }
Kreirajte datoteku 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
Idite na Funkcionalnost (admin/modules) u svom Backdrop administratorskom panelu
Pronađite "Asyntai AI Chatbot Widget" pod paketom Custom i omogućite ga
Kliknite "Spremi konfiguraciju"

Napomena: Zamijenite YOUR_WIDGET_ID u kodu modula sa stvarnim ID-om widgeta sa svoje Asyntai nadzorne ploče. Pristup s prilagođenim modulom siguran je pri nadogradnji i neće biti prebrisan prilikom ažuriranja teme.

Alternativna metoda 2: Korištenje Backdrop modula "Add to Head"

Pridodani modul "Add to Head" pruža jednostavan način ubacivanja skripti bez uređivanja koda:

Preuzmite i instalirajte pridodani modul "Add to Head" s Backdrop CMS web stranice
Idite na Konfiguracija > Razvoj > Add to Head
Dodajte svoj Asyntai kod za ugradnju u odjeljak podnožja
Kliknite "Spremi konfiguraciju"

Savjet: Korištenje modula "Add to Head" najlakša je metoda ako preferirate ne uređivati datoteke teme ili kreirati prilagođene module. Pruža jednostavno administratorsko sučelje za upravljanje ubačenim skriptama.

Alternativna metoda 3: Korištenje sustava blokova

Sustav rasporeda i blokova Backdrop CMS-a također se može koristiti za dodavanje chatbota:

Prijavite se na svoj Backdrop CMS administratorski panel
Idite na Struktura > Rasporedi
Odaberite raspored koji želite urediti (npr. zadani raspored)
Kliknite "Dodaj blok" u regiji podnožja
Odaberite "Prilagođeni blok"
Postavite format bloka na "Puni HTML" ili "Sirovi HTML"
Zalijepite svoj Asyntai kod za ugradnju u tijelo bloka
Dajte bloku naslov (npr. "Asyntai Chatbot") i opcionalno označite "Sakrij naslov"
Kliknite "Spremi blok" i zatim "Spremi raspored"

Važno: Provjerite je li format teksta postavljen na "Puni HTML" ili "Sirovi HTML" kako oznaka skripte ne bi bila uklonjena. Zadani format "Filtrirani HTML" uklonit će oznake skripti iz sigurnosnih razloga.

Korak 3: Očistite predmemoriju i provjerite

Nakon izvršenih promjena, očistite predmemoriju Backdrop CMS-a i provjerite instalaciju:

Idite na Konfiguracija > Performanse u svom administratorskom panelu
Kliknite "Očisti sve predmemorije"
Otvorite svoju web stranicu u novoj kartici preglednika ili anonimnom prozoru
Trebali biste vidjeti gumb chat widgeta u donjem desnom kutu
Kliknite ga kako biste provjerili otvara li se i radi li ispravno

Ne vidite widget? Provjerite jeste li očistili predmemoriju Backdrop CMS-a na Konfiguracija > Performanse. Pokušajte pregledati svoju stranicu u anonimnom prozoru ili očistiti predmemoriju preglednika. Otvorite konzolu preglednika (F12) za provjeru JavaScript grešaka. Ako ste koristili metodu prilagođenog modula, provjerite je li modul omogućen pod Funkcionalnost.