Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Come aggiungere il chatbot IA Asyntai a ExpressionEngine

Guida passo passo per ExpressionEngine CMS

Ottieni il codice di incorporamento

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 layout del template (consigliato)

Il modo più semplice per aggiungere il chatbot a tutte le pagine è modificare il template di layout principale nel pannello di controllo di ExpressionEngine:

  1. Nel pannello di controllo EE, vai su Developer > Templates > Template Groups
  2. Apri il tuo gruppo di template principale (solitamente "site") e modifica il template di layout (o il template che avvolge tutte le pagine)
  3. Trova il tag di chiusura </body>
  4. Incolla il codice di incorporamento Asyntai appena prima del tag </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Salva il template

Suggerimento: Aggiungere lo script prima del tag di chiusura </body> assicura che venga caricato dopo il contenuto della pagina, come consigliato per i widget di chat, senza rallentare il caricamento della pagina.

Metodo alternativo 1: Utilizzo dei Template Partials di EE

I Template Partials di ExpressionEngine ti permettono di creare frammenti riutilizzabili che possono essere inclusi in tutti i template:

  1. Vai su Developer > Templates > Template Partials
  2. Clicca su "New" per creare un nuovo partial chiamato _asyntai_widget
  3. Incolla il codice di incorporamento Asyntai nel contenuto del partial:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Salva il partial
  5. Includilo nel tuo template di layout appena prima del tag di chiusura </body>:
    {embed="_asyntai_widget"} </body>

Nota: L'utilizzo dei Template Partials mantiene il codice organizzato e rende facile aggiornare il codice di incorporamento del chatbot in un unico punto per l'intero sito.

Metodo alternativo 2: Utilizzo dell'header/footer HTML di EE

Alcune configurazioni di ExpressionEngine offrono una sezione footer globale per aggiungere script:

  1. Vai su Settings > Content & Design > Global Template Preferences
  2. Se la tua configurazione EE ha una sezione footer globale, incolla lì il codice di incorporamento Asyntai
  3. Se non è disponibile una sezione footer globale, modifica direttamente il template di layout principale e aggiungi il codice di incorporamento prima del tag di chiusura </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Salva le modifiche

Metodo alternativo 3: Utilizzo di config.php

Per gli utenti avanzati, puoi iniettare lo script del chatbot tramite la configurazione di ExpressionEngine o creando un add-on personalizzato:

  1. Accedi ai file del tuo progetto ExpressionEngine tramite FTP, SSH o il tuo editor di codice
  2. Naviga nella directory system/user/config/ e apri config.php
  3. Per l'iniezione di JavaScript personalizzato, considera la creazione di un semplice add-on/estensione EE che si agganci all'hook template_post_parse per iniettare lo script durante il rendering della pagina:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Sostituisci YOUR_WIDGET_ID con l'ID widget effettivo dalla dashboard

Importante: Il metodo config.php e add-on è destinato agli utenti avanzati che hanno familiarità con lo sviluppo ExpressionEngine. Per la maggior parte degli utenti, si consiglia il metodo del layout del template (Passaggio 2) o il metodo dei Template Partials (Metodo alternativo 1).

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche, visita il tuo sito ExpressionEngine 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. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di aver salvato il template e di star modificando il template di layout corretto utilizzato dalle tue pagine. Svuota la cache del browser o visualizza in una finestra di navigazione in incognito. Se la cache dei template di ExpressionEngine è abilitata, svuota la cache dal pannello di controllo sotto Developer > Utilities > Cache Manager.