Як додати AI чат-бот Asyntai до TYPO3
Покрокова інструкція для вебсайтів TYPO3
Крок 1: Отримайте код для вставки
Спочатку перейдiть до вашої Панелi керування Asyntai та прокрутiть вниз до роздiлу "Код для вставки". Скопiюйте унiкальний код для вставки, який виглядатиме так:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Примiтка: Код вище є лише прикладом. Ви повиннi скопiювати власний унiкальний код для вставки з вашої Панелi керування, оскiльки вiн мiстить ваш особистий ID вiджета.
Крок 2: Використання TypoScript footerData (Рекомендовано)
Найпростіший спосіб додати чат-бот на всі сторінки - використати TypoScript footerData:
- Увійдіть до вашого бекенду TYPO3
- Перейдіть до Web → Template
- Виберіть вашу кореневу сторінку в дереві сторінок
- Натисніть на "Edit the whole template record" (або виберіть "Info/Modify", а потім "Setup")
- У полі Setup додайте наступний код TypoScript:
page.footerData.99 = TEXT
page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Замiнiть
YOUR_WIDGET_IDна фактичний ID вiджету з панелi керування - Натиснiть "Save"
- Очистіть кеш TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Порада: Використання footerData розміщує скрипт безпосередньо перед закриваючим тегом </body>, що рекомендується для чат-віджетів, оскільки це не сповільнить завантаження вашої сторінки.
Альтернатива: Використання Site Package (для Site Packages)
Якщо ви використовуєте site package, ви можете додати скрипт через ваш конфігураційний файл TypoScript:
- Перейдіть до папки вашого site package:
packages/your_sitepackage/Configuration/TypoScript/ - Відкрийте або створіть setup.typoscript
- Додайте наступний код:
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} - Замiнiть
YOUR_WIDGET_IDна ваш фактичний ID вiджету - Очистіть кеш у бекенді TYPO3
Альтернатива: Використання шаблону Fluid (FooterAssets)
For sites using Fluid templates, you can use the FooterAssets section:
- Перейдіть до вашого файлу шаблону Fluid (зазвичай в
Resources/Private/Templates/) - Додайте розділ FooterAssets у ваш макет або шаблон:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - Переконайтеся, що макет вашої сторінки рендерить розділ FooterAssets:
<f:render section="FooterAssets" optional="true" /> - Очистіть кеш TYPO3
Важливо: Функція FooterAssets вимагає TYPO3 v8 або новішу версію. Для старіших версій використовуйте метод TypoScript footerData.
Альтернатива: Використання AssetCollector (для розробників)
Для розробників розширень TYPO3 v10.3+ пропонує API AssetCollector:
- У вашому PHP-коді (наприклад, контролері або middleware) впровадьте AssetCollector
- Додайте скрипт з власними атрибутами:
use TYPO3\CMS\Core\Page\AssetCollector;
$this->assetCollector->addJavaScript(
'asyntai_chatbot',
'https://asyntai.com/static/js/chat-widget.js',
['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
);
Крок 3: Перевiрте встановлення
Пiсля збереження змiн та очищення кешу вiдвiдайте свiй веб-сайт у новiй вкладцi браузера або в режимi iнкогнiто. Ви повиннi побачити кнопку чат-вiджету в нижньому правому кутi. Натиснiть на неї, щоб переконатися, що вона вiдкривається та працює коректно.
Не бачите вiджет? Переконайтеся, що ви очистили всі кеші: перейдіть до Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Також спробуйте очистити кеш браузера або переглянути у вікні інкогніто. Якщо використовуєте TypoScript, перевірте, що ваш шаблон правильно включений в ієрархію сторінок.
Weebly