Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Jak dodać chatbota AI Asyntai do TYPO3

Instrukcja krok po kroku dla stron TYPO3

Pobierz kod osadzania

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:

  1. Zaloguj sie do panelu TYPO3 Backend
  2. Przejdź do Web → Template
  3. Wybierz stronę główna w drzewie stron
  4. Kliknij "Edit the whole template record" (lub wybierz "Info/Modify", a następnie "Setup")
  5. 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>
  6. Zamien YOUR_WIDGET_ID na rzeczywisty identyfikator widgetu z panelu sterowania
  7. Kliknij "Save"
  8. 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:

  1. Przejdź do folderu pakietu witryny: packages/your_sitepackage/Configuration/TypoScript/
  2. Otwórz lub utwórz plik setup.typoscript
  3. 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>
    }
  4. Replace YOUR_WIDGET_ID with your actual widget ID
  5. Wyczyść pamięć podręczna w panelu TYPO3

Alternatywa: Użycie szablonu Fluid (FooterAssets)

For sites using Fluid templates, you can use the FooterAssets section:

  1. Przejdź do pliku szablonu Fluid (zwykle w Resources/Private/Templates/)
  2. 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>
  3. Upewnij sie, ze uklad strony renderuje sekcję FooterAssets:
    <f:render section="FooterAssets" optional="true" />
  4. 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:

  1. W swoim kodzie PHP (np. kontrolerze lub middleware) wstrzyknij AssetCollector
  2. 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.