Jak dodać chatbota AI Asyntai do TYPO3
Instrukcja krok po kroku dla stron TYPO3
Krok 1: Pobierz swój kod osadzania
Najpierw przejdź do swojego Panelu Asyntai i przewiń w dół do sekcji "Kod osadzania". Skopiuj swój unikalny kod osadzania, który będzie wyglądał tak:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Uwaga: Powyższy kod to tylko przykład. Musisz skopiować swój własny unikalny kod osadzania z Panelu, ponieważ zawiera on Twój osobisty identyfikator widgetu.
Krok 2: Użycie TypoScript footerData (zalecane)
Najłatwiejszym sposobem dodania chatbota do wszystkich stron jest użycie TypoScript footerData:
- Zaloguj sie do panelu TYPO3 Backend
- Przejdź do Web → Template
- Wybierz stronę główna w drzewie stron
- Kliknij "Edit the whole template record" (lub wybierz "Info/Modify", a następnie "Setup")
- W polu Setup dodaj następujący kod 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> - Zamien
YOUR_WIDGET_IDna rzeczywisty identyfikator widgetu z panelu sterowania - Kliknij "Save"
- Wyczyść pamięć podręczna TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Wskazówka: Użycie footerData umieszcza skrypt tuz przed zamykającym znacznikiem </body>, co jest zalecane dla widgetów czatu, ponieważ nie spowalnia ładowania strony.
Alternatywa: Użycie pakietu witryny (dla pakietów witryn)
Jeśli korzystasz z pakietu witryny, możesz dodać skrypt za pomocą pliku konfiguracyjnego TypoScript:
- Przejdź do folderu pakietu witryny:
packages/your_sitepackage/Configuration/TypoScript/ - Otwórz lub utwórz plik setup.typoscript
- Dodaj następujący kod:
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} - Replace
YOUR_WIDGET_IDwith your actual widget ID - Wyczyść pamięć podręczna w panelu TYPO3
Alternatywa: Użycie szablonu Fluid (FooterAssets)
For sites using Fluid templates, you can use the FooterAssets section:
- Przejdź do pliku szablonu Fluid (zwykle w
Resources/Private/Templates/) - Dodaj sekcję FooterAssets w swoim ukladzie lub szablonie:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - Upewnij sie, ze uklad strony renderuje sekcję FooterAssets:
<f:render section="FooterAssets" optional="true" /> - Wyczyść pamięć podręczna TYPO3
Ważne: Funkcja FooterAssets wymaga TYPO3 w wersji 8 lub nowszej. Dla starszych wersji użyj metody TypoScript footerData.
Alternatywa: Użycie AssetCollector (dla programistów)
For extension developers, TYPO3 v10.3+ offers the AssetCollector API:
- W swoim kodzie PHP (np. kontrolerze lub middleware) wstrzyknij AssetCollector
- Dodaj skrypt z wlasnymi atrybutami:
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']
);
Krok 3: Weryfikacja instalacji
Po zapisaniu zmian i wyczyszczeniu pamięci podręcznej odwiedź witrynę w nowej karcie przeglądarki lub w trybie incognito. Przycisk widgetu czatu powinien byc widoczny w prawym dolnym rogu. Kliknij go, aby upewnić sie, ze otwiera sie i działa poprawnie.
Nie widzisz widgetu? Upewnij sie, ze wyczysciles wszystkie pamięci podreczne: przejdź do Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Spróbuj również wyczyścić pamięć podręczna przeglądarki lub otworzyc stronę w oknie incognito. Jeśli używasz TypoScript, sprawdź, czy szablon jest prawidlowo dołączony do hierarchii stron.
Weebly