Як додати AI чат-бот Asyntai до Craft CMS
Покрокова інструкція для веб-сайтів Craft CMS
Крок 1: Отримайте код для вставки
Спочатку перейдіть до своєї панелі керування Asyntai і прокрутіть вниз до розділу "Код вбудовування". Скопіюйте свій унікальний код вбудовування, який виглядає так:
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
Примітка: Код вище є лише прикладом. Ви повинні скопіювати власний унікальний код для вставки з вашої Панелі керування, оскільки він містить ваш особистий ID віджета.
Крок 2: Редагування шаблону макету (Рекомендовано)
Найпростіший спосіб додати чат-бот на всі сторінки - це редагування головного шаблону макету:
- Отримайте доступ до файлів проекту Craft CMS через FTP, SSH або ваш редактор коду
- Перейдіть до каталогу
templates/ - Знайдіть головний файл макету (зазвичай називається
_layout.twig,_layout.htmlабо знаходиться вtemplates/_layouts/) - Знайдіть закриваючий тег
</body> - Вставте ваш код для вставки Asyntai безпосередньо перед тегом
</body> - Збережіть файл
Порада: Додавання скрипту перед закриваючим тегом </body> забезпечує його завантаження після контенту сторінки, що рекомендується для чат-віджетів і не сповільнює завантаження сторінки.
Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)
Craft CMS надає вбудований тег Twig для реєстрації JavaScript:
- Відкрийте головний шаблон макету
- Додайте наступний код перед закриваючим тегом
</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 %} - Замініть
YOUR_WIDGET_IDна ваш фактичний ID віджету - Збережіть файл
Примітка: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.
Альтернатива: Створення окремого файлу включення
Для кращої організації створіть окремий файл включення:
- Створіть новий файл:
templates/_includes/chatbot.twig(або.html) - Додайте код вбудовування Asyntai до цього файлу:
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> - У головному шаблоні макету включіть цей файл перед
</body>:{% include '_includes/chatbot' %} - Збережіть обидва файли
Порада: Використання файлу включення дозволяє легко увімкнути або вимкнути чат-бот на всьому сайті, закоментувавши один рядок.
Альтернатива: Умовне завантаження
Щоб завантажити чат-бот лише на певних сторінках або в певних розділах:
- У вашому шаблоні макету або сторінки використовуйте умови Twig:
{% if entry.showChatbot ?? true %} <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% endif %} - Або перевірте конкретні розділи:
{% if craft.app.request.segments[0] != 'admin' %} <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% endif %}
Крок 3: Перевірте встановлення
Після збереження змін відвідайте свій веб-сайт Craft CMS у новій вкладці браузера або в режимі інкогніто. Ви повинні побачити кнопку чат-віджету в нижньому правому куті. Натисніть на неї, щоб переконатися, що вона відкривається та працює коректно.
Не бачите віджет? Переконайтеся, що ви зберегли файл шаблону та що ви редагуєте правильний шаблон макету, який використовують ваші сторінки. Очистіть кеш браузера або перегляньте в режимі інкогніто. Якщо використовується кешування шаблонів, очистіть кеш Craft CMS з панелі керування в розділі Utilities > Clear Caches.
Розташування шаблону: Розташування шаблонів Craft CMS може відрізнятися залежно від налаштувань вашого проекту. Типові місця включають templates/_layout.twig, templates/_layouts/main.twig або templates/_base.twig. Перевірте існуючі шаблони, щоб знайти, де визначений тег </body>.
Weebly