Как да добавите 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: Редактирайте вашия шаблон за оформление (Препоръчително)
Най-лесният начин да добавите чатбота към всички страници е като редактирате основния си шаблон за оформление:
- Access your Craft CMS project files via FTP, SSH, or your code editor
- Навигирайте до директорията
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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Във вашия основен шаблон за оформление включете този файл преди
</body>:{% include '_includes/chatbot' %} - Запазете и двата файла
Съвет: Използването на включваем файл улеснява активирането/деактивирането на чатбота в целия ви сайт чрез коментиране на един ред.
Алтернатива: Условно зареждане
За зареждане на чатбота само на определени страници или секции:
- 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 %} - Или проверете за конкретни секции:
{% 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>.
Weebly