Kako dodati Asyntai AI chatbot na Craft CMS

Vodic korak po korak za Craft CMS web stranice

Platforma:

Korak 1: Nabavite svoj kod za ugradnju

Prvo idite na svoju Asyntai nadzornu ploču i pomaknite se prema dolje do odjeljka "Kod za ugradnju". Kopirajte svoj jedinstveni kod za ugradnju koji će izgledati ovako:

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

Napomena: Gornji kod je samo primjer. Morate kopirati svoj vlastiti jedinstveni kod za ugradnju sa svoje Nadzorne ploče jer sadrži vaš osobni ID widgeta.

Korak 2: Uredite predlozak rasporeda (Preporuceno)

Najlaksi nacin za dodavanje chatbota na sve stranice je uredivanje glavnog predloska rasporeda:

Access your Craft CMS project files via FTP, SSH, or your code editor
Navigirajte do direktorija templates/
Pronadite svoju glavnu datoteku rasporeda (obicno nazvanu _layout.twig, _layout.html ili smjestenu u templates/_layouts/)
Pronađite zatvarajuću oznaku </body>
Zalijepite svoj Asyntai kod za ugradnju neposredno prije oznake </body>
Spremite datoteku

Savjet: Dodavanje skripte prije zavrsne oznake </body> osigurava ucitavanje nakon sadrzaja stranice, sto je preporuceno za widgete za razgovor i nece usporiti ucitavanje stranice.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS pruza ugradenu Twig oznaku za registraciju JavaScripta:

Otvorite svoj glavni predlozak rasporeda
Dodajte sljedeci kod prije zavrsne oznake </body>:
{% 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 %}
Zamijenite YOUR_WIDGET_ID svojim stvarnim ID-jem widgeta
Spremite datoteku

Napomena: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternativa: Izradite zasebnu datoteku za ukljucivanje

Za bolju organizaciju, izradite namjensku datoteku za ukljucivanje:

Izradite novu datoteku: templates/_includes/chatbot.twig (ili .html)
Dodajte svoj Asyntai ugradni kod u ovu datoteku:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
U svom glavnom predlosku rasporeda ukljucite ovu datoteku prije </body>:
{% include '_includes/chatbot' %}
Spremite obje datoteke

Savjet: Koristenje datoteke za ukljucivanje olaksava omogucavanje/onemogucavanje chatbota na cijeloj stranici komentiranjem jednog retka.

Alternativa: Uvjetno ucitavanje

Za ucitavanje chatbota samo na odredenim stranicama ili odjeljcima:

U svom predlosku rasporeda ili stranice koristite Twig uvjete:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Ili provjerite odredene odjeljke:
{% 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 %}

Korak 3: Provjerite instalaciju

Nakon spremanja promjena, posjetite svoju Craft CMS web stranicu u novoj kartici preglednika ili anonimnom prozoru. Trebali biste vidjeti gumb widgeta za razgovor u donjem desnom kutu. Kliknite ga kako biste provjerili otvara li se i radi li ispravno.

Ne vidite widget? Provjerite jeste li spremili datoteku predloska i uredujete li ispravan predlozak rasporeda koji vase stranice koriste. Ocistite predmemoriju preglednika ili pregledavajte u anonimnom prozoru. Ako koristite predmemoriju predlozaka, ocistite predmemoriju Craft CMS-a iz Upravljacke ploce pod Utilities > Clear Caches.

Lokacija predloska: Lokacije predlozaka Craft CMS-a mogu se razlikovati ovisno o postavljanju projekta. Uobicajene lokacije ukljucuju templates/_layout.twig, templates/_layouts/main.twig ili templates/_base.twig. Provjerite postojece predloske da pronadete gdje je definirana oznaka </body>.