Kako dodati Asyntai AI chatbot na Craft CMS

Vodič 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 predložak rasporeda (Preporučeno)

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

Pristupite datotekama projekta Craft CMS putem FTP-a, SSH-a ili uredivača koda
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 pruža ugrađenu Twig oznaku za registraciju JavaScripta:

Otvorite svoj glavni predložak 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 uključivanje

Za bolju organizaciju, izradite namjensku datoteku za uključivanje:

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 učitavanje

Za učitavanje chatbota samo na određenim stranicama ili odjeljcima:

U svom predlošku 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 određene 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 predloška i uređujete li ispravan predložak rasporeda koji vaše stranice koriste. Očistite predmemoriju preglednika ili pregledavajte u anonimnom prozoru. Ako koristite predmemoriju predložaka, očistite predmemoriju Craft CMS-a iz Upravljačke ploče pod Utilities > Clear Caches.

Lokacija predloška: Lokacije predložaka Craft CMS-a mogu se razlikovati ovisno o postavljanju projekta. Uobičajene lokacije uključuju templates/_layout.twig, templates/_layouts/main.twig ili templates/_base.twig. Provjerite postojeće predloške da pronađete gdje je definirana oznaka </body>.