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

Trin-for-trin-guide til CrafterCMS-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: Tilføj til FreeMarker-skabelon (anbefalet)

CrafterCMS bruger FreeMarker (.ftl)-skabeloner til at rendere sider. Den nemmeste måde at tilføje chatbotten til alle sider er ved at redigere din hovedsideskabelon:

I Crafter Studio skal du gå til Webstedsdashboard > Indholdstyper eller navigere til skabeloner
Åbn din hovedsideskabelon (f.eks. /templates/web/pages/home.ftl eller basislayoutet)
Find det afsluttende </body>-tag
Indsæt din Asyntai-indlejringskode lige før </body>-tagget:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
Gem filen og publicer via Crafter Studio

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.

Alternativ metode 1: Brug af Crafter-skabelonkomponenter

For bedre organisation skal du oprette en dedikeret komponentskabelon til chatbot-widget:

I Crafter Studio skal du oprette en ny skabelonfil ved /templates/web/components/asyntai-widget.ftl
Tilføj følgende indhold til komponentskabelonen:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Inkluder den i din hovedlayoutskabelon ved hjælp af et FreeMarker include-direktiv:
<#include "/templates/web/components/asyntai-widget.ftl" />
Alternativt, hvis du bruger Crafters komponentgengivelsessystem, brug:
<@renderComponent component=contentModel.asyntaiWidget />
Gem begge filer og publicer via Crafter Studio

Bemærk: Brug af en separat komponentskabelon gør det nemt at aktivere eller deaktivere chatbotten på hele dit websted ved at kommentere en enkelt include-linje ud.

Alternativ metode 2: Brug af Crafters Head/Scripts-konfiguration

CrafterCMS giver dig mulighed for at injicere scripts globalt via webstedskonfiguration:

I Crafter Studio skal du navigere til Webstedskonfiguration > Konfiguration
Åbn filen Engine-webstedskonfiguration (site-config.xml)
Tilføj en brugerdefineret scriptinjektionskonfiguration:
<site>   <scripts> <script> <src>https://asyntai.com/static/js/chat-widget.js</src> <async>true</async> <data-asyntai-id>YOUR_WIDGET_ID</data-asyntai-id> </script> </scripts> </site>
Alternativt kan du redigere dit FreeMarker-basislayout for at læse fra webstedskonfiguration og injicere scripts dynamisk:
<#if siteConfig.getString("scripts.script.src", "")?has_content> <script async src="${siteConfig.getString("scripts.script.src")}" data-asyntai-id="${siteConfig.getString("scripts.script.data-asyntai-id")}"></script> </#if>
Gem og publicer konfigurationsændringerne

Tip: Brug af webstedskonfiguration giver dig mulighed for at administrere chatbot-widget uden direkte at ændre skabelonfiler, hvilket gør det nemmere at opdatere eller fjerne senere.

Alternativ metode 3: Brug af Groovy-controller

CrafterCMS understøtter Groovy-scripts til serversidet logik. Du kan bruge en controller til dynamisk at tilføje chatbot-scriptet:

Opret et Groovy-script i /scripts/pages/ (f.eks. /scripts/pages/home.groovy eller din globale controller)
Tilføj følgende kode for at injicere script-URL'en i skabelonmodellen:
// /scripts/pages/home.groovy import org.craftercms.engine.service.context.SiteContext def siteContext = SiteContext.current // Add Asyntai chatbot configuration to the model model.asyntaiEnabled = true model.asyntaiWidgetId = "YOUR_WIDGET_ID" model.asyntaiScriptSrc = "https://asyntai.com/static/js/chat-widget.js"
Referer derefter til modelvariablerne i din FreeMarker-skabelon:
<#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if>
Gem både Groovy-scriptet og skabelonfilen
Publicer ændringerne via Crafter Studio

Bemærk: Groovy-controller-tilgangen er nyttig, når du har brug for betinget logik (f.eks. aktivering af chatbotten kun for bestemte brugerroller eller sidetyper) eller når du ønsker at hente konfigurationsværdier fra eksterne kilder.

Trin 3: Publicer og verificer

Når du har foretaget dine ændringer, skal du publicere dem via Crafter Studio:

I Crafter Studio skal du gå til Webstedsdashboard
Gennemgå dine ændringer i sektionen Min seneste aktivitet eller Afventer godkendelse
Klik på Publicér for at gøre ændringerne live
Besøg dit CrafterCMS-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 publiceret ændringerne via Crafter Studio. Verificer, at du redigerer den korrekte skabelonfil, som dine sider bruger. Ryd din browsercache eller se siden i et inkognitovindue. Hvis du bruger Crafters caching, skal du rydde Engine-cachen fra Crafter Studio-dashboardet.

Skabelonplacering: CrafterCMS-skabelonplaceringer kan variere afhængigt af din projektstruktur. Almindelige placeringer inkluderer /templates/web/pages/ for sideskabeloner, /templates/web/components/ for komponentskabeloner og /templates/web/ for layoutskabeloner. Tjek dine eksisterende skabeloner for at finde, hvor </body>-tagget er defineret.