Slik legger du til Asyntai AI-chatbot i Craft CMS

Trinn-for-trinn-guide for Craft CMS-nettsteder

Plattform:

Trinn 1: Hent innbyggingskoden din

Gå først til Asyntai-dashbordet ditt og bla ned til «Innbyggingskode»-seksjonen. Kopier din unike innbyggingskode som vil se slik ut:

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

Merk: Koden ovenfor er bare et eksempel. Du må kopiere din egen unike innbyggingskode fra Dashbordet ditt, da den inneholder din personlige widget-ID.

Trinn 2: Rediger layoutmalen din (anbefalt)

Den enkleste måten å legge til chatboten på alle sider er ved å redigere hovedlayoutmalen din:

Access your Craft CMS project files via FTP, SSH, or your code editor
Naviger til templates/-mappen
Finn hovedlayoutfilen din (vanligvis kalt _layout.twig, _layout.html, eller plassert i templates/_layouts/)
Finn den avsluttende </body>-taggen
Lim inn Asyntai-innbyggingskoden din rett før </body>-taggen
Lagre filen

Tips: Ved å legge til skriptet før den avsluttende </body>-taggen sikrer du at det lastes etter sideinnholdet, noe som anbefales for chatwidgeter og ikke vil bremse sidelastingen.

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

Craft CMS har en innebygd Twig-tag for registrering av JavaScript:

Åpne hovedlayoutmalen din
Legg til følgende kode før den avsluttende </body>-taggen:
{% 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 %}
Erstatt YOUR_WIDGET_ID med din faktiske widget-ID
Lagre filen

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

Alternativ: Opprett en separat inkluderingsfil

For bedre organisering, opprett en dedikert inkluderingsfil:

Opprett en ny fil: templates/_includes/chatbot.twig (eller .html)
Legg til Asyntai-innbyggingskoden i denne filen:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
I hovedlayoutmalen din, inkluder denne filen før </body>:
{% include '_includes/chatbot' %}
Lagre begge filene

Tips: Bruk av en inkluderingsfil gjør det enkelt å aktivere/deaktivere chatboten på hele nettstedet ved å kommentere ut en enkelt linje.

Alternativ: Betinget lasting

For å laste chatboten kun på bestemte sider eller seksjoner:

I layout- eller sidemalen din, bruk 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 sjekk for bestemte seksjoner:
{% 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 %}

Trinn 3: Bekreft installasjonen

Etter at du har lagret endringene dine, besøk Craft CMS-nettstedet i en ny nettleserfane eller et inkognitovindu. Du bør se chatwidget-knappen i nedre høyre hjørne. Klikk på den for å sjekke at den åpnes og fungerer riktig.

Ser du ikke widgeten? Sørg for at du har lagret malfilen og at du redigerer riktig layoutmal som sidene dine bruker. Tøm nettleserens hurtigbuffer eller se i et inkognitovindu. Hvis du bruker malbufring, tøm Craft CMS-bufferen fra kontrollpanelet under Utilities > Clear Caches.

Malplassering: Plasseringen av Craft CMS-maler kan variere avhengig av prosjektoppsettet ditt. Vanlige plasseringer inkluderer templates/_layout.twig, templates/_layouts/main.twig eller templates/_base.twig. Sjekk eksisterende maler for å finne hvor </body>-taggen er definert.