Come aggiungere il chatbot IA Asyntai a Backdrop CMS

Guida passo passo per siti web Backdrop CMS

Piattaforma:

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

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

Nota: Il codice sopra è solo un esempio. Devi copiare il tuo codice di incorporamento univoco dalla tua Dashboard poiché contiene il tuo ID widget personale.

Passaggio 2: aggiungi al template del tema (consigliato)

Backdrop CMS utilizza file template .tpl.php nei suoi temi. L'approccio consigliato è aggiungere il codice di incorporamento direttamente al template della pagina del tema attivo:

Accedi alla tua installazione Backdrop CMS tramite FTP o Gestione file
Naviga alla directory del tuo tema attivo: themes/yourtheme/
Apri il file page.tpl.php (o layout.tpl.php a seconda del tuo tema)
Trova il tag di chiusura </body> o la riga <?php print $page_bottom; ?>
Incolla il tuo codice di incorporamento Asyntai appena prima di quella riga
Salva il file

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

Suggerimento: Inserire il codice appena prima di <?php print $page_bottom; ?> o del tag di chiusura </body> garantisce che il chatbot si carichi dopo il contenuto della pagina, offrendo migliori prestazioni di caricamento. Questo metodo aggiunge automaticamente il chatbot a ogni pagina che utilizza questo tema.

Metodo alternativo 1: utilizzo di un modulo personalizzato

Puoi creare un semplice modulo Backdrop CMS che inietta lo script del chatbot utilizzando backdrop_add_js():

Crea la directory del modulo: modules/custom/asyntai_widget/
Crea il file del modulo asyntai_widget.module con il seguente codice:
// 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 il file 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
Vai a Funzionalità (admin/modules) nel pannello di amministrazione Backdrop
Trova "Asyntai AI Chatbot Widget" nel pacchetto Custom e abilitalo
Fai clic su "Salva configurazione"

Nota: Sostituisci YOUR_WIDGET_ID nel codice del modulo con il tuo ID widget effettivo dalla Dashboard Asyntai. L'approccio con modulo personalizzato è sicuro per gli aggiornamenti e non verrà sovrascritto quando aggiorni il tema.

Metodo alternativo 2: utilizzo del modulo "Add to Head" di Backdrop

Il modulo contribuito "Add to Head" fornisce un modo semplice per iniettare script senza modificare il codice:

Scarica e installa il modulo contribuito "Add to Head" dal sito web Backdrop CMS
Vai a Configurazione > Sviluppo > Add to Head
Aggiungi il tuo codice di incorporamento Asyntai nella footer section
Fai clic su "Salva configurazione"

Suggerimento: Utilizzare il modulo "Add to Head" è il metodo più semplice se preferisci non modificare i file del tema o creare moduli personalizzati. Fornisce un'interfaccia di amministrazione semplice per gestire gli script iniettati.

Metodo alternativo 3: utilizzo del sistema blocchi

Il sistema di layout e blocchi di Backdrop CMS può essere utilizzato anche per aggiungere il chatbot:

Accedi al tuo pannello di amministrazione Backdrop CMS
Vai a Struttura > Layout
Seleziona il layout che vuoi modificare (ad es. il layout predefinito)
Fai clic su "Aggiungi blocco" nella regione footer
Scegli "Blocco personalizzato"
Imposta il formato del blocco su "Full HTML" o "Raw HTML"
Incolla il tuo codice di incorporamento Asyntai nel corpo del blocco
Dai un titolo al blocco (ad es. "Asyntai Chatbot") e facoltativamente seleziona "Nascondi titolo"
Fai clic su "Salva blocco" e poi su "Salva layout"

Importante: Assicurati che il formato del testo sia impostato su "Full HTML" o "Raw HTML" in modo che il tag script non venga rimosso. Il formato predefinito "Filtered HTML" rimuoverà i tag script per motivi di sicurezza.

Passaggio 3: Svuota la cache e verifica

Dopo aver apportato le modifiche, svuota la cache di Backdrop CMS e verifica l'installazione:

Vai su Configuration > Performance nel pannello di amministrazione
Clicca su "Clear all caches"
Apri il tuo sito web in una nuova scheda del browser o in una finestra di navigazione in incognito
Dovresti vedere il pulsante del widget chat nell'angolo in basso a destra della tua pagina
Cliccaci sopra per assicurarti che si apra e funzioni correttamente

Non vedi il widget? Assicurati di aver svuotato la cache di Backdrop CMS in Configuration > Performance. Prova a visualizzare il tuo sito in una finestra di navigazione in incognito o svuota la cache del browser. Apri la console del browser (F12) per verificare eventuali errori JavaScript. Se hai utilizzato il metodo del modulo personalizzato, verifica che il modulo sia abilitato in Functionality.