Vissza az irányítópultra

Dokumentáció

Ismerd meg az Asyntai használatát

Az Asyntai AI Chatbot hozzáadása a Concrete CMS-hez

Lépésről lépésre útmutató Concrete CMS (korábban Concrete5) weboldalakhoz

Beágyazási kód lekérése

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 téma lábléchez (ajánlott)

A legjobb módszer a chatbot hozzáadásához a Concrete CMS weboldal összes oldalára a téma lábléc fájljának szerkesztése:

  1. Lépjen be a Concrete CMS telepítésébe FTP-n vagy Fájlkezelőn keresztül
  2. Navigáljon a /application/themes/your_theme_name/ könyvtárba
  3. Keresse meg és nyissa meg a footer.php fájlt (vagy az azzal egyenértékű lábléc sablont)
  4. Keresse meg a záró </body> taget tartalmazó sort
  5. Illessze be az Asyntai beágyazási kódot közvetlenül a </body> tag elé
  6. Mentse el a fájlt, és töltse vissza a szerverre, ha helyileg szerkesztette
  7. Törölje a Concrete CMS gyorsítótárát: Vezérlőpult → System & Settings → Clear Cache

Tipp: A kód záró </body> tag elé való hozzáadása 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: HTML blokk (legkönnyebb nem fejlesztőknek)

Ha nem szeretné szerkeszteni a témafájlokat, használhatja a Concrete CMS beépített HTML blokkját:

  1. Lépjen be a Concrete CMS Irányítópultba
  2. Navigáljon arra az oldalra, ahol a chatbotot hozzá szeretné adni
  3. Kattintson az Oldal szerkesztése (ceruza ikon az eszköztáron) gombra
  4. Kattintson a Blokk hozzáadása gombra azon a területen, ahol el szeretné helyezni a kódot
  5. Keressen rá és válassza ki a HTML blokkot
  6. Illessze be az Asyntai beágyazási kódot a HTML szerkesztőbe
  7. Kattintson a Hozzáadás gombra a blokk mentéséhez
  8. Kattintson a Közzététel gombra a módosítások élesítéséhez

Megjegyzés: A HTML blokk módszer nagyszerű a chatbot adott oldalakhoz való hozzáadásához. Az egész webhelyre kiterjedő telepítéshez minden oldalhoz hozzá kell adnia a HTML blokkot, vagy használja a fent leírt téma lábléc módszert. A blokk vizuális elhelyezkedése nem befolyásolja, hogy a chatbot hol jelenik meg – az továbbra is a jobb alsó sarokban fog megjelenni.

2. alternatív módszer: Téma fejléc fájl

A kódot hozzáadhatja a téma fejléc fájljához is az egész webhelyre kiterjedő telepítéshez:

  1. Érje el Concrete CMS fájljait FTP-n vagy Fájlkezelőn keresztül
  2. Navigáljon a /application/themes/your_theme_name/ mappába
  3. Nyissa meg a header.php fájlt (vagy elements/header.php)
  4. Keresse meg a záró </head> tagot
  5. Illessze be az Asyntai beágyazási kódot közvetlenül a </head> tag elé
  6. Mentse el és töltse fel a fájlt
  7. Ürítse ki a gyorsítótárat az irányítópultról
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </head>

Tipp: Ügyeljen arra, hogy a <?php View::element('header_required'); ?> kóddal belefoglalja a szükséges fejlécelemeket a header.php fájlba, hogy a Concrete CMS megfelelően működjön.

Alternatív 3. módszer: Egyéni sablon (haladó)

A nagyobb irányítást igénylő fejlesztők számára lehetőség van egyéni oldalsablon létrehozására:

  1. Hozzon létre egy új oldalsablon fájlt a /application/themes/your_theme_name/ mappában
  2. Vagy másoljon egy meglévő sablont (pl. default.php), és nevezze át
  3. Adja hozzá az Asyntai beágyazási kódot a sablonfájlhoz a </body> tag elé
  4. A Concrete CMS Irányítópultján lépjen az Oldalak és témák menübe
  5. Kattintson az Oldaltípusok elemre
  6. Válassza ki azt az oldaltípust, amelyhez ezt a sablont használni szeretné
  7. Rendelje hozzá az egyéni sablont az oldaltípushoz
  8. Az ezt a sablont használó összes oldal mostantól tartalmazza a chatbotot

Fontos: A módosítások elvégzése előtt mindig készítsen biztonsági másolatot a témafájljairól. Ha lehetséges, először tesztelje a módosításokat egy tesztkörnyezetben. A témafájlok helytelen szerkesztése tönkreteheti a webhely elrendezését vagy funkcionalitását.

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

A módosítások elvégzése és a gyorsítótár ürítése után nyissa meg webhelyét egy új böngészőlapon vagy inkognitóablakban. A jobb alsó sarokban meg kell jelennie a chat widget gombnak. Kattintson rá, hogy megbizonyosodjon 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 ürítette a Concrete CMS gyorsítótárát (Irányítópult → Rendszer & Beállítások → Gyorsítótár ürítése). Próbálja meg megtekinteni webhelyét inkognitóablakban. Ellenőrizze, hogy mentette és feltöltötte-e az összes fájlmódosítást. Nyissa meg a böngésző konzolját (F12), és ellenőrizze, hogy nincsenek-e JavaScript hibák.