Ako pridať Asyntai AI Chatbot do TYPO3

Podrobný návod pre webové stránky TYPO3

Získať vkladací kód

Krok 1: Ziskajte svoj vkladací kod

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii "Vkladaci kod". Skopirujte svoj jedinečný vkladací kod, ktory bude vyzerat takto:

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

Poznámka: Kod vyššie je len priklad. Musite skopirovat svoj vlastný jedinečný vkladací kod zo svojho Dashboardu, pretože obsahuje vase osobne ID widgetu.

Krok 2: Pomocou TypoScript footerData (Odporúčané)

Najjednoduchší spôsob pridania chatbota na všetky stránky je pomocou TypoScript footerData:

  1. Prihláste sa do svojho backendu TYPO3
  2. Prejdite na Web → Template
  3. Vyberte svoju koreňovú stránku v strome stránok
  4. Kliknite na "Edit the whole template record" (alebo vyberte "Info/Modify" a potom "Setup")
  5. Do poľa Setup pridajte nasledujúci kód 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. Nahradte YOUR_WIDGET_ID vasim skutocnym ID widgetu z dashboardu
  7. Kliknite na "Ulozit"
  8. Vymažte vyrovnávaciu pamäť TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Tip: Použitie footerData umiestni skript tesne pred uzatváraciu značku </body>, čo sa odporúča pre chatové widgety, pretože nespomalí načítanie vašej stránky.

Alternatíva: Pomocou balíka webu (Pre balíky webov)

Ak používate balík webu, môžete pridať skript cez konfiguračný súbor TypoScript:

  1. Prejdite do priečinka balíka webu: packages/your_sitepackage/Configuration/TypoScript/
  2. Otvorte alebo vytvorte setup.typoscript
  3. Pridajte nasledujuci 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. Nahradte YOUR_WIDGET_ID vasim skutocnym ID widgetu
  5. Vymažte vyrovnávaciu pamäť v backende TYPO3

Alternatíva: Pomocou šablóny Fluid (FooterAssets)

Pre weby používajúce šablóny Fluid môžete použiť sekciu FooterAssets:

  1. Prejdite na svoj súbor šablóny Fluid (zvyčajne v Resources/Private/Templates/)
  2. Pridajte sekciu FooterAssets do svojho rozloženia alebo šablóny:
    <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. Uistite sa, že vaše rozloženie stránky vykresľuje sekciu FooterAssets:
    <f:render section="FooterAssets" optional="true" />
  4. Vymažte vyrovnávaciu pamäť TYPO3

Dôležité: Funkcia FooterAssets vyžaduje TYPO3 v8 alebo novší. Pre staršie verzie použite metódu TypoScript footerData.

Alternatíva: Pomocou AssetCollector (Pre vývojárov)

Pre vývojárov rozšírení TYPO3 v10.3+ ponúka API AssetCollector:

  1. Vo vašom PHP kóde (napr. kontroléri alebo middleware) vložte AssetCollector
  2. Pridajte skript s vlastnými atribútmi:
    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: Overenie inštalácie

Po uložení vasich zmien a vymazani vyrovnávacej pamate navštívte svoju webovú stránku v novej karte prehliadača alebo v okne inkognito. Mali by ste vidiet tlačidlo chatoveho widgetu v pravom dolnom rohu. Kliknite nan, aby ste sa uistili, ze sa otvara a funguje správne.

Nevidite widget? Uistite sa, že ste vymazali všetky vyrovnávacie pamäte: prejdite na Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Tiež skúste vymazať vyrovnávaciu pamäť prehliadača alebo zobraziť stránku v okne inkognito. Ak používate TypoScript, overte, že vaša šablóna je správne zahrnutá v hierarchii stránok.