Jak přidat Asyntai AI chatbota do October CMS

Podrobný návod pro weby na platformě October 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: Přidání do šablony rozložení (Doporučeno)

Doporučený způsob přidání chatbota je úprava výchozího rozložení v backendu October CMS:

Přihlaste se do backendu October CMS
Přejděte na CMS > Rozložení v hlavním menu
Otevřete své výchozí rozložení (obvykle default.htm)
Najděte uzavírací </body> tag a {% scripts %} zástupný symbol
Přidejte svůj vkládací kód Asyntai těsně před {% scripts %} a </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Klikněte na "Uložit" pro provedení změn

Tip: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Můžete použít zástupný symbol skriptů October CMS pro vložení chatbota ze stránky nebo partiálu:

Otevřete jakoukoli stránku nebo partial v editoru CMS
Přidejte následující kód pomocí {% put scripts %} bloku:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Nahraďte YOUR_WIDGET_ID skutečným ID widgetu z dashboardu
Klikněte na "Save"

Poznámka: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Alternativní metoda 2: Použití komponenty PHP

Pokud preferujete programový přístup, můžete přidat skript chatbota přes vlastní komponentu:

Vytvořte nebo upravte komponentu ve svém pluginu October CMS
V metodě onRun() komponenty použijte metodu addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Nahraďte YOUR_WIDGET_ID svým skutečným ID widgetu
Zaregistrujte komponentu na stránkách, kde chcete, aby se chatbot zobrazoval

Tip: Použití komponenty vám dává programovou kontrolu nad tím, kdy a kde se chatbot načítá. Můžete přidat podmíněnou logiku do onRun() pro řízení načítání na základě uživatelských rolí, typů stránek nebo jiných kritérií.

Alternativní metoda 3: Použití partiálu

Můžete vytvořit znovupoužitelný partial pro widget chatbota:

Přejděte na CMS > Partialy v backendu October CMS
Klikněte na \"+ Přidat\" pro vytvoření nového partiálu
Pojmenujte jej asyntai-widget.htm
Přidejte svůj vložený kód Asyntai do partiálu:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Klikněte na "Save"
Otevřete šablonu rozložení a zahrňte partial před </body>:
{% partial 'asyntai-widget' %}
Uložte rozložení

Tip: Použití partiálu usnadňuje zapnutí nebo vypnutí chatbota na celém webu jednoduchým přidáním nebo odebráním zahrnutí partiálu z vašeho rozložení.

Krok 3: Ověřte instalaci

Po uložení změn navštivte svůj web October CMS v nové kartě prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatové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 všechny změny v backendu CMS. Vymažte mezipaměť prohlížeče nebo stránku zobrazit v anonymním okně. Pokud váš web používá cachování, vymažte mezipaměť October CMS spuštěním php artisan cache:clear z příkazového řádku nebo použijte možnost Nastavení > Systém > Vymazat mezipaměť v backendu.

Výběr rozložení: Ujistěte se, že stránky, na kterých chcete chatbota zobrazit, používají správné rozložení. Můžete zkontrolovat, které rozložení stránka používá, otevřením stránky v CMS > Stránky a pohledem na rozbalovací nabídku Rozložení v nastavení stránky.