Cum să adăugați Chatbot-ul AI Asyntai în Craft CMS
Ghid pas cu pas pentru site-urile Craft CMS
Pasul 1: Obțineți codul de încorporare
Mai întâi, accesați Tabloul de bord Asyntai și derulați în jos până la secțiunea "Cod de încorporare". Copiați codul unic de încorporare care va arăta astfel:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %} - Sau verificați secțiuni specifice:
{% 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 %}
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