Az Asyntai AI chatbot hozzáadása a Backdrop CMS-hez

Lépésről lépésre útmutató Backdrop 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 a témasablonhoz (ajánlott)

A Backdrop CMS .tpl.php sablonfájlokat használ a témáiban. Az ajánlott megközelítés az, hogy a beágyazási kódot közvetlenül az aktív téma oldalsablonjához adja hozzá:

Lépjen be a Backdrop CMS telepítésébe FTP-n vagy Fájlkezelőn keresztül
Navigáljon az aktív téma könyvtárába: themes/yourtheme/
Nyissa meg a page.tpl.php fájlt (vagy a layout.tpl.php fájlt a témától függően)
Keresse meg a záró </body> taget vagy a <?php print $page_bottom; ?> sort
Illessze be az Asyntai beágyazási kódot közvetlenül az előtt a sor előtt
Mentse el a fájlt

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Tipp: A kód közvetlenül a <?php print $page_bottom; ?> vagy a záró </body> tag elé helyezése biztosítja, hogy a chatbot az oldal tartalmának betöltése után töltődjön be, ami jobb oldalbetöltési teljesítményt nyújt. Ez a módszer automatikusan hozzáadja a chatbotot az összes oldalhoz, amely ezt a témát használja.

1. alternatív módszer: Egyéni modul használata

Létrehozhat egy egyszerű Backdrop CMS modult, amely a chatbot scriptet a backdrop_add_js() segítségével injektálja:

Hozza létre a modul könyvtárát: modules/custom/asyntai_widget/
Hozza létre az asyntai_widget.module modulfájlt a következő kóddal:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
Hozza létre az asyntai_widget.info fájlt:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Lépjen a Funkciók (admin/modules) menüpontba a Backdrop adminisztrációs paneljén
Keresse meg az „Asyntai AI Chatbot Widget" elemet az Egyéni csomagban, és engedélyezze azt
Kattintson a „Konfiguráció mentése" gombra

Megjegyzés: Cserélje le a YOUR_WIDGET_ID értéket a modulkódban a tényleges widget-azonosítójára az Asyntai Irányítópultból. Az egyéni modul megközelítése frissítésbiztos, és nem íródik felül a téma frissítésekor.

2. alternatív módszer: A Backdrop „Add to Head" moduljának használata

A közreműködői „Add to Head" modul egyszerű módot kínál scriptek injektálására kódszerkesztés nélkül:

Töltse le és telepítse az „Add to Head" közreműködői modult a Backdrop CMS weboldaláról
Lépjen a Configuration > Development > Add to Head menübe
Adja hozzá az Asyntai beágyazási kódot a lábléc részben
Kattintson a „Konfiguráció mentése" gombra

Tipp: Az „Add to Head" modul használata a legegyszerűbb módszer, ha nem szeretné szerkeszteni a témafájlokat vagy egyéni modulokat létrehozni. Egyszerű adminisztrációs felületet biztosít az injektált scriptek kezeléséhez.

3. alternatív módszer: A blokk-rendszer használata

A Backdrop CMS elrendezés- és blokk-rendszerével is hozzáadható a chatbot:

Lépjen be a Backdrop CMS adminisztrációs paneljébe
Lépjen a Struktúra > Elrendezések menübe
Válassza ki a szerkeszteni kívánt elrendezést (pl. az alapértelmezett elrendezést)
Kattintson a „Blokk hozzáadása" gombra a lábléc régióban
Válassza az „Egyéni blokk" lehetőséget
Állítsa a blokk formátumát „Teljes HTML" vagy „Nyers HTML" értékre
Illessze be az Asyntai beágyazási kódot a blokk törzsébe
Adjon a blokknak egy címet (pl. „Asyntai Chatbot"), és szükség esetén jelölje be a „Cím elrejtése" opciót
Kattintson a „Blokk mentése", majd az „Elrendezés mentése" gombra

Fontos: Győződjön meg arról, hogy a szövegformátum „Teljes HTML" vagy „Nyers HTML" értékre van állítva, hogy a script tag ne törlődjön ki. Az alapértelmezett „Szűrt HTML" formátum biztonsági okokból eltávolítja a script tageket.

3. lépés: Gyorsítótár törlése és ellenőrzés

A változtatások elvégzése után törölje a Backdrop CMS gyorsítótárát, és ellenőrizze a telepítést:

Lépjen a Konfiguráció > Teljesítmény menübe az adminisztrációs paneljén
Kattintson az „Összes gyorsítótár törlése" gombra
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 megbizonyosodjon a helyes megnyitásról és működésről

Nem látja a widgetet? Győződjön meg arról, hogy törölte a Backdrop CMS gyorsítótárát a Konfiguráció > Teljesítmény menüben. Próbálja megtekinteni oldalát inkognító ablakban, vagy törölje a böngésző gyorsítótárát. Nyissa meg a böngésző konzolját (F12) a JavaScript-hibák ellenőrzéséhez. Ha az egyéni modul módszert használta, ellenőrizze, hogy a modul engedélyezve van-e a Funkciók alatt.