Hoe voegt u de Asyntai AI-chatbot toe aan ExpressionEngine

Stapsgewijze handleiding voor ExpressionEngine CMS

Insluitcode ophalen

Stap 1: Uw insluitcode ophalen

Ga eerst naar uw Asyntai Dashboard en scroll naar het gedeelte "Insluitcode". Kopieer uw unieke insluitcode die er als volgt uitziet:

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

Opmerking: De bovenstaande code is slechts een voorbeeld. U moet uw eigen unieke insluitcode kopiëren vanuit uw Dashboard omdat deze uw persoonlijke widget-ID bevat.

Stap 2: Toevoegen aan sjabloonlay-out (aanbevolen)

De eenvoudigste manier om de chatbot aan alle pagina's toe te voegen is door uw hoofdlay-outsjabloon te bewerken in het ExpressionEngine-configuratiescherm:

  1. Ga in het EE-configuratiescherm naar Developer > Templates > Template Groups
  2. Open uw hoofdsjabloongroep (meestal "site") en bewerk het lay-outsjabloon (of het sjabloon dat alle pagina's omhult)
  3. Zoek de afsluitende </body>-tag
  4. Plak uw Asyntai-insluitcode net vóór de </body>-tag:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Sla het sjabloon op

Tip: Het toevoegen van het script vóór de afsluitende </body>-tag zorgt ervoor dat het na de pagina-inhoud wordt geladen, wat aanbevolen is voor chatwidgets en het laden van uw pagina niet vertraagt.

Alternatieve methode 1: EE Template Partials gebruiken

ExpressionEngine Template Partials stellen u in staat herbruikbare fragmenten te maken die in sjablonen kunnen worden opgenomen:

  1. Ga naar Ontwikkelaar > Sjablonen > Sjabloon-partials
  2. Klik op "New" om een nieuw partieel te maken met de naam _asyntai_widget
  3. Plak uw Asyntai-insluitcode in de partial-inhoud:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Sla de partial op
  5. Neem het op in uw lay-outsjabloon net vóór de sluitende </body>-tag:
    {embed="_asyntai_widget"} </body>

Opmerking: Het gebruik van Template Partials houdt uw code georganiseerd en maakt het eenvoudig om de chatbot-insluitcode op één plek voor uw hele site bij te werken.

Alternatieve methode 2: EE's HTML Header/Footer gebruiken

Sommige ExpressionEngine-configuraties bieden een globale footersectie voor het toevoegen van scripts:

  1. Ga naar Settings > Content & Design > Global Template Preferences
  2. Als uw EE-configuratie een globale footersectie heeft, plak de Asyntai-insluitcode daar
  3. Als er geen globale footersectie beschikbaar is, bewerk dan uw hoofdlay-outsjabloon rechtstreeks en voeg de insluitcode toe vóór de sluitende </body>-tag:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Sla uw wijzigingen op

Alternatieve methode 3: config.php gebruiken

Voor gevorderde gebruikers kunt u het chatbotscript injecteren via de configuratie van ExpressionEngine of door een aangepaste add-on te maken:

  1. Ga naar uw ExpressionEngine-projectbestanden via FTP, SSH of uw code-editor
  2. Navigeer naar de map system/user/config/ en open config.php
  3. Voor aangepaste JavaScript-injectie kunt u overwegen een eenvoudige EE-add-on/extensie te maken die inhaakt op de template_post_parse-hook om het script bij het renderen van de pagina te injecteren:
    // 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. Vervang YOUR_WIDGET_ID door uw daadwerkelijke widget-ID uit het dashboard

Belangrijk: De config.php- en add-on-methode is bedoeld voor gevorderde gebruikers die vertrouwd zijn met ExpressionEngine-ontwikkeling. Voor de meeste gebruikers wordt de sjabloonlay-outmethode (stap 2) of de Template Partials-methode (alternatieve methode 1) aanbevolen.

Stap 3: Installatie verifiëren

Nadat u uw wijzigingen hebt opgeslagen, bezoekt u uw ExpressionEngine-website in een nieuw browsertabblad of incognitovenster. U zou de chatwidgetknop in de rechteronderhoek moeten zien. Klik erop om te controleren of deze correct opent en werkt.

Ziet u de widget niet? Zorg ervoor dat u het sjabloon hebt opgeslagen en dat u het juiste lay-outsjabloon bewerkt dat uw pagina's gebruiken. Wis uw browsercache of bekijk in een incognitovenster. Als ExpressionEngine-sjablooncaching is ingeschakeld, wis dan de cache vanuit het configuratiescherm onder Developer > Utilities > Cache Manager.