Vissza az iranyitopultra

Dokumentacio

Ismerje meg az Asyntai hasznalatat

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

Lépésről lépésre útmutató Craft CMS webhelyekhez

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: 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:

  1. Access your Craft CMS project files via FTP, SSH, or your code editor
  2. Navigáljon a templates/ könyvtárba
  3. Keresse meg a fő elrendezési fájlt (általában _layout.twig, _layout.html nevű, vagy a templates/_layouts/ könyvtárban található)
  4. Keresse meg a záró </body> taget
  5. Illessze be az Asyntai beágyazási kódot közvetlenül a </body> tag elé
  6. 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:

  1. Nyissa meg a fő elrendezési sablont
  2. 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 %}
  3. Replace YOUR_WIDGET_ID with your actual widget ID
  4. 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:

  1. Hozzon létre egy új fájlt: templates/_includes/chatbot.twig (vagy .html)
  2. 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>
  3. A fő elrendezési sablonban foglalja bele ezt a fájlt a </body> tag elé:
    {% include '_includes/chatbot' %}
  4. 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:

  1. 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 %}
  2. 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.