Kaip pridėti Asyntai DI pokalbių robotą prie Craft CMS

Žingsnis po žingsnio vadovas Craft CMS svetainėms

Platforma:

1 žingsnis: Gaukite savo įterpimo kodą

Pirma, eikite į savo Asyntai valdymo skydelį ir slinkite žemyn iki "Įterpimo kodas" skyriaus. Nukopijuokite savo unikalų įterpimo kodą, kuris atrodys taip:

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

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

2 žingsnis: Redaguokite savo išdėstymo šabloną (Rekomenduojama)

Paprasčiausias būdas pridėti pokalbių robotą prie visų puslapių yra redaguoti pagrindinį išdėstymo šabloną:

Access your Craft CMS project files via FTP, SSH, or your code editor
Eikite į templates/ katalogą
Raskite pagrindinį išdėstymo failą (dažniausiai vadinamą _layout.twig, _layout.html arba esantį templates/_layouts/)
Raskite uždaromąjį </body> žymą
Įklijuokite savo Asyntai įterpimo kodą prieš </body> žymą
Išsaugokite failą

Patarimas: Skripto pridėjimas prieš uždaromąjį </body> žymą užtikrina, kad jis krausis po puslapio turinio, o tai rekomenduojama pokalbių valdikliams ir nesulėtins puslapio įkrovimo.

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

Craft CMS turi integruotą Twig žymą JavaScript registravimui:

Atidarykite pagrindinį išdėstymo šabloną
Pridėkite šį kodą prieš uždaromąjį </body> žymą:
{% 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 %}
Pakeiskite YOUR_WIDGET_ID savo tikruoju valdiklio ID
Išsaugokite failą

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

Alternatyva: Sukurkite atskirą įtraukimo failą

Geresnei organizacijai sukurkite skirtą įtraukimo failą:

Sukurkite naują failą: templates/_includes/chatbot.twig (arba .html)
Pridėkite savo Asyntai įterpimo kodą į šį failą:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Pagrindiniame išdėstymo šablone įtraukite šį failą prieš </body>:
{% include '_includes/chatbot' %}
Išsaugokite abu failus

Patarimas: Įtraukimo failo naudojimas palengvina pokalbių roboto įjungimą/išjungimą visoje svetainėje, užkomentuojant vieną eilutę.

Alternatyva: Sąlyginis įkrovimas

Norėdami įkelti pokalbių robotą tik konkrečiuose puslapiuose ar skyriuose:

Išdėstymo ar puslapio šablone naudokite Twig sąlygas:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Arba tikrinkite konkrečius skyrius:
{% 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 žingsnis: Patikrinkite diegimą

Išsaugoję pakeitimus, apsilankykite savo Craft CMS svetainėje naujame naršyklės skirtuke arba inkognito lange. Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe. Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai.

Nematote valdiklio? Įsitikinkite, kad išsaugojote šablono failą ir kad redaguojate teisingą išdėstymo šabloną, kurį naudoja jūsų puslapiai. Išvalykite naršyklės talpyklą arba peržiūrėkite inkognito lange. Jei naudojate šablonų talpyklą, išvalykite Craft CMS talpyklą iš Valdymo skydelio po Įrankiai > Išvalyti talpyklas.

Šablono vieta: Craft CMS šablonų vietos gali skirtis priklausomai nuo projekto konfigūracijos. Dažnos vietos yra templates/_layout.twig, templates/_layouts/main.twig arba templates/_base.twig. Patikrinkite esamus šablonus, kad rastumėte, kur apibrėžtas </body> žymas.