Ako pridať Asyntai AI Chatbot do October CMS

Podrobný návod pre webové stránky October 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: Pridanie do šablóny rozloženia (Odporúčané)

Odporúčaný spôsob pridania chatbota je úprava vášho predvoleného rozloženia v administrácii October CMS:

Prihláste sa do svojej administrácie October CMS
Prejdite na CMS > Layouts v hlavnom menu
Otvorte svoje predvolené rozloženie (zvyčajne default.htm)
Nájdite uzatváraciu </body> značku a {% scripts %} zástupný symbol
Pridajte svoj vkladací kód Asyntai tesne pred {% scripts %} a </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Kliknite na "Save" pre použitie zmien

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žiť zástupný symbol skriptov October CMS na vloženie chatbota zo stránky alebo čiastočnej šablóny:

Otvorte akúkoľvek stránku alebo čiastočnú šablónu v editore CMS
Pridajte nasledujúci kód pomocou {% put scripts %} bloku:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Nahradte YOUR_WIDGET_ID vasim skutocnym ID widgetu z dashboardu
Kliknite na "Uložiť"

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.

Alternatívna metóda 2: Pomocou komponentu PHP

Ak uprednostňujete programový prístup, môžete pridať skript chatbota cez vlastný komponent:

Vytvorte alebo upravte komponent vo vašom plugine October CMS
V metóde onRun() komponentu použite metódu 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 vaším skutočným ID widgetu
Zaregistrujte komponent na stránkach, kde chcete, aby sa chatbot zobrazoval

Tip: Použitie komponentu vám dáva programovú kontrolu nad tým, kedy a kde sa chatbot načíta. Môžete pridať podmienkovú logiku do onRun() na riadenie načítania podľa rolí používateľov, typov stránok alebo iných kritérií.

Alternatívna metóda 3: Pomocou čiastočnej šablóny

Pre lepšiu organizáciu môžete vytvoriť opakovane použiteľnú čiastočnú šablónu pre chatbota:

Prejdite na CMS > Partials v administrácii October CMS
Kliknite na \"+ Add\" na vytvorenie novej čiastočnej šablóny
Pomenujte ju asyntai-widget.htm
Pridajte svoj vkladací kód Asyntai do čiastočnej šablóny:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Kliknite na "Uložiť"
Otvorte šablónu rozloženia a zahrňte čiastočnú šablónu pred </body>:
{% partial 'asyntai-widget' %}
Uložte rozloženie

Tip: Použitie čiastočnej šablóny uľahčuje povolenie alebo zakázanie chatbota na celom webe jednoduchým pridaním alebo odstránením zahrnutia čiastočnej šablóny z vášho rozloženia.

Krok 3: Overenie inštalácie

Po uložení zmien navštívte svoju webovú stránku October CMS v novej záložke prehliadača alebo v okne inkognito. V pravom dolnom rohu by ste mali vidieť tlačidlo chatového widgetu. Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne.

Nevidíte widget? Uistite sa, že ste uložili všetky zmeny v administrácii CMS. Vymažte vyrovnávaciu pamäť prehliadača alebo zobrazte stránku v okne inkognito. Ak váš web používa vyrovnávaciu pamäť, vymažte vyrovnávaciu pamäť October CMS spustením php artisan cache:clear z príkazového riadka alebo použite možnosť Settings > System > Clear Cache v administrácii.

Výber rozloženia: Uistite sa, že stránky, kde chcete, aby sa chatbot zobrazoval, používajú správne rozloženie. Ktoré rozloženie stránka používa, zistíte otvorením stránky v CMS > Pages a pozretím na rozbaľovací zoznam Layout v nastaveniach stránky.