Sådan tilføjer du Asyntai AI-chatbot til Craft CMS

Trin-for-trin-guide til Craft CMS-websteder

Platform:

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

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

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Rediger din layoutskabelon (anbefalet)

Den nemmeste måde at tilføje chatbotten til alle sider er ved at redigere din hoveddistributionskabelon:

Tilgå dine Craft CMS-projektfiler via FTP, SSH eller din kodeeditor
Naviger til mappen templates/
Find din hoveddistributionsfil (typisk navngivet _layout.twig, _layout.html, eller placeret i templates/_layouts/)
Find det afsluttende </body>-tag
Indsæt din Asyntai indlejringskode lige inden </body>-tagget
Gem filen

Tip: Tilføjelse af scriptet før det afsluttende </body>-tag sikrer, at det indlæses efter sideindholdet, hvilket anbefales til chat-widgets og ikke vil bremse din sideindlæsning.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS leverer et indbygget Twig-tag til registrering af JavaScript:

Åbn din hoveddistributionskabelon
Tilføj følgende kode før det afsluttende </body>-tag:
{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %}
Erstat YOUR_WIDGET_ID med dit faktiske widget-ID
Gem filen

Bemærk: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternativ: Opret en separat include-fil

For bedre organisation skal du oprette en dedikeret include-fil:

Opret en ny fil: templates/_includes/chatbot.twig (eller .html)
Tilføj din Asyntai-indlejringskode til denne fil:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
I din hoveddistributionskabelon skal du inkludere denne fil før </body>:
{% include '_includes/chatbot' %}
Gem begge filer

Tip: Brug af en include-fil gør det nemt at aktivere/deaktivere chatbotten på hele dit websted ved at kommentere en enkelt linje ud.

Alternativ: Betinget indlæsning

For at indlæse chatbotten kun på bestemte sider eller sektioner:

I din layout- eller sideskabelon skal du bruge Twig-betingelser:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Eller tjek for specifikke sektioner:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

Trin 3: Verificér installationen

Efter at have gemt dine ændringer skal du besøge dit Craft CMS-websted i en ny browserfane eller et inkognitovindue. Du bør se chat-widget-knappen i nederste højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for, at du har gemt skabelonfilen, og at du redigerer den korrekte layoutskabelon, som dine sider bruger. Ryd din browsercache eller se siden i et inkognitovindue. Hvis du bruger skabeloncaching, skal du rydde Craft CMS-cachen fra kontrolpanelet under Hjælpeprogrammer > Ryd caches.

Skabelonplacering: Craft CMS-skabelonplaceringer kan variere afhængigt af din projektopsætning. Almindelige placeringer inkluderer templates/_layout.twig, templates/_layouts/main.twig eller templates/_base.twig. Tjek dine eksisterende skabeloner for at finde, hvor </body>-tagget er defineret.