Înapoi la tabloul de bord

Documentație

Aflați cum să utilizați Asyntai

Cum să adăugați Chatbot-ul AI Asyntai în Craft CMS

Ghid pas cu pas pentru site-urile Craft CMS

Obține codul de încorporare

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:

  1. Accesați fișierele proiectului Craft CMS prin FTP, SSH sau editorul de cod
  2. Navigați la directorul templates/
  3. Găsiți fișierul de layout principal (denumit de obicei _layout.twig, _layout.html, sau localizat în templates/_layouts/)
  4. Găsiți eticheta de închidere </body>
  5. Inserați codul de încorporare Asyntai chiar înainte de eticheta </body>
  6. 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:

  1. Deschideți șablonul de layout principal
  2. 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 %}
  3. Înlocuiți YOUR_WIDGET_ID cu ID-ul real al widget-ului dvs.
  4. 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:

  1. Creați un fișier nou: templates/_includes/chatbot.twig (sau .html)
  2. 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>
  3. În șablonul de layout principal, includeți acest fișier înainte de </body>:
    {% include '_includes/chatbot' %}
  4. 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:

  1. Î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 %}
  2. 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>.