Înapoi la tabloul de bord

Documentație

Aflați cum să utilizați Asyntai

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

Ghid pas cu pas pentru CMS ExpressionEngine

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 în layout-ul șablonului (Recomandat)

Cel mai simplu mod de a adăuga chatbot-ul pe toate paginile este prin editarea șablonului de layout principal în panoul de control ExpressionEngine:

  1. În panoul de control EE, mergeți la Developer > Templates > Template Groups
  2. Deschideți grupul de șabloane principal (de obicei "site") și editați șablonul de layout (sau șablonul care învelește toate paginile)
  3. Găsiți eticheta de închidere </body>
  4. Lipiți codul de integrare Asyntai chiar înainte de eticheta </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Salvați șablonul

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.

Metoda alternativă 1: Utilizarea Template Partials din EE

Template Partials din ExpressionEngine vă permit să creați fragmente reutilizabile care pot fi incluse în toate șabloanele:

  1. Mergeți la Developer > Templates > Template Partials
  2. Faceți clic pe "New" pentru a crea un partial nou numit _asyntai_widget
  3. Lipiți codul de integrare Asyntai în conținutul partial-ului:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Salvați partial-ul
  5. Includeți-l în șablonul de layout chiar înainte de eticheta de închidere </body>:
    {embed="_asyntai_widget"} </body>

Notă: Utilizarea Template Partials menține codul organizat și facilitează actualizarea codului de integrare al chatbot-ului într-un singur loc pe întregul site.

Metoda alternativă 2: Utilizarea Header/Footer HTML din EE

Unele configurații ExpressionEngine oferă o secțiune de subsol globală pentru adăugarea scripturilor:

  1. Mergeți la Settings > Content & Design > Global Template Preferences
  2. Dacă configurația dvs. EE are o secțiune de subsol globală, lipiți codul de integrare Asyntai acolo
  3. Dacă nu este disponibilă nicio secțiune de subsol globală, editați direct șablonul de layout principal și adăugați codul de integrare înainte de eticheta de închidere </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Salvați modificările

Metoda alternativă 3: Utilizarea config.php

Pentru utilizatorii avansați, puteți injecta scriptul chatbot-ului prin configurația ExpressionEngine sau prin crearea unui add-on personalizat:

  1. Accesați fișierele proiectului ExpressionEngine prin FTP, SSH sau editorul de cod
  2. Navigați la directorul system/user/config/ și deschideți config.php
  3. Pentru injectarea JavaScript personalizat, luați în considerare crearea unui add-on/extensie EE simplă care se conectează la hook-ul template_post_parse pentru a injecta scriptul la randarea paginii:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Înlocuiți YOUR_WIDGET_ID cu ID-ul real al widget-ului din tabloul de bord

Important: Metoda config.php și add-on este destinată utilizatorilor avansați familiarizați cu dezvoltarea ExpressionEngine. Pentru majoritatea utilizatorilor, se recomandă metoda layout-ului de șablon (Pasul 2) sau metoda Template Partials (Metoda alternativă 1).

Pasul 3: Verificați instalarea

După ce ați salvat modificările, vizitați site-ul ExpressionEngine î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 șablonul ș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ă cache-ul de șabloane ExpressionEngine este activat, goliți cache-ul din panoul de control la Developer > Utilities > Cache Manager.