Come aggiungere il chatbot IA Asyntai a Concrete CMS

Guida passo passo per i siti web Concrete CMS (precedentemente Concrete5)

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 il codice al footer del tema (consigliato)

Il modo migliore per aggiungere il chatbot a tutte le pagine del tuo sito web Concrete CMS è modificare il file footer del tema:

Accedi alla tua installazione Concrete CMS tramite FTP o File Manager
Vai alla directory /application/themes/your_theme_name/
Trova e apri il file footer.php (o il template footer equivalente)
Trova la riga con il tag di chiusura </body>
Incolla il codice di incorporamento Asyntai appena prima del tag </body>
Salva il file e caricalo di nuovo sul tuo server se lo stai modificando localmente
Svuota la cache di Concrete CMS: Dashboard → System & Settings → Clear Cache

Suggerimento: Aggiungere il codice prima del tag di chiusura </body> assicura che il chatbot venga caricato 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: Blocco HTML (il più semplice per i non sviluppatori)

Se preferisci non modificare i file del tema, puoi utilizzare il blocco HTML integrato di Concrete CMS:

Accedi alla tua Dashboard di Concrete CMS
Vai alla pagina in cui desideri aggiungere il chatbot
Clicca su Edit Page (icona della matita nella barra degli strumenti)
Clicca su Add Block nell'area in cui desideri posizionare il codice
Cerca e seleziona il blocco HTML
Incolla il codice di incorporamento Asyntai nell'editor HTML
Clicca su Add per salvare il blocco
Clicca su Publish per rendere le modifiche attive

Nota: Il metodo del blocco HTML è ottimo per aggiungere il chatbot a pagine specifiche. Per un'installazione su tutto il sito, dovrai aggiungere il blocco HTML a ogni pagina, oppure utilizzare il metodo del footer del tema descritto sopra. La posizione visiva del blocco non influisce su dove appare il chatbot: apparirà comunque nell'angolo in basso a destra.

Metodo alternativo 2: File header del tema

Puoi anche aggiungere il codice al file header del tema per un'installazione su tutto il sito:

Accedi ai file di Concrete CMS tramite FTP o File Manager
Vai su /application/themes/your_theme_name/
Apri il file header.php (o elements/header.php)
Trova il tag di chiusura </head>
Incolla il codice di incorporamento Asyntai appena prima del tag </head>
Salva e carica il file
Svuota la cache dalla Dashboard

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

Suggerimento: Assicurati di includere gli elementi header richiesti utilizzando <?php View::element('header_required'); ?> nel file header.php affinché Concrete CMS funzioni correttamente.

Metodo alternativo 3: Template personalizzato (avanzato)

Per gli sviluppatori che desiderano un maggiore controllo, puoi creare un template di pagina personalizzato:

Crea un nuovo file di template di pagina in /application/themes/your_theme_name/
Oppure copia un template esistente (ad es., default.php) e rinominalo
Aggiungi il codice di incorporamento Asyntai al file del template prima di </body>
Nel Dashboard di Concrete CMS, vai su Pages & Themes
Clicca su Page Types
Seleziona il tipo di pagina con cui desideri utilizzare questo template
Assegna il template personalizzato al tipo di pagina
Tutte le pagine che utilizzano questo tipo di pagina ora includeranno il chatbot

Importante: Effettua sempre un backup dei file del tema prima di apportare modifiche. Testa le tue modifiche su un sito di staging prima, se possibile. Modifiche errate ai file del tema possono compromettere il layout o la funzionalità del sito.

Passaggio 3: verifica l'installazione

Dopo aver apportato le modifiche e svuotato la cache, 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 di chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di aver svuotato la cache di Concrete CMS (Dashboard → System & Settings → Clear Cache). Prova a visualizzare il sito in una finestra di navigazione in incognito. Verifica di aver salvato e caricato tutte le modifiche ai file. Apri la console del browser (F12) per verificare eventuali errori JavaScript.