Az Asyntai AI Chatbot hozzáadása az October CMS-hez

Lépésről lépésre útmutató az October CMS webhelyekhez

Platform:

1. lépés: Szerezze be a beágyazási kódját

Először lépjen az Asyntai Irányítópultra és görgessen le a „Beágyazási kód" szekcióhoz. Másolja le az egyedi beágyazási kódját, amely így fog kinézni:

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

Megjegyzés: A fenti kód csak egy példa. Le kell másolnia saját egyedi beágyazási kódját az Irányítópultról, mivel az tartalmazza személyes widget-azonosítóját.

2. lépés: Hozzáadás az elrendezési sablonhoz (ajánlott)

A chatbot hozzáadásának ajánlott módja az alapértelmezett elrendezés szerkesztése az October CMS adminfelületen:

Jelentkezzen be az October CMS adminfelületére
Lépjen a CMS > Elrendezések menüponthoz a főmenüben
Nyissa meg az alapértelmezett elrendezést (általában default.htm)
Keresse meg a záró </body> taget és a {% scripts %} helyőrzőt
Adja hozzá az Asyntai beágyazási kódot közvetlenül a következő elé: {% scripts %} és </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Kattintson a „Mentés" gombra a módosítások alkalmazásához

Tipp: 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

Az October CMS szkriptek helyőrzőjével beillesztheti a chatbotot egy oldalból vagy részleges sablonból:

Nyisson meg bármely oldalt vagy részleges sablont a CMS szerkesztőben
Adja hozzá a következő kódot a {% put scripts %} blokk:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Cserélje ki a YOUR_WIDGET_ID értékét a tényleges widget azonosítójára az irányítópultról
Kattintson a „Mentés" gombra

Megjegyzés: 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ív módszer 2: Komponens PHP használata

Ha programozói megközelítést részesít előnyben, hozzáadhatja a chatbot szkriptet egy egyéni komponens segítségével:

Hozzon létre vagy módosítson egy komponenst az October CMS bővítményében
A komponens onRun() metódusában használja az addJs() metódust:
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Cserélje ki a YOUR_WIDGET_ID értékét a tényleges widget azonosítójára az irányítópultról
Regisztrálja a komponenst azokon az oldalakon, ahol meg szeretné jeleníteni a chatbotot

Tipp: Egy komponens használatával programozói irányítást szerez a chatbot betöltésének időpontja és helye felett. Az onRun() belsejébe feltételes logikát adhat a betöltés szabályozásához felhasználói szerepkörök, oldaltípusok vagy egyéb feltételek alapján.

Alternatív módszer 3: Részleges sablon használata

Létrehozhat egy újrafelhasználható részleges sablont a chatbot widgethez:

Lépjen a CMS > Részleges sablonok menüponthoz az October CMS adminfelületén
Kattintson a „+ Hozzáadás” gombra egy új részleges sablon létrehozásához
Nevezd el asyntai-widget.htm-nek
Adja hozzá az Asyntai beágyazó kódját a részleges sablonhoz:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Kattintson a „Mentés" gombra
Nyissa meg az elrendezési sablont, és illessze be a részleges sablont a </body> tag elé:
{% partial 'asyntai-widget' %}
Mentse el az elrendezést

Tipp: A részleges sablon használatával könnyen engedélyezheti vagy letilthatja a chatbotot az egész webhelyen, egyszerűen hozzáadva vagy eltávolítva a részleges sablon hivatkozást az elrendezésből.

3. lépés: Telepítés ellenőrzése

A változtatások mentése után látogassa meg az October CMS weboldalát egy új böngészőlapon vagy inkognító ablakban. A jobb alsó sarokban meg kell jelennie a chat widget gombnak. Kattintson rá, hogy megbizonyosodjon arról, hogy megnyílik és megfelelően működik.

Nem látja a widgetet? Győződjön meg róla, hogy minden módosítást mentett a CMS adminfelületen. Törölje a böngészőgyorsítótárat, vagy tekintse meg inkognító ablakban. Ha a webhelye gyorsítótárat használ, ürítse az October CMS gyorsítótárát a php artisan cache:clear parancs parancssorból való futtatásával, vagy használja a Beállítások > Rendszer > Gyorsítótár törlése opciót az adminfelületen.

Elrendezés kiválasztása: Győződjön meg arról, hogy azok az oldalak, amelyeken meg szeretné jeleníteni a chatbotot, a megfelelő elrendezést használják. Ellenőrizheti, hogy egy oldal melyik elrendezést használja, ha megnyitja az oldalt a CMS > Oldalak menüpontban, és megnézi az Elrendezés legördülő menüt az oldalbeállításokban.