Come aggiungere il chatbot IA Asyntai a ExpressionEngine
Guida passo passo per ExpressionEngine CMS
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:
- Nel pannello di controllo EE, vai su Developer > Templates > Template Groups
- Apri il tuo gruppo di template principale (solitamente "site") e modifica il template di layout (o il template che avvolge tutte le pagine)
- Trova il tag di chiusura
</body> - 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> - 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:
- Vai su Developer > Templates > Template Partials
- Clicca su "New" per creare un nuovo partial chiamato
_asyntai_widget - 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> - Salva il partial
- 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:
- Vai su Settings > Content & Design > Global Template Preferences
- Se la tua configurazione EE ha una sezione footer globale, incolla lì il codice di incorporamento Asyntai
- 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> - 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:
- Accedi ai file del tuo progetto ExpressionEngine tramite FTP, SSH o il tuo editor di codice
- Naviga nella directory
system/user/config/e apriconfig.php - Per l'iniezione di JavaScript personalizzato, considera la creazione di un semplice add-on/estensione EE che si agganci all'hook
template_post_parseper 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; } - Sostituisci
YOUR_WIDGET_IDcon 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.
Weebly