Cum să adăugați chatbot-ul AI Asyntai pe Craft CMS
Ghid pas cu pas pentru site-urile Craft CMS
Pasul 1: Obțineți codul de încorporare
Mai întâi, accesați panoul de control Asyntai și derulați în jos până la secțiunea "Cod de integrare". Copiați codul dvs. unic de integrare, care va arăta astfel:
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.
Pasul 2: Editați șablonul de layout (Recomandat)
Cel mai simplu mod de a adăuga chatbot-ul pe toate paginile este prin editarea șablonului de layout principal:
- Accesați fișierele proiectului Craft CMS prin FTP, SSH sau editorul de cod
- Navigați la directorul
templates/ - Găsiți fișierul de layout principal (denumit de obicei
_layout.twig,_layout.html, sau localizat întemplates/_layouts/) - Găsiți eticheta de închidere
</body> - Inserați codul de încorporare Asyntai chiar înainte de eticheta
</body> - Salvați fișierul
Sfat: Adăugarea scriptului înainte de eticheta de închidere </body> asigură că se încarcă după conținutul paginii, ceea ce este recomandat pentru widget-urile de chat și nu va încetini încărcarea paginii.
Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)
Craft CMS oferă o etichetă Twig integrată pentru înregistrarea JavaScript:
- Deschideți șablonul de layout principal
- Adăugați următorul cod înainte de eticheta de închidere
</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 %} - Înlocuiți
YOUR_WIDGET_IDcu ID-ul real al widget-ului dvs. - Salvați fișierul
Notă: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.
Alternativă: Creați un fișier include separat
Pentru o organizare mai bună, creați un fișier include dedicat:
- Creați un fișier nou:
templates/_includes/chatbot.twig(sau.html) - Adăugați codul de integrare Asyntai în acest fișier:
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> - În șablonul de layout principal, includeți acest fișier înainte de
</body>:{% include '_includes/chatbot' %} - Salvați ambele fișiere
Sfat: Utilizarea unui fișier include facilitează activarea/dezactivarea chatbot-ului pe întregul site prin comentarea unei singure linii.
Alternativă: Încărcare condiționată
Pentru a încărca chatbot-ul doar pe anumite pagini sau secțiuni:
- În șablonul de layout sau de pagină, utilizați condiționale Twig:
{% if entry.showChatbot ?? true %} <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% endif %} - Sau verificați secțiuni specifice:
{% if craft.app.request.segments[0] != 'admin' %} <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% endif %}
Pasul 3: Verificați instalarea
După ce ați salvat modificările, vizitați site-ul Craft CMS într-o filă nouă de browser sau într-o fereastră incognito. Ar trebui să vedeți butonul widget-ului de chat în colțul din dreapta jos. Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect.
Nu vedeți widgetul? Asigurați-vă că ați salvat fișierul șablon și că editați șablonul de layout corect pe care îl folosesc paginile dvs. Goliți cache-ul browserului sau vizualizați într-o fereastră incognito. Dacă utilizați cache-ul de șabloane, goliți cache-ul Craft CMS din Panoul de control la Utilities > Clear Caches.
Locația șablonului: Locațiile șabloanelor Craft CMS pot varia în funcție de configurația proiectului dvs. Locațiile comune includ templates/_layout.twig, templates/_layouts/main.twig sau templates/_base.twig. Verificați șabloanele existente pentru a găsi unde este definită eticheta </body>.
Weebly