Comment ajouter le chatbot IA Asyntai à ExpressionEngine
Guide étape par étape pour ExpressionEngine CMS
Étape 1 : Obtenir votre code d'intégration
Tout d'abord, rendez-vous sur votre Tableau de bord Asyntai et faites défiler jusqu'à la section « Code d'intégration ». Copiez votre code d'intégration unique qui ressemblera à ceci :
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Note : Le code ci-dessus n'est qu'un exemple. Vous devez copier votre propre code d'intégration depuis votre Tableau de bord car il contient votre identifiant de widget personnel.
Étape 2 : Ajouter à la mise en page du modèle (recommandé)
La façon la plus simple d'ajouter le chatbot à toutes les pages est de modifier votre template de mise en page principal dans le panneau de contrôle ExpressionEngine :
- Dans le panneau de contrôle EE, allez dans Developer > Templates > Template Groups
- Ouvrez votre groupe de modèles principal (généralement « site ») et modifiez le modèle de mise en page (ou le modèle qui englobe toutes les pages)
- Trouvez la balise fermante
</body> - Collez votre code d'intégration Asyntai juste avant la balise
</body>:<!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body> - Enregistrez le modèle
Astuce : L'ajout du script avant la balise fermante </body> garantit qu'il se charge après le contenu de la page, ce qui est recommandé pour les widgets de chat et ne ralentira pas le chargement de votre page.
Méthode alternative 1 : Utilisation des partiels de template EE
Les Template Partials d'ExpressionEngine vous permettent de créer des extraits réutilisables pouvant être inclus dans tous les modèles :
- Allez dans Developer > Templates > Template Partials
- Cliquez sur « New » pour créer un nouveau partial appelé
_asyntai_widget - Collez votre code d'intégration Asyntai dans le contenu du partial :
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Enregistrez le partial
- Incluez-le dans votre template de mise en page juste avant la balise fermante
</body>:{embed="_asyntai_widget"} </body>
Note : L'utilisation de Template Partials garde votre code organisé et facilite la mise à jour du code d'intégration du chatbot en un seul endroit sur l'ensemble de votre site.
Méthode alternative 2 : Utilisation du Header/Footer HTML d'EE
Certaines configurations ExpressionEngine fournissent une section de pied de page globale pour ajouter des scripts :
- Accédez à Paramètres > Contenu & Design > Préférences globales de modèle
- Si votre configuration EE dispose d'une section de pied de page globale, collez-y le code d'intégration Asyntai
- Si aucune section de pied de page globale n'est disponible, modifiez directement votre template de mise en page principal et ajoutez le code d'intégration avant la balise fermante
</body>:<!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body> - Enregistrez vos modifications
Méthode alternative 3 : Utilisation de config.php
Pour les utilisateurs avancés, vous pouvez injecter le script du chatbot via la configuration d'ExpressionEngine ou en créant un module complémentaire personnalisé :
- Accédez aux fichiers de votre projet ExpressionEngine via FTP, SSH ou votre éditeur de code
- Accédez au répertoire
system/user/config/et ouvrezconfig.php - Pour une injection JavaScript personnalisée, envisagez de créer une extension EE simple qui se connecte au hook
template_post_parsepour injecter le script au rendu de la page :// 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; } - Remplacez
YOUR_WIDGET_IDpar votre identifiant de widget réel depuis le tableau de bord
Important : La méthode config.php et add-on est destinée aux utilisateurs avancés à l'aise avec le développement ExpressionEngine. Pour la plupart des utilisateurs, la méthode par mise en page de template (étape 2) ou la méthode par Template Partials (méthode alternative 1) est recommandée.
Étape 3 : Vérifier l'installation
Après avoir enregistré vos modifications, visitez votre site ExpressionEngine dans un nouvel onglet de navigateur ou en navigation privée. Vous devriez voir le bouton du widget de chat dans le coin inférieur droit. Cliquez dessus pour vérifier qu'il s'ouvre et fonctionne correctement.
Vous ne voyez pas le widget ? Assurez-vous d'avoir enregistré le modèle et de modifier le bon modèle de mise en page utilisé par vos pages. Videz le cache de votre navigateur ou consultez le site dans une fenêtre de navigation privée. Si la mise en cache des modèles ExpressionEngine est activée, videz le cache depuis le panneau de contrôle sous Developer > Utilities > Cache Manager.
Weebly