Înapoi la tabloul de bord

Documentație

Aflați cum să utilizați Asyntai

Cum să adăugați chatbot-ul AI Asyntai pe Concrete CMS

Ghid pas cu pas pentru site-uri Concrete CMS (fost Concrete5)

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: Adăugați codul în footer-ul temei (recomandat)

Cea mai bună modalitate de a adăuga chatbotul pe toate paginile site-ului dvs. Concrete CMS este prin editarea fișierului footer al temei:

  1. Accesați instalarea Concrete CMS prin FTP sau Manager de fișiere
  2. Navigați la directorul /application/themes/your_theme_name/
  3. Localizați și deschideți fișierul footer.php (sau șablonul echivalent de footer)
  4. Găsiți linia cu eticheta de închidere </body>
  5. Inserați codul de încorporare Asyntai chiar înainte de eticheta </body>
  6. Salvați fișierul și încărcați-l înapoi pe server dacă editați local
  7. Goliți cache-ul Concrete CMS: Dashboard → System & Settings → Clear Cache

Sfat: Adăugarea codului înainte de eticheta de închidere </body> asigură că chatbotul se încarcă după conținutul paginii, ceea ce oferă performanță mai bună de încărcare. Această metodă adaugă automat chatbotul pe fiecare pagină care folosește această temă.

Metoda alternativă 1: Bloc HTML (cea mai ușoară pentru non-dezvoltatori)

Dacă preferați să nu editați fișierele de temă, puteți utiliza blocul HTML integrat al Concrete CMS:

  1. Conectați-vă la Tabloul de bord Concrete CMS
  2. Navigați la pagina unde doriți să adăugați chatbotul
  3. Faceți clic pe Edit Page (pictograma creion din bara de instrumente)
  4. Faceți clic pe Adaugă bloc în zona unde doriți să plasați codul
  5. Căutați și selectați blocul HTML
  6. Inserați codul de încorporare Asyntai în editorul HTML
  7. Faceți clic pe Adaugă pentru a salva blocul
  8. Faceți clic pe Publicare pentru a face modificările active

Notă: Metoda blocului HTML este excelentă pentru adăugarea chatbotului pe pagini specifice. Pentru instalarea pe tot site-ul, va trebui să adăugați blocul HTML pe fiecare pagină sau să utilizați metoda footer-ului de temă descrisă mai sus. Plasarea vizuală a blocului nu afectează locul unde apare chatbotul - va apărea în continuare în colțul din dreapta jos.

Metoda alternativă 2: Fișierul header al temei

De asemenea, puteți adăuga codul în fișierul header al temei dvs. pentru instalare pe tot site-ul:

  1. Accesați fișierele Concrete CMS prin FTP sau Manager de fișiere
  2. Navigați la /application/themes/your_theme_name/
  3. Deschideți fișierul header.php (sau elements/header.php)
  4. Găsiți eticheta de închidere </head>
  5. Lipiți codul de integrare Asyntai chiar înainte de eticheta </head>
  6. Salvați și încărcați fișierul
  7. Goliți cache-ul din Tabloul de bord
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </head>

Sfat: Asigurați-vă că includeți elementele de header necesare folosind <?php View::element('header_required'); ?> în fișierul header.php pentru ca Concrete CMS să funcționeze corect.

Metoda alternativă 3: Șablon personalizat (Avansat)

Pentru dezvoltatorii care doresc mai mult control, puteți crea un șablon de pagină personalizat:

  1. Creați un fișier de șablon de pagină nou în /application/themes/your_theme_name/
  2. Sau copiați un șablon existent (de ex., default.php) și redenumiți-l
  3. Adăugați codul de integrare Asyntai în fișierul șablon înainte de </body>
  4. În Tabloul de bord Concrete CMS, mergeți la Pages & Themes
  5. Faceți clic pe Page Types
  6. Selectați tipul de pagină cu care doriți să utilizați acest șablon
  7. Atribuiți șablonul personalizat tipului de pagină
  8. Toate paginile care folosesc acest tip de pagină vor include acum chatbot-ul

Important: Faceți întotdeauna o copie de siguranță a fișierelor temei înainte de a face modificări. Testați modificările pe un site de staging mai întâi, dacă este posibil. Editările incorecte ale fișierelor temei pot afecta aspectul sau funcționalitatea site-ului dvs.

Pasul 3: Verificați instalarea

După ce ați făcut modificările și ați golit cache-ul, deschideți site-ul dvs. î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 golit cache-ul Concrete CMS (Dashboard → System & Settings → Clear Cache). Încercați să vizualizați site-ul într-o fereastră incognito. Verificați că ați salvat și încărcat toate modificările fișierelor. Deschideți consola browserului (F12) pentru a verifica eventualele erori JavaScript.