Обратно към таблото

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

Научете как да използвате Asyntai

Как да добавите Asyntai AI чатбот в Craft CMS

Ръководство стъпка по стъпка за уебсайтове на Craft CMS

Вземете код за вграждане

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

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

Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.

Стъпка 2: Редактирайте вашия шаблон за оформление (Препоръчително)

Най-лесният начин да добавите чатбота към всички страници е като редактирате основния си шаблон за оформление:

  1. Access your Craft CMS project files via FTP, SSH, or your code editor
  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 с вашия действителен 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. In your layout or page template, use Twig conditionals:
    {% 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 от контролния панел под Utilities > Clear Caches.

Местоположение на шаблона: Местоположенията на шаблоните на Craft CMS могат да варират в зависимост от настройката на вашия проект. Обичайните местоположения включват templates/_layout.twig, templates/_layouts/main.twig или templates/_base.twig. Проверете съществуващите си шаблони, за да намерите къде е дефиниран тагът </body>.