Kuidas lisada Asyntai tehisintellekti vestlusrobot CrafterCMS-ile

Samm-sammuline juhend CrafterCMS-i veebisaitide jaoks

Platvorm:

1. samm: hankige oma manuskood

Esmalt minge oma Asyntai juhtpaneelile ja kerige alla jaotiseni "Manuskood". Kopeerige oma unikaalne manuskood, mis näeb välja selline:

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

Märkus: Ülalolev kood on vaid näide. Peate kopeerima oma unikaalse manuskoodi oma juhtpaneelilt, kuna see sisaldab teie isiklikku vidina ID-d.

2. samm: lisage FreeMarkeri malli (soovitatav)

CrafterCMS kasutab lehtede renderdamiseks FreeMarkeri (.ftl) malle. Lihtsaim viis vestlusroboti lisamiseks kõikidele lehtedele on muuta oma põhilehe malli:

Minge Crafter Studios jaotisesse Saidi juhtpaneel > Sisutüübid või navigeerige mallide juurde
Avage oma põhilehe mall (nt /templates/web/pages/home.ftl või põhipaigutus)
Leidke sulgev </body> silt
Kleepige oma Asyntai manuskood vahetult enne </body> silti:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
Salvestage fail ja avaldage Crafter Studio kaudu

Vihje: Skripti lisamine enne sulgevat </body> silti tagab, et see laadib pärast lehe sisu, mis on vestlusvidinate jaoks soovitatav ega aeglusta teie lehe laadimist.

Alternatiivne meetod 1: Crafteri mallikomponentide kasutamine

Parema organiseerimise jaoks looge vestlusvidina jaoks pühendatud komponendimall:

Looge Crafter Studios uus mallifail asukohta /templates/web/components/asyntai-widget.ftl
Lisage komponendimallile järgmine sisu:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Lisage see oma põhipaigutusmallile kasutades FreeMarkeri kaasamiskäsklust:
<#include "/templates/web/components/asyntai-widget.ftl" />
Alternatiivina, kui kasutate Crafteri komponentide renderdussüsteemi, kasutage:
<@renderComponent component=contentModel.asyntaiWidget />
Salvestage mõlemad failid ja avaldage Crafter Studio kaudu

Märkus: Eraldi komponendimalli kasutamine muudab vestlusroboti lubamise või keelamise kogu saidil lihtsaks, kommenteerides välja vaid ühe kaasamise rea.

Alternatiivne meetod 2: Crafteri päise/skriptide konfiguratsiooni kasutamine

CrafterCMS võimaldab skripte globaalselt süstida saidi konfiguratsiooni kaudu:

Navigeerige Crafter Studios jaotisesse Saidi konfiguratsioon > Seadistus
Avage fail Engine Site Configuration (site-config.xml)
Lisage kohandatud skripti süstimise konfiguratsioon:
<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>
Teise võimalusena muutke oma FreeMarkeri põhipaigutust, et lugeda saidi konfiguratsioonist ja süstida skripte dünaamiliselt:
<#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>
Salvestage ja avaldage seadistusmuudatused

Vihje: Saidi konfiguratsiooni kasutamine võimaldab vestlusvidinat hallata ilma mallifaile otse muutmata, muutes hilisema uuendamise või eemaldamise lihtsamaks.

Alternatiivne meetod 3: Groovy kontrolleri kasutamine

CrafterCMS toetab Groovy skripte serveripoolse loogika jaoks. Saate kasutada kontrollerit vestlusroboti skripti dünaamiliseks lisamiseks:

Looge Groovy skript kausta /scripts/pages/ (nt /scripts/pages/home.groovy või teie kogu saidi kontroller)
Lisage järgmine kood skripti URL-i süstimiseks mallimudelisse:
// /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"
Seejärel viidake mudeli muutujatele oma FreeMarkeri mallis:
<#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if>
Salvestage nii Groovy skript kui ka mallifail
Avaldage muudatused Crafter Studio kaudu

Märkus: Groovy kontrolleri lähenemine on kasulik, kui vajate tingimuslikku loogikat (nt vestlusroboti lubamine ainult teatud kasutajarollide või lehetüüpide jaoks) või kui soovite tõmmata konfiguratsiooni väärtusi välistest allikatest.

3. samm: avaldage ja kontrollige

Pärast muudatuste tegemist avaldage need Crafter Studio kaudu:

Crafter Studios minge Saidi armatuurlauale
Vaadake oma muudatused üle jaotises Minu hiljutine tegevus või Kinnitamist ootav
Klõpsake Avalda, et muudatused jõustuksid
Avage oma veebisait uues brauseri vahekaardil või inkognito aknas
Peaksite nägema vestlusvidina nuppu alumises paremas nurgas
Klõpsake sellel, et veenduda, et see avaneb ja töötab korrektselt

Ei näe vidinat? Veenduge, et avaldasite muudatused Crafter Studio kaudu. Kontrollige, et muudate õiget mallifaili, mida teie lehed kasutavad. Tühjendage brauseri vahemälu või vaadake inkognito aknas. Crafteri vahemälu kasutamisel tühjendage Engine'i vahemälu Crafter Studio juhtpaneelilt.

Malli asukoht: CrafterCMS-i malli asukohad võivad sõltuvalt teie projekti struktuurist erineda. Levinud asukohad on /templates/web/pages/ lehemallide jaoks, /templates/web/components/ komponendimallide jaoks ja /templates/web/ paigutusmallide jaoks. Kontrollige oma olemasolevaid malle, et leida, kus on määratletud silt </body>.