Kako dodati klepetalnik Asyntai z UI v CrafterCMS
Vodič po korakih za spletne strani CrafterCMS
Korak 1: Pridobite svojo vdelovalno kodo
Najprej pojdite na svojo Nadzorno ploščo Asyntai in se pomaknite navzdol do razdelka "Vdelovalna koda". Kopirajte svojo edinstveno vdelovalno kodo, ki bo videti takole:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Opomba: Zgornja koda je le primer. Svojo edinstveno vdelovalno kodo morate kopirati iz svoje Nadzorne plošče, saj vsebuje vaš osebni ID klepetalnika.
Korak 2: Dodajte v predlogo FreeMarker (priporočeno)
CrafterCMS uporablja predloge FreeMarker (.ftl) za izrisovanje strani. Najlažji način za dodajanje klepetalnika na vse strani je urejanje glavne predloge strani:
- V Crafter Studio pojdite na Nadzorna plošča strani > Tipi vsebine ali pojdite na predloge
- Odprite svojo glavno predlogo strani (npr.
/templates/web/pages/home.ftlali osnovno postavitev) - Poiščite zaključno oznako
</body> - Prilepite svojo vdelovalno kodo Asyntai tik pred oznako
</body>:<!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body> - Shranite datoteko in objavite prek Crafter Studio
Nasvet: Dodajanje skripta pred zaključno oznako </body> zagotavlja nalaganje po vsebini strani, kar je priporočeno za klepetalnik in ne bo upočasnilo nalaganja vaše strani.
Alternativni način 1: Uporaba komponent predlog Crafter
Za boljšo organizacijo ustvarite namensko predlogo komponente za klepetalnik:
- V Crafter Studio ustvarite novo datoteko predloge na
/templates/web/components/asyntai-widget.ftl - Dodajte naslednjo vsebino v predlogo komponente:
<!-- Asyntai AI Chatbot Component --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Vključite jo v svojo glavno predlogo postavitve z uporabo direktive za vključitev FreeMarker:
<#include "/templates/web/components/asyntai-widget.ftl" /> - Alternativno, če uporabljate sistem za upodabljanje komponent Crafter, uporabite:
<@renderComponent component=contentModel.asyntaiWidget /> - Shranite obe datoteki in objavite prek Crafter Studio
Opomba: Uporaba ločene predloge komponente olajša omogočanje ali onemogočanje klepetalnika na celotni strani s komentiranjem ene same vrstice za vključitev.
Alternativni način 2: Uporaba konfiguracije glave/skriptov Crafter
CrafterCMS omogoča globalno vstavljanje skriptov prek konfiguracije strani:
- V Crafter Studio pojdite na Konfiguracija strani > Konfiguracija
- Odprite datoteko Konfiguracija pogona strani (
site-config.xml) - Dodajte konfiguracijo za vstavljanje skripta po meri:
<site> <!-- Existing configuration... --> <!-- Custom Scripts --> <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> - Alternativno uredite svojo osnovno postavitev FreeMarker, da bere iz konfiguracije strani in dinamično vstavlja skripte:
<#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> - Shranite in objavite konfiguracijske spremembe
Nasvet: Uporaba konfiguracije strani omogoča upravljanje klepetalnika brez neposrednega spreminjanja datotek predlog, kar olajša poznejše posodabljanje ali odstranitev.
Alternativni način 3: Uporaba krmilnika Groovy
CrafterCMS podpira skripte Groovy za strežniško logiko. Uporabite lahko krmilnik za dinamično dodajanje skripta klepetalnika:
- Ustvarite skript Groovy v
/scripts/pages/(npr./scripts/pages/home.groovyali vaš krmilnik za celotno stran) - Dodajte naslednjo kodo za vstavljanje URL-ja skripta v model predloge:
// /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" - Nato se sklicujte na spremenljivke modela v svoji predlogi FreeMarker:
<#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if> - Shranite tako skript Groovy kot datoteko predloge
- Objavite spremembe prek Crafter Studio
Opomba: Pristop s krmilnikom Groovy je uporaben, ko potrebujete pogojno logiko (npr. omogočanje klepetalnika le za določene uporabniške vloge ali tipe strani) ali ko želite pridobiti konfiguracijske vrednosti iz zunanjih virov.
Korak 3: Objavite in preverite
Po izvedenih spremembah jih objavite prek Crafter Studio:
- V Crafter Studio pojdite na Nadzorno ploščo strani
- Preglejte spremembe v razdelku Moja nedavna dejavnost ali V čakanju na odobritev
- Kliknite Objavi, da spremembe stopijo v veljavo
- Odprite svoje spletno mesto v novem zavihku brskalnika ali oknu brez beleženja
- V spodnjem desnem kotu bi morali videti gumb klepetalnika
- Kliknite ga, da preverite, ali se pravilno odpre in deluje
Ne vidite klepetalnika? Prepričajte se, da ste objavili spremembe prek Crafter Studio. Preverite, ali urejate pravilno datoteko predloge, ki jo vaše strani uporabljajo. Počistite predpomnilnik brskalnika ali si oglejte stran v oknu brez beleženja. Če uporabljate predpomnjenje Crafter, počistite predpomnilnik pogona z nadzorne plošče Crafter Studio.
Lokacija predloge: Lokacije predlog CrafterCMS se lahko razlikujejo glede na strukturo projekta. Pogoste lokacije vključujejo /templates/web/pages/ za predloge strani, /templates/web/components/ za predloge komponent in /templates/web/ za predloge postavitev. Preverite obstoječe predloge, da ugotovite, kje je določena oznaka </body>.
Weebly