Jak přidat Asyntai AI Chatbota na Craft CMS

Průvodce krok za krokem pro weby Craft CMS

Platforma:

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Úprava šablony rozvržení (doporučeno)

Nejjednodušší způsob, jak přidat chatbota na všechny stránky, je úprava hlavní šablony rozvržení:

Přistupte k souborům projektu Craft CMS přes FTP, SSH nebo editor kódu
Přejděte do adresáře templates/
Najděte hlavní soubor rozvržení (obvykle pojmenovaný _layout.twig, _layout.html nebo umístěný v templates/_layouts/)
Najděte uzavírací značku </body>
Vložte svůj Asyntai embed kód těsně před značku </body>
Uložte soubor

Tip: Přidání skriptů před uzavírací značku </body> zajistí, že se načte po obsahu stránky, což je doporučeno pro chatovací widgety a nezpomalí načítání stránky.

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

Craft CMS poskytuje vestavěný Twig tag pro registraci JavaScriptu:

Otevřete svou hlavní šablonu rozvržení
Přidejte následující kód před uzavírací značku </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 svým skutečným ID widgetu
Uložte soubor

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

Alternativa: Vytvoření samostatného include souborů

Pro lepší organizaci vytvořte samostatný include soubor:

Vytvořte nový soubor: templates/_includes/chatbot.twig (nebo .html)
Přidejte svůj Asyntai embed kód do tohoto souborů:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Ve své hlavní šabloně rozvržení vložte tento soubor před </body>:
{% include '_includes/chatbot' %}
Uložte oba soubory

Tip: Použití include souborů usnadňuje zapnutí/vypnutí chatbota na celém webu zakomentováním jediného řádku.

Alternativa: Podmíněné načítání

Pro načtení chatbota pouze na konkrétních stránkách nebo sekcích:

Ve své šabloně rozvržení nebo stránky použijte Twig podmínky:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Nebo zkontrolujte konkrétní sekce:
{% 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: Ověřte instalaci

Po uložení změn navštivte svůj Craft CMS web v nové záložce prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatovacího widgetu. Klikněte na něj a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Ujistěte se, že jste uložili soubor šablony a že upravujete správnou šablonu rozvržení, kterou vaše stránky používají. Vymažte mezipaměť prohlížeče nebo zobrazit stránku v anonymním okně. Pokud používáte kešování šablon, vymažte mezipaměť Craft CMS z ovládacího panelu v Utilities > Clear Caches.

Umístění šablony: Umístění šablon Craft CMS se může lišit v závislosti na nastavení vašeho projektu. Běžná umístění zahrnují templates/_layout.twig, templates/_layouts/main.twig nebo templates/_base.twig. Zkontrolujte své stávající šablony a najděte, kde je definována značka </body>.