Hoe voegt u de Asyntai AI Chatbot toe aan TYPO3

Stap-voor-stap handleiding voor TYPO3-websites

Platform:

Stap 1: Uw insluitcode ophalen

Ga eerst naar uw Asyntai Dashboard en scroll naar het gedeelte "Insluitcode". Kopieer uw unieke insluitcode die er als volgt uitziet:

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

Opmerking: De bovenstaande code is slechts een voorbeeld. U moet uw eigen unieke insluitcode kopiëren vanuit uw Dashboard omdat deze uw persoonlijke widget-ID bevat.

Stap 2: TypoScript footerData gebruiken (aanbevolen)

De eenvoudigste manier om de chatbot aan alle pagina's toe te voegen is met TypoScript footerData:

Log in op uw TYPO3 Backend
Ga naar Web → Template
Selecteer uw hoofdpagina in de paginaboom
Klik op "Edit the whole template record" (of selecteer "Info/Modify" en vervolgens "Setup")
In the Setup field, add the following TypoScript code:
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>
Vervang YOUR_WIDGET_ID door uw daadwerkelijke widget-ID uit het dashboard
Klik op "Save"
Wis de TYPO3-cache: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Tip: Het gebruik van footerData plaatst het script vlak voor de afsluitende </body>-tag, wat aanbevolen is voor chatwidgets omdat het uw pagina niet vertraagt.

Alternatief: Site Package gebruiken (voor Site Packages)

Als u een site package gebruikt, kunt u het script toevoegen via uw TypoScript-configuratiebestand:

Navigeer naar uw site package-map: packages/your_sitepackage/Configuration/TypoScript/
Open of maak setup.typoscript aan
Voeg de volgende code toe:
page.footerData { 99 = TEXT 99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> }
Vervang YOUR_WIDGET_ID door uw werkelijke widget-ID
Wis de cache in het TYPO3-backend

Alternatief: Fluid Template gebruiken (FooterAssets)

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

Navigeer naar uw Fluid-templatebestand (meestal in Resources/Private/Templates/)
Voeg een FooterAssets-sectie toe in uw layout of template:
<f:section name="FooterAssets"> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </f:section>
Zorg ervoor dat uw paginalayout de FooterAssets-sectie weergeeft:
<f:render section="FooterAssets" optional="true" />
Wis de TYPO3-cache

Belangrijk: De FooterAssets-functie vereist TYPO3 v8 of hoger. Gebruik voor oudere versies de TypoScript footerData-methode.

Alternatief: AssetCollector gebruiken (voor ontwikkelaars)

Voor extensie-ontwikkelaars biedt TYPO3 v10.3+ de AssetCollector API:

Injecteer in uw PHP-code (bijv. een controller of middleware) de AssetCollector
Voeg het script toe met aangepaste attributen:
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'] );

Stap 3: Installatie verifiëren

Nadat u uw wijzigingen hebt opgeslagen en de cache hebt gewist, bezoekt u uw website in een nieuw browsertabblad of incognitovenster. U zou de chatwidgetknop in de rechteronderhoek moeten zien. Klik erop om te controleren of deze correct opent en werkt.

Ziet u de widget niet? Zorg ervoor dat u alle caches wist: ga naar Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Probeer ook uw browsercache te wissen of bekijk de pagina in een incognitovenster. Als u TypoScript gebruikt, controleer dan of uw template correct is opgenomen in de paginahiërarchie.