Как добавить ИИ-чат-бот Asyntai в TYPO3

Пошаговое руководство для сайтов на TYPO3

Платформа:

Шаг 1: Get Your Embed Code

Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:

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

Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.

Шаг 2: Using TypoScript footerData (Recommended)

Самый простой способ добавить чат-бот на все страницы — использовать TypoScript footerData:

Войдите в бэкенд TYPO3
Перейдите в Web → Template
Выберите your root page in the page tree
Нажмите на \"Edit the whole template record\" (or select \"Info/Modify\" and then \"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)

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 версии 8 и выше. Для более старых версий используйте метод TypoScript footerData.

Альтернатива: использование AssetCollector (для разработчиков)

For extension developers, TYPO3 v10.3+ offers the 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: Verify Installation

После сохранения изменений и очистки кэша откройте сайт в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.

Виджет не отображается? Обязательно очистите все кэши: перейдите в Инструменты администратора → Обслуживание → Очистить кэш TYPO3 и PHP. Также попробуйте очистить кэш браузера или открыть сайт в режиме инкогнито. Если используется TypoScript, убедитесь, что шаблон правильно включён в иерархию страниц.