Az Asyntai AI Chatbot hozzáadása a Kentico-hoz

Lépésről lépésre útmutató Kentico CMS weboldalakhoz

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: Kód hozzáadása a mesteroldal sablonhoz (ajánlott)

A chatbot Kentico weboldal összes oldalához egyszerre való hozzáadásához használja a mesteroldal sablon módszert:

Lépjen be a Kentico Adminisztrációba, és navigáljon az Oldal sablonok alkalmazáshoz
Keresse meg és nyissa meg a mesteroldal sablont (az összes oldalon használt sablont)
Kattintson a Fejléc fülre a sablonszerkesztőben
A fejléc részbe illessze be az Asyntai beágyazási kódot
Alternatívaként adja hozzá a kódot a sablon elrendezéséhez a záró </head> tag elé
Kattintson a Mentés gombra a változtatások alkalmazásához
Törölje a webhelye gyorsítótárát, és ellenőrizze a változásokat az éles oldalon

Tipp: A mesteroldal sablon használata biztosítja, hogy a chatbot megjelenjen minden oldalon, amely ebből a sablonból örököl. Ez a leghatékonyabb módszer a Kentico egész webhelyre kiterjedő telepítéséhez.

1. alternatív módszer: Oldal sablon fejléc

Ha a chatbotot csak adott oldal sablonokhoz szeretné hozzáadni:

Lépjen az Oldal sablonok alkalmazáshoz a Kentico Adminisztrációban
Válassza ki a szerkeszteni kívánt adott oldal sablont
Kattintson a Fejléc fülre
Adja hozzá az Asyntai beágyazási kódot egy script tag segítségével:

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

Kattintson a Mentés gombra
Az ezt a sablont használó összes oldal mostantól tartalmazza a chatbotot

Megjegyzés: Ez a módszer akkor hasznos, ha a chatbotot a webhely olyan adott részeihez szeretné hozzáadni, amelyek ugyanazt az oldal sablont használják, nem az egész webhelyhez.

2. alternatív módszer: HEAD HTML web rész

Az egyes oldalak feletti részletesebb kontrollhoz vagy az aloldalakra örökölhető JavaScripthez:

Nyissa meg a szerkeszteni kívánt oldalt a Kentico Oldal szerkesztőjében
Adjon hozzá egy új web részt az oldalhoz (lehetőleg egy szülő oldalon az örökléshez)
Keressen rá és válassza ki a HEAD HTML web részt
A web rész konfigurációjában illessze be az Asyntai beágyazási kódot
Konfigurálja a web részt örökölhetőre, ha azt szeretné, hogy a gyermek oldalak is rendelkezzenek a chatbottal
Kattintson az OK gombra a web rész mentéséhez
Mentse el és tegye közzé az oldalt

Tipp: A HEAD HTML web rész tökéletes kód hozzáadásához egy szülő oldalhoz, amely automatikusan terjed az összes gyermek oldalra, egy részletre kiterjedő telepítést hozva létre.

3. alternatív módszer: Egyéni JavaScript fájlok (haladó)

Olyan fejlesztők számára, akik a scripteket fájlokként preferálják kezelni:

A Kentico projektben navigáljon a ~/CMSScripts/Custom/ könyvtárba
Hozzon létre egy új JavaScript fájlt (pl. asyntai-widget.js)
Adjon hozzá kódot az Asyntai widget dinamikus betöltéséhez:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

Hivatkozzon erre a fájlra a mesteroldal sablon fejlécében:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

Fontos: Ez a fejlett módszer fájlrendszer-hozzáférést és a Kentico könyvtárstruktúrájának ismeretét igényli. Győződjön meg arról, hogy megfelelő jogosultságokkal rendelkezik, és mindig egy tesztkörnyezetben tesztelje először.

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

A változtatások mentése és a gyorsítótár törlése után nyissa meg weboldalát egy új böngészőlapon vagy inkognító ablakban. Látnia kell a chat widget gombot a jobb alsó sarokban. Kattintson rá, hogy meggyőződjön arról, hogy megfelelően nyílik meg és működik.

Nem látja a widgetet? Győződjön meg arról, hogy mentette az összes változtatást és törölte a Kentico gyorsítótárát (Beállítások > Rendszer > Gyorsítótár törlése). Próbálja meg inkognító ablakban megtekinteni weboldalát. Ellenőrizze a böngésző konzolját (F12) minden olyan JavaScript-hiba azonosításához, amely megakadályozhatja a widget betöltését.