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 się do panelu TYPO3 Backend
- Przejdź do Web → Template
- Wybierz stronę główną 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>
} - Zamień
YOUR_WIDGET_IDna rzeczywisty identyfikator widgetu - Wyczyść pamięć podręczną w panelu TYPO3
Alternatywa: Użycie szablonu Fluid (FooterAssets)
W przypadku witryn korzystających z szablonów Fluid można użyć sekcji FooterAssets:
- Przejdź do pliku szablonu Fluid (zwykle w
Resources/Private/Templates/) - Dodaj sekcję FooterAssets w swoim układzie 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 się, że układ strony renderuje sekcję FooterAssets:
<f:render section="FooterAssets" optional="true" /> - Wyczyść pamięć podręczną 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)
Dla twórców rozszerzeń, TYPO3 v10.3+ oferuje AssetCollector API:
- W swoim kodzie PHP (np. kontrolerze lub middleware) wstrzyknij AssetCollector
- Dodaj skrypt z własnymi 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 być widoczny w prawym dolnym rogu. Kliknij go, aby upewnić się, że otwiera się i działa poprawnie.
Nie widzisz widgetu? Upewnij się, że wyczyściłeś wszystkie pamięci podręczne: przejdź do Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Spróbuj również wyczyścić pamięć podręczną przeglądarki lub otworzyć stronę w oknie incognito. Jeśli używasz TypoScript, sprawdź, czy szablon jest prawidłowo dołączony do hierarchii stron.
Weebly