Kā pievienot Asyntai MI tērzēšanas robotu CrafterCMS

Soli pa solim ceļvedis CrafterCMS tīmekļa vietnēm

Platforma:

1. solis: Iegūstiet savu iegulto kodu

Vispirms dodieties uz savu Asyntai vadības paneli un ritiniet uz leju līdz sadaļai "Iegultais kods". Nokopējiet savu unikālo iegulto kodu, kas izskatīsies šādi:

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

Piezīme: Iepriekš minētais kods ir tikai piemērs. Jums jānokopē savs unikālais iegultais kods no sava Vadības paneļa, jo tas satur jūsu personīgo logrīka ID.

2. solis: Pievienojiet FreeMarker veidnei (ieteicams)

CrafterCMS izmanto FreeMarker (.ftl) veidnes lapu renderēšanai. Vienkāršākais veids, kā pievienot tērzēšanas robotu visām lapām, ir rediģēt galveno lapas veidni:

Crafter Studio dodieties uz Vietnes vadības panelis > Satura tipi vai pārejiet uz veidnēm
Atveriet savu galveno lapas veidni (piemēram, /templates/web/pages/home.ftl vai bāzes izkārtojumu)
Atrodiet noslēdzošo </body> tagu
Ielīmējiet savu Asyntai iegulto kodu tieši pirms </body> taga:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
Saglabājiet failu un publicējiet caur Crafter Studio

Padoms: Skripta pievienošana pirms noslēdzošā </body> taga nodrošina, ka tas ielādējas pēc lapas satura, kas ir ieteicams tērzēšanas logrīkiem un nepalēninās jūsu lapas ielādi.

Alternatīvā metode 1: Crafter veidņu komponentu izmantošana

Labākai organizācijai izveidojiet speciālu komponenta veidni tērzēšanas robota logrīkam:

Crafter Studio izveidojiet jaunu veidnes failu /templates/web/components/asyntai-widget.ftl
Pievienojiet šādu saturu komponenta veidnei:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Iekļaujiet to savā galvenajā izkārtojuma veidnē, izmantojot FreeMarker iekļaušanas direktīvu:
<#include "/templates/web/components/asyntai-widget.ftl" />
Alternatīvi, ja izmantojat Crafter komponentu renderēšanas sistēmu, izmantojiet:
<@renderComponent component=contentModel.asyntaiWidget />
Saglabājiet abus failus un publicējiet caur Crafter Studio

Piezīme: Atsevišķas komponenta veidnes izmantošana atvieglo tērzēšanas robota iespējošanu vai atspējošanu visā jūsu vietnē, komentējot vienu iekļaušanas rindu.

Alternatīvā metode 2: Crafter galvenes/skriptu konfigurācijas izmantošana

CrafterCMS ļauj globāli injicēt skriptus caur vietnes konfigurāciju:

Crafter Studio pārejiet uz Vietnes konfigurācija > Konfigurācija
Atveriet failu Engine vietnes konfigurācija (site-config.xml)
Pievienojiet pielāgotu skriptu injekcijas konfigurāciju:
<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>
Alternatīvi rediģējiet savu bāzes FreeMarker izkārtojumu, lai lasītu no vietnes konfigurācijas un dinamiski injicētu skriptus:
<#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>
Saglabājiet un publicējiet konfigurācijas izmaiņas

Padoms: Vietnes konfigurācijas izmantošana ļauj pārvaldīt tērzēšanas robota logrīku, tieši nemodificējot veidņu failus, atvieglojot vēlāku atjaunināšanu vai noņemšanu.

Alternatīvā metode 3: Groovy kontroliera izmantošana

CrafterCMS atbalsta Groovy skriptus servera puses loģikai. Varat izmantot kontrolieri, lai dinamiski pievienotu tērzēšanas robota skriptu:

Izveidojiet Groovy skriptu /scripts/pages/ (piemēram, /scripts/pages/home.groovy vai jūsu visas vietnes kontrolieri)
Pievienojiet šādu kodu, lai injicētu skripta URL veidnes modelī:
// /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"
Pēc tam atsaucieties uz modeļa mainīgajiem savā FreeMarker veidnē:
<#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if>
Saglabājiet gan Groovy skriptu, gan veidnes failu
Publicējiet izmaiņas caur Crafter Studio

Piezīme: Groovy kontroliera pieeja ir noderīga, kad nepieciešama nosacīta loģika (piemēram, tērzēšanas robota iespējošana tikai noteiktām lietotāju lomām vai lapu tipiem) vai kad vēlaties iegūt konfigurācijas vērtības no ārējiem avotiem.

3. solis: Publicējiet un pārbaudiet

Pēc izmaiņu veikšanas publicējiet tās caur Crafter Studio:

Crafter Studio vidē dodieties uz Vietnes vadības paneli
Pārskatiet savas izmaiņas sadaļā Mana nesenā darbība vai Gaida apstiprinājumu
Noklikšķiniet uz Publicēt, lai padarītu izmaiņas aktīvas
Apmeklējiet savu CrafterCMS tīmekļa vietni jaunā pārlūkprogrammas cilnē vai inkognito logā
Jums vajadzētu redzēt tērzēšanas logrīka pogu apakšējā labajā stūrī
Noklikšķiniet uz tās, lai pārliecinātos, ka tā atveras un darbojas pareizi

Neredzat logrīku? Pārliecinieties, ka publicējāt izmaiņas caur Crafter Studio. Pārbaudiet, vai rediģējat pareizo veidnes failu, ko izmanto jūsu lapas. Notīriet pārlūkprogrammas kešatmiņu vai skatiet inkognito logā. Ja izmantojat Crafter kešošanu, notīriet Engine kešatmiņu no Crafter Studio vadības paneļa.

Veidnes atrašanās vieta: CrafterCMS veidņu atrašanās vietas var atšķirties atkarībā no jūsu projekta struktūras. Bieži sastopamas vietas ietver /templates/web/pages/ lapas veidnēm, /templates/web/components/ komponentu veidnēm un /templates/web/ izkārtojuma veidnēm. Pārbaudiet esošās veidnes, lai atrastu, kur ir definēts </body> tags.