Ako pridať Asyntai AI Chatbot do TYPO3
Podrobný návod pre webové stránky TYPO3
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:
- Prihláste sa do svojho backendu TYPO3
- Prejdite na Web → Template
- Vyberte svoju koreňovú stránku v strome stránok
- Kliknite na "Edit the whole template record" (alebo vyberte "Info/Modify" a potom "Setup")
- 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> - Nahradte
YOUR_WIDGET_IDvasim skutocnym ID widgetu z dashboardu - Kliknite na "Ulozit"
- 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:
- Prejdite do priečinka balíka webu:
packages/your_sitepackage/Configuration/TypoScript/ - Otvorte alebo vytvorte setup.typoscript
- 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>
} - Nahradte
YOUR_WIDGET_IDvasim skutocnym ID widgetu - 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:
- Prejdite na svoj súbor šablóny Fluid (zvyčajne v
Resources/Private/Templates/) - 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> - Uistite sa, že vaše rozloženie stránky vykresľuje sekciu FooterAssets:
<f:render section="FooterAssets" optional="true" /> - 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:
- Vo vašom PHP kóde (napr. kontroléri alebo middleware) vložte AssetCollector
- 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.
Weebly