Jak přidat Asyntai AI chatbota do TYPO3

Průvodce krok za krokem pro weby TYPO3

Získat kód pro vložení

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Použití TypoScript footerData (doporučeno)

Nejjednodušší způsob, jak přidat chatbota na všechny stránky, je použití TypoScript footerData:

  1. Přihlaste se do svého backendu TYPO3
  2. Přejděte na Web → Šablona
  3. Vyberte svou kořenovou stránku ve stromu stránek
  4. Klikněte na "Upravit celý záznam šablony" (nebo vyberte "Info/Modify" a poté "Setup")
  5. Do pole Setup přidejte následující 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. Nahraďte YOUR_WIDGET_ID skutečným ID widgetu z dashboardu
  7. Klikněte na "Save"
  8. Vymažte mezipaměť TYPO3: Nástroje správce → Údržba → Vymazat mezipaměť TYPO3 a PHP

Tip: Použití footerData umístí skript těsně před uzavírací tag </body>, což je doporučeno pro chatovací widgety, protože to nezpomalí načítání stránky.

Alternativa: Použití balíčku webu (pro balíčky webu)

Pokud používáte balíček webu, můžete skript přidat prostřednictvím svého konfiguračního souborů TypoScript:

  1. Přejděte do složky svého balíčku webu: packages/your_sitepackage/Configuration/TypoScript/
  2. Otevřete nebo vytvořte setup.typoscript
  3. Přidejte následující kód:
    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. Nahraďte YOUR_WIDGET_ID svým skutečným ID widgetu
  5. Vymažte mezipaměť v backendu TYPO3

Alternativa: Použití šablony Fluid (FooterAssets)

Pro weby používající šablony Fluid můžete použít sekci FooterAssets:

  1. Přejděte ke svému souborů šablony Fluid (obvykle v Resources/Private/Templates/)
  2. Přidejte sekci FooterAssets do svého layoutu nebo šablony:
    <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. Ujistěte se, že váš layout stránky vykresluje sekci FooterAssets:
    <f:render section="FooterAssets" optional="true" />
  4. Vymažte mezipaměť TYPO3

Důležité: Funkce FooterAssets vyžaduje TYPO3 v8 nebo novější. Pro starší verze použijte metodu TypoScript footerData.

Alternativa: Použití AssetCollector (pro vývojáře)

Pro vývojáře rozšíření nabízí TYPO3 v10.3+ AssetCollector API:

  1. Ve svém PHP kódu (např. controller nebo middleware) vložte AssetCollector
  2. Přidejte skript s vlastními atributy:
    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: Ověřte instalaci

Po uložení změn a vymazání mezipaměti navštivte svůj web v nové záložce prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatovacího widgetu. Klikněte na něj a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Nezapomeňte vymazat všechny mezipaměti: přejděte na Nástroje správce → Údržba → Vymazat mezipaměť TYPO3 a PHP. Zkuste také vymazat mezipaměť prohlížeče nebo web zobrazit v anonymním okně. Pokud používáte TypoScript, ověřte, že je vaše šablona správně zahrnuta v hierarchii stránek.