Как добавить ИИ-чат-бот Asyntai в TYPO3
Пошаговое руководство для сайтов на TYPO3
Шаг 1: Получите код встраивания
Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.
Шаг 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> - Замените
YOUR_WIDGET_IDна ваш реальный ID виджета из панели управления - Нажмите «Save»
- Очистить кэш TYPO3: Инструменты администратора → Обслуживание → Сбросить кэш TYPO3 и PHP
Совет: Использование footerData размещает скрипт непосредственно перед закрывающим тегом </body>, что рекомендуется для виджетов чата, так как не замедляет загрузку страницы.
Альтернатива: использование пакета сайта (для пакетов сайтов)
Если вы используете пакет сайта, вы можете добавить скрипт через конфигурационный файл TypoScript:
- Перейдите в папку пакета вашего сайта:
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>
} - Замените
YOUR_WIDGET_IDна ваш реальный ID виджета - Очистить кэш в бэкенде TYPO3
Альтернатива: Через Fluid Template (FooterAssets)
Для сайтов, использующих шаблоны Fluid, вы можете использовать раздел FooterAssets:
- Перейдите к файлу шаблона 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 версии 8 и выше. Для более старых версий используйте метод TypoScript footerData.
Альтернатива: использование AssetCollector (для разработчиков)
Для разработчиков расширений TYPO3 v10.3+ предлагает AssetCollector API:
- В 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: Проверка установки
После сохранения изменений и очистки кэша откройте сайт в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.
Виджет не отображается? Обязательно очистите все кэши: перейдите в Инструменты администратора → Обслуживание → Очистить кэш TYPO3 и PHP. Также попробуйте очистить кэш браузера или открыть сайт в режиме инкогнито. Если используется TypoScript, убедитесь, что шаблон правильно включён в иерархию страниц.
Weebly