Jak přidat Asyntai AI chatbota do TYPO3
Průvodce krok za krokem pro weby TYPO3
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:
- Přihlaste se do svého backendu TYPO3
- Přejděte na Web → Šablona
- Vyberte svou kořenovou stránku ve stromu stránek
- Klikněte na "Upravit celý záznam šablony" (nebo vyberte "Info/Modify" a poté "Setup")
- 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> - Nahraďte
YOUR_WIDGET_IDskutečným ID widgetu z dashboardu - Klikněte na "Save"
- 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:
- Přejděte do složky svého balíčku webu:
packages/your_sitepackage/Configuration/TypoScript/ - Otevřete nebo vytvořte setup.typoscript
- 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>
} - Nahraďte
YOUR_WIDGET_IDsvým skutečným ID widgetu - 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:
- Přejděte ke svému souborů šablony Fluid (obvykle v
Resources/Private/Templates/) - 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> - Ujistěte se, že váš layout stránky vykresluje sekci FooterAssets:
<f:render section="FooterAssets" optional="true" /> - 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:
- Ve svém PHP kódu (např. controller nebo middleware) vložte AssetCollector
- 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.
Weebly