Az Asyntai AI Chatbot hozzáadása a Craft CMS-hez
Lépésről lépésre útmutató Craft CMS webhelyekhez
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: Az elrendezési sablon szerkesztése (ajánlott)
A legegyszerűbb módja, hogy az összes oldalhoz hozzáadja a chatbotot, a fő elrendezési sablon szerkesztése:
- Access your Craft CMS project files via FTP, SSH, or your code editor
- Navigáljon a
templates/könyvtárba - Keresse meg a fő elrendezési fájlt (általában
_layout.twig,_layout.htmlnevű, vagy atemplates/_layouts/könyvtárban található) - Keresse meg a záró
</body>taget - Illessze be az Asyntai beágyazási kódot közvetlenül a
</body>tag elé - Mentse el a fájlt
Tipp: A szkript hozzáadása a záró </body> tag elé biztosítja, hogy az oldaltartalom után töltődjön be, ami chat widgetek esetén ajánlott, és nem lassítja az oldalbetöltést.
Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)
Craft CMS provides a built-in Twig tag for registering JavaScript:
- Nyissa meg a fő elrendezési sablont
- Adja hozzá a következő kódot a záró
</body>tag elé:{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %} - Replace
YOUR_WIDGET_IDwith your actual widget ID - Mentse el a fájlt
Megjegyzés: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.
Alternatíva: Hozzon létre egy külön include fájlt
A jobb rendszerezés érdekében hozzon létre egy dedikált include fájlt:
- Hozzon létre egy új fájlt:
templates/_includes/chatbot.twig(vagy.html) - Adja hozzá az Asyntai beágyazási kódot ehhez a fájlhoz:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - A fő elrendezési sablonban foglalja bele ezt a fájlt a
</body>tag elé:{% include '_includes/chatbot' %} - Mentse el mindkét fájlt
Tipp: Egy include fájl használatával könnyedén engedélyezheti vagy letilthatja a chatbotot az egész webhelyen egyetlen sor kikommentelésével.
Alternatíva: Feltételes betöltés
A chatbot betöltéséhez csak meghatározott oldalakon vagy szakaszokon:
- Az elrendezési vagy oldalsablonban használjon Twig feltételeket:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %} - Vagy ellenőrizze az egyes szakaszokat:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
3. lépés: Telepítés ellenőrzése
A módosítások mentése után látogasson el Craft CMS webhelyére 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 mentette a sablonfájlt, és hogy a megfelelő elrendezési sablont szerkeszti, amelyet az oldalai használnak. Ürítse ki a böngésző gyorsítótárát, vagy nézze meg inkognitóablakban. Ha sablongyorsítótárazást használ, ürítse ki a Craft CMS gyorsítótárát a Vezérlőpultból a Segédprogramok > Gyorsítótár ürítése menüpont alatt.
Sablon helye: A Craft CMS sablon helye a projekt beállításától függően változhat. Általános helyek: templates/_layout.twig, templates/_layouts/main.twig vagy templates/_base.twig. Ellenőrizze a meglévő sablonjait, hogy megtalálja, hol van definiálva a </body> tag.
Weebly