Ako pridať Asyntai AI chatbota do Craft CMS

Návod krok za krokom pre webové stránky Craft CMS

Platforma:

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

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

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Krok 2: Úprava vašej šablóny rozloženia (odporúčané)

Najjednoduchší sposob pridania chatbota na všetky stránky je uprava vasej hlavnej šablóny rozloženia:

Prístupte k súborom vášho projektu Craft CMS cez FTP, SSH alebo váš editor kódu
Prejdite do priečinka templates/
Najdite svoj hlavny súbor rozloženia (bezne pomenovany _layout.twig, _layout.html alebo umiestneny v templates/_layouts/)
Nájdite uzatvárací tag </body>
Vložíte svoj vkladací kod Asyntai tesne pred tag </body>
Uložte súbor

Tip: Pridanie skriptu pred uzatvaraci tag </body> zabezpeci, ze sa nacita po obsahu stránky, co je odporúčané pre chatove widgety a nespomalí nacitanie vasej stránky.

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

Craft CMS poskytuje vstavany Twig tag na registraciu JavaScriptu:

Otvorte svoju hlavnu šablónu rozloženia
Pridajte nasledujuci kod pred uzatvaraci tag </body>:
{% 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 %}
Nahraďte YOUR_WIDGET_ID vaším skutočným ID widgetu
Uložte súbor

Poznámka: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternativa: Vytvorenie separatneho súboru na zahrnutie

Pre lepšiu organizaciu vytvorte vyhradeny súbor na zahrnutie:

Vytvorte novy súbor: templates/_includes/chatbot.twig (alebo .html)
Pridajte svoj vkladací kod Asyntai do tohto súboru:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Vo vasej hlavnej šablóne rozloženia zahrnte tento súbor pred </body>:
{% include '_includes/chatbot' %}
Uložte oba súbory

Tip: Použitie súboru na zahrnutie uľahcuje povolenie/zakazanie chatbota na celom vasom webe zakomentovanim jedneho riadku.

Alternatíva: Podmienené načítanie

Na načítanie chatbota len na konkrétnych stránkach alebo sekciách:

Vo vasej šablóne rozloženia alebo stránky použite podmienky Twig:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Alebo skontrolujte konkretne sekcie:
{% 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 %}

Krok 3: Overenie inštalácie

Po uložení vasich zmien navštívte svoju webovú stránku Craft CMS v novej karte prehliadača alebo v okne inkognito. Mali by ste vidiet tlačidlo chatoveho widgetu v pravom dolnom rohu. Kliknite nan, aby ste sa uistili, ze sa otvara a funguje správne.

Nevidíte widget? Uistite sa, ze ste uložili súbor šablóny a ze upravujete spravnu šablónu rozloženia, ktoru pouzivaju vase stránky. Vymažte vyrovnávaciu pamat prehliadača alebo zobrazite web v okne inkognito. Ak používate ukladanie šablón do vyrovnávacej pamate, vymažte vyrovnávaciu pamat Craft CMS z Ovladacieho panelu v casti Nastroje > Vymazat vyrovnavacie pamate.

Umiestnenie šablóny: Umiestnenia šablón Craft CMS sa mozu lisit v zavislosti od nastavenia vasho projektu. Bezne umiestnenia zahrnuju templates/_layout.twig, templates/_layouts/main.twig alebo templates/_base.twig. Skontrolujte svoje existujuce šablóny a najdite, kde je definovany tag </body>.