Cum să adăugați chatbot-ul AI Asyntai pe Backdrop CMS

Ghid pas cu pas pentru site-uri Backdrop CMS

Platformă:

Pasul 1: Obțineți codul de încorporare

Mai întâi, accesați Tabloul de bord Asyntai și derulați în jos până la secțiunea "Cod de încorporare". Copiați codul unic de încorporare care va arăta astfel:

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

Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.

Pasul 2: Adăugați în șablonul temei (recomandat)

Backdrop CMS utilizează fișiere de șablon .tpl.php în temele sale. Abordarea recomandată este să adăugați codul de încorporare direct în șablonul de pagină al temei active:

Accesați instalarea Backdrop CMS prin FTP sau Manager de fișiere
Navigați la directorul temei active: themes/yourtheme/
Deschideți fișierul page.tpl.php (sau layout.tpl.php în funcție de tema dvs.)
Găsiți eticheta de închidere </body> sau linia <?php print $page_bottom; ?>
Inserați codul de încorporare Asyntai chiar înainte de acea linie
Salvați fișierul

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

Sfat: Plasarea codului chiar înainte de <?php print $page_bottom; ?> sau eticheta de închidere </body> asigură că chatbotul se încarcă după conținutul paginii, oferind performanță mai bună de încărcare. Această metodă adaugă automat chatbotul pe fiecare pagină care folosește această temă.

Metoda alternativă 1: Utilizarea unui modul personalizat

Puteți crea un modul simplu Backdrop CMS care injectează scriptul chatbotului folosind backdrop_add_js():

Creați directorul modulului: modules/custom/asyntai_widget/
Creați fișierul modulului asyntai_widget.module cu următorul cod:
// 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'), )); }
Creați fișierul 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
Accesați Funcționalitate (admin/modules) în panoul de administrare Backdrop
Găsiți "Asyntai AI Chatbot Widget" sub pachetul Custom și activați-l
Faceți clic pe "Salvare configurație"

Notă: Înlocuiți YOUR_WIDGET_ID din codul modulului cu ID-ul real al widgetului dvs. din Tabloul de bord Asyntai. Abordarea cu modul personalizat este sigură la actualizări și nu va fi suprascrisă la actualizarea temei.

Metoda alternativă 2: Utilizarea modulului "Add to Head" din Backdrop

Modulul contribuit "Add to Head" oferă o modalitate ușoară de a injecta scripturi fără a edita codul:

Descărcați și instalați modulul contribuit "Add to Head" de pe site-ul Backdrop CMS
Accesați Configurare > Dezvoltare > Add to Head
Adăugați codul de încorporare Asyntai în secțiunea footer
Faceți clic pe "Salvare configurație"

Sfat: Utilizarea modulului "Add to Head" este cea mai ușoară metodă dacă preferați să nu editați fișierele de temă sau să creați module personalizate. Oferă o interfață simplă de administrare pentru gestionarea scripturilor injectate.

Metoda alternativă 3: Utilizarea sistemului de blocuri

Sistemul de layout și blocuri al Backdrop CMS poate fi, de asemenea, utilizat pentru a adăuga chatbotul:

Conectați-vă la panoul de administrare Backdrop CMS
Accesați Structură > Layout-uri
Selectați layout-ul pe care doriți să îl editați (de ex., layout-ul implicit)
Faceți clic pe "Adaugă bloc" în regiunea footer
Alegeți "Bloc personalizat"
Setați formatul blocului la "Full HTML" sau "Raw HTML"
Inserați codul de încorporare Asyntai în corpul blocului
Dați blocului un titlu (de ex., "Asyntai Chatbot") și opțional bifați "Ascunde titlul"
Faceți clic pe "Salvare bloc" și apoi pe "Salvare layout"

Important: Asigurați-vă că formatul textului este setat la "Full HTML" sau "Raw HTML" pentru ca eticheta script să nu fie eliminată. Formatul implicit "Filtered HTML" va elimina etichetele script din motive de securitate.

Pasul 3: Goliți memoria cache și verificați

După efectuarea modificărilor, goliți memoria cache a Backdrop CMS și verificați instalarea:

Accesați Configurare > Performanță în panoul de administrare
Faceți clic pe "Golire toate cache-urile"
Deschideți site-ul dvs. într-o filă nouă de browser sau fereastră incognito
Ar trebui să vedeți butonul widgetului de chat în colțul din dreapta jos
Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect

Nu vedeți widgetul? Asigurați-vă că ați golit memoria cache a Backdrop CMS la Configurare > Performanță. Încercați să vizualizați site-ul într-o fereastră incognito sau să goliți memoria cache a browserului. Deschideți consola browserului (F12) pentru a verifica eventualele erori JavaScript. Dacă ați folosit metoda cu modul personalizat, verificați dacă modulul este activat sub Funcționalitate.