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

Lépésről lépésre útmutató MODX 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: Hozzáadás MODX sablonhoz (ajánlott)

A chatbot hozzáadásának ajánlott módja a MODX sablon közvetlen szerkesztése a MODX Managerben:

Lépjen be a MODX Managerbe (adminisztrációs panel)
A bal oldali sávban lépjen az Elemek > Sablonok menübe
Nyissa meg a webhely sablonját (általában „BaseTemplate" vagy az aktív sablon neve)
Keresse meg a záró </body> taget a sablonkódban
Illessze be az Asyntai beágyazási kódot közvetlenül a záró </body> tag elé
Kattintson a „Mentés" gombra a sablon mentéséhez

<!-- Your existing template content -->

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

Tipp: A kód közvetlenül a záró </body> tag elé való hozzáadása biztosítja, hogy a chatbot az összes oldaltartalom betöltése után töltődjön be, ami a chat widgetek esetén az ajánlott elhelyezés, és nem lassítja az oldalbetöltést.

1. alternatív módszer: MODX Chunk használata

Használhat MODX Chunk-ot a beágyazási kód elkülönítéséhez és újrafelhasználásához:

A MODX Managerben lépjen az Elemek > Chunk-ok menübe
Kattintson az "Új Chunk" gombra egy új chunk létrehozásához
Nevezd el a chunk-ot "asyntaiWidget"-nek
Illessze be az Asyntai beágyazási kódot a chunk tartalom területére
Kattintson a „Mentés" gombra
Nyissa meg a sablonját (az Elemek > Sablonok alatt)
Adja hozzá a chunk hívást [[$asyntaiWidget]] közvetlenül a záró </body> tag elé
Mentse el a sablont

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Tipp: Egy Chunk használatával könnyű egy helyen kezelni és frissíteni a beágyazási kódot, különösen ha több sablont használ a webhelyén.

2. alternatív módszer: MODX rendszerbeállítások használata (HTML fejléc/lábléc)

Néhány MODX beállítás tartalmaz helyőrzőket a lábléc scriptek számára a Rendszer beállításokon keresztül:

A MODX Managerben lépjen a Rendszer > Rendszerbeállítások menübe
Szűrjön a „htmlhead" értékre, vagy keressen egyéni rendszer beállítást a lábléc scriptek számára
Ha a beállítás tartalmaz helyőrzőt a lábléc scriptekhez (például [[++footer_scripts]]), használhatja azt
Állítsa a rendszer beállítás értékét az Asyntai beágyazási kódjára
Győződjön meg arról, hogy a megfelelő helyőrző [[++footer_scripts]] jelen van a sablonban a záró </body> tag előtt
Mentse a rendszer beállítást

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Megjegyzés: Ez a módszer attól függ, hogy a MODX beállításban van-e egyéni rendszer beállítás a lábléc scriptek számára. Ha ilyen nem létezik, létrehozhat egyéni rendszer beállítást, és hivatkozhat rá a sablonban a [[++setting_key]] szintaxis segítségével.

3. alternatív módszer: MODX bővítmény használata (OnWebPagePrerender)

Fejlettebb megközelítésként létrehozhat egy MODX bővítményt, amely automatikusan injektálja a chatbot kódot minden oldalba:

A MODX Managerben lépjen az Elemek > Bővítmények menübe
Kattintson az „Új bővítmény” gombra egy új bővítmény létrehozásához
Nevezze el a bővítményt „AsyntaiChatbot"-nak
Illessze be a következő PHP kódot a bővítmény kód területére:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Kattintson a „Rendszeresemények" fülre
Jelölje be a jelölőnégyzetet az „OnWebPagePrerender" mellett, hogy ez a bővítmény ennél az eseménynél aktiválódjon
Kattintson a „Mentés" gombra

Fontos: Cserélje le a YOUR_WIDGET_ID értéket a tényleges widget-azonosítójára az Asyntai Irányítópultból. Ez a bővítmény automatikusan injektálja a chatbot scriptet a MODX webhely minden oldalába a renderelés előtt.

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

A beágyazási kód fenti módszerek bármelyikével való hozzáadása után törölnie kell a MODX gyorsítótárát, és ellenőriznie kell a telepítést:

A MODX Managerben lépjen a Kezelés > Gyorsítótár törlése menübe (vagy kattintson a gyorsítótár törlése ikonra a felső menüben)
Nyissa meg weboldalát egy új böngészőlapon vagy inkognító ablakban
Látnia kell a chat widget gombot az oldal jobb alsó sarkában
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 MODX gyorsítótárát a MODX Manager Kezelés > Gyorsítótár törlése menüjéből. Próbálja meg törölni a böngésző gyorsítótárát is, vagy tekintse meg a webhelyet inkognító ablakban. Ha a bővítmény módszert használta, ellenőrizze, hogy az „OnWebPagePrerender" rendszeresemény be van-e jelölve a bővítményéhez.