Kuidas lisada Asyntai tehisintellekti vestlusrobot Craft CMS-i

Samm-sammult juhend Craft CMS-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: Muutke oma paigutusmalli (soovitatav)

Lihtsaim viis vestlusroboti lisamiseks kõikidele lehtedele on muuta oma põhipaigutusmalli:

Avage oma Craft CMS-i projekti failid FTP, SSH või oma koodiredaktori kaudu
Navigeerige kataloogi templates/
Leidke oma põhipaigutusfail (tavaliselt nimega _layout.twig, _layout.html või asub kaustas templates/_layouts/)
Leidke sulgev silt </body>
Kleepige oma Asyntai manuskood vahetult enne </body> silti
Salvestage fail

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.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS pakub sisseehitatud Twigi silti JavaScripti registreerimiseks:

Avage oma põhipaigutusmall
Lisage järgmine kood enne sulgevat </body> silti:
{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %}
Asendage YOUR_WIDGET_ID oma tegeliku vidina ID-ga
Salvestage fail

Märkus: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternatiiv: looge eraldi kaasamisfail

Parema organiseerimise jaoks looge pühendatud kaasamisfail:

Looge uus fail: templates/_includes/chatbot.twig (või .html)
Lisage oma Asyntai manuskood sellesse faili:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Oma põhipaigutusmallis lisage see fail enne </body>:
{% include '_includes/chatbot' %}
Salvestage mõlemad failid

Vihje: Kaasamisfaili kasutamine muudab vestlusroboti lubamise/keelamise kogu saidil lihtsaks, kommenteerides välja vaid ühe rea.

Alternatiiv: tingimuslik laadimine

Vestlusroboti laadimiseks ainult konkreetsetel lehtedel või jaotistes:

Oma paigutuse või lehemallis kasutage Twigi tingimusi:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Või kontrollige konkreetseid jaotisi:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

3. samm: Kontrollige paigaldust

Pärast muudatuste salvestamist külastage oma Craft CMS-i veebisaiti 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 salvestasite mallifaili ja et muudate õiget paigutusmalli, mida teie lehed kasutavad. Tühjendage brauseri vahemälu või vaadake inkognito aknas. Mallide vahemälu kasutamisel tühjendage Craft CMS-i vahemälu juhtpaneelist jaotises Tööriistad > Tühjenda vahemälud.

Malli asukoht: Craft CMS-i malli asukohad võivad sõltuvalt teie projekti seadistusest erineda. Levinud asukohad on templates/_layout.twig, templates/_layouts/main.twig või templates/_base.twig. Kontrollige oma olemasolevaid malle, et leida, kus on määratletud silt </body>.