Kaip pridėti Asyntai DI pokalbių robotą prie CrafterCMS

Žingsnis po žingsnio vadovas CrafterCMS svetainėms

Platforma:

1 žingsnis: Gaukite savo įterpimo kodą

Pirma, eikite į savo Asyntai valdymo skydelį ir slinkite žemyn iki "Įterpimo kodas" skyriaus. Nukopijuokite savo unikalų įterpimo kodą, kuris atrodys taip:

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

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

2 žingsnis: Pridėkite prie FreeMarker šablono (Rekomenduojama)

CrafterCMS naudoja FreeMarker (.ftl) šablonus puslapiams atvaizduoti. Paprasčiausias būdas pridėti pokalbių robotą prie visų puslapių yra redaguoti pagrindinį puslapio šabloną:

Crafter Studio eikite į Svetainės valdymo skydelį > Turinio tipai arba eikite į šablonus
Atidarykite pagrindinį puslapio šabloną (pvz., /templates/web/pages/home.ftl arba bazinį išdėstymą)
Raskite uždaromąją </body> žymą
Įklijuokite savo Asyntai įterpimo kodą prieš </body> žymą:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
Išsaugokite failą ir publikuokite per Crafter Studio

Patarimas: Skripto pridėjimas prieš uždaromąjį </body> žymą užtikrina, kad jis krausis po puslapio turinio, o tai rekomenduojama pokalbių valdikliams ir nesulėtins puslapio įkrovimo.

Alternatyvus metodas 1: Crafter šablonų komponentų naudojimas

Geresnei organizacijai sukurkite skirtą komponento šabloną pokalbių roboto valdikliui:

Crafter Studio sukurkite naują šablono failą /templates/web/components/asyntai-widget.ftl
Pridėkite šį turinį prie komponento šablono:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Įtraukite jį į pagrindinį išdėstymo šabloną naudodami FreeMarker įtraukimo direktyvą:
<#include "/templates/web/components/asyntai-widget.ftl" />
Arba, jei naudojate Crafter komponentų atvaizdavimo sistemą, naudokite:
<@renderComponent component=contentModel.asyntaiWidget />
Išsaugokite abu failus ir publikuokite per Crafter Studio

Pastaba: Atskiro komponento šablono naudojimas palengvina pokalbių roboto įjungimą ar išjungimą visoje svetainėje, užkomentuojant vieną įtraukimo eilutę.

Alternatyvus metodas 2: Crafter antraštės/skriptų konfigūracijos naudojimas

CrafterCMS leidžia globaliai įterpti skriptus per svetainės konfigūraciją:

Crafter Studio eikite į Svetainės konfigūracija > Konfigūracija
Atidarykite Engine svetainės konfigūracijos failą (site-config.xml)
Pridėkite pasirinktinę skripto įterpimo konfigūraciją:
<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>
Alternatyviai redaguokite bazinį FreeMarker išdėstymą, kad nuskaitytų iš svetainės konfigūracijos ir dinamiškai įterptų 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>
Išsaugokite ir publikuokite konfigūracijos pakeitimus

Patarimas: Svetainės konfigūracijos naudojimas leidžia valdyti pokalbių roboto valdiklį neredaguojant šablonų failų tiesiogiai, palengvinant vėlesnį atnaujinimą ar pašalinimą.

Alternatyvus metodas 3: Groovy valdiklio naudojimas

CrafterCMS palaiko Groovy skriptus serverio pusės logikai. Galite naudoti valdiklį dinamiškai pridėti pokalbių roboto skriptą:

Sukurkite Groovy skriptą /scripts/pages/ (pvz., /scripts/pages/home.groovy arba visos svetainės valdiklį)
Pridėkite šį kodą, kad įterptumėte skripto URL į šablono 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"
Tada nurodykite modelio kintamuosius savo FreeMarker šablone:
<#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if>
Išsaugokite tiek Groovy skriptą, tiek šablono failą
Publikuokite pakeitimus per Crafter Studio

Pastaba: Groovy valdiklio būdas naudingas, kai reikia sąlyginės logikos (pvz., pokalbių roboto įjungimas tik tam tikroms naudotojų rolėms ar puslapių tipams) arba kai norite gauti konfigūracijos reikšmes iš išorinių šaltinių.

3 žingsnis: Publikuokite ir patikrinkite

Atlikę pakeitimus, publikuokite juos per Crafter Studio:

Crafter Studio eikite į Svetainės valdymo skydelį
Peržiūrėkite pakeitimus Mano naujausios veiklos arba Laukiantys patvirtinimo skyriuje
Spustelėkite Publikuoti, kad pakeitimai taptų gyvi
Apsilankykite savo CrafterCMS svetainėje naujame naršyklės skirtuke arba inkognito lange
Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe
Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai

Nematote valdiklio? Įsitikinkite, kad publikavote pakeitimus per Crafter Studio. Patikrinkite, ar redaguojate teisingą šablono failą, kurį naudoja jūsų puslapiai. Išvalykite naršyklės talpyklą arba peržiūrėkite inkognito lange. Jei naudojate Crafter talpyklą, išvalykite Engine talpyklą iš Crafter Studio valdymo skydelio.

Šablono vieta: CrafterCMS šablonų vietos gali skirtis priklausomai nuo projekto struktūros. Dažnos vietos yra /templates/web/pages/ puslapių šablonams, /templates/web/components/ komponentų šablonams ir /templates/web/ išdėstymo šablonams. Patikrinkite esamus šablonus, kad rastumėte, kur apibrėžta </body> žyma.