Назад на контролну таблу

Документација

Научите како да користите Asyntai

Како додати Asyntai АИ четбот у Craft CMS

Водич корак по корак за Craft CMS веб-сајтове

Преузмите код за уградњу

Корак 1: Набавите свој код за уграђивање

Прво, идите на своју Asyntai контролну таблу и померите се до одељка „Код за уграђивање". Копирајте свој јединствени код за уграђивање који ће изгледати овако:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Напомена: Код изнад је само пример. Морате копирати свој јединствени код за уграђивање са своје Контролне табле јер садржи ваш лични ИД виџета.

Корак 2: Уредите свој шаблон распореда (препоручено)

Најлакши начин за додавање четбота на све странице је уређивањем главног шаблона распореда:

  1. Приступите фајловима Craft CMS пројекта путем FTP, SSH или уређивача кода
  2. Навигирајте до templates/ директоријума
  3. Пронађите свој главни фајл распореда (обично назван _layout.twig, _layout.html или налази се у templates/_layouts/)
  4. Пронађите затварајућу </body> ознаку
  5. Налепите свој Asyntai код за уграђивање непосредно пре </body> ознаке
  6. Сачувајте фајл

Савет: Додавање скрипте пре затварајуће </body> ознаке осигурава да се учитава након садржаја странице, што је препоручено за виџете за ћаскање и неће успорити учитавање странице.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS обезбеђује уграђену Twig ознаку за регистровање JavaScript-а:

  1. Отворите свој главни шаблон распореда
  2. Додајте следећи код пре затварајуће </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. Замените YOUR_WIDGET_ID стварним ИД-ом виџета
  4. Сачувајте фајл

Напомена: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Алтернатива: Креирајте засебан фајл за укључивање

За бољу организацију, креирајте наменски фајл за укључивање:

  1. Креирајте нови фајл: templates/_includes/chatbot.twig (или .html)
  2. Додајте свој Asyntai код за уграђивање у овај фајл:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  3. У свом главном шаблону распореда, укључите овај фајл пре </body>:
    {% include '_includes/chatbot' %}
  4. Сачувајте оба фајла

Савет: Коришћење фајла за укључивање олакшава омогућавање/онемогућавање четбота на целом сајту коментарисањем једне линије.

Алтернатива: Условно учитавање

За учитавање четбота само на одређеним страницама или одељцима:

  1. У свом шаблону распореда или странице, користите 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. Или проверите за одређене одељке:
    {% 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 %}

Корак 3: Верификујте инсталацију

Након чувања промена, посетите свој Craft CMS веб-сајт у новој картици претраживача или инкогнито прозору. Требало би да видите дугме виџета за ћаскање у доњем десном углу. Кликните на њега да бисте се уверили да се отвара и исправно ради.

Не видите виџет? Уверите се да сте сачували фајл шаблона и да уређујете тачан шаблон распореда који ваше странице користе. Обришите кеш претраживача или прегледајте у инкогнито прозору. Ако користите кеширање шаблона, обришите Craft CMS кеш из контролног панела под Алатке > Обриши кешеве.

Локација шаблона: Локације шаблона Craft CMS-а могу варирати у зависности од подешавања вашег пројекта. Уобичајене локације укључују templates/_layout.twig, templates/_layouts/main.twig или templates/_base.twig. Проверите постојеће шаблоне да пронађете где је </body> ознака дефинисана.