So fügen Sie den Asyntai-KI-Chatbot zu TYPO3 hinzu

Schritt-für-Schritt-Anleitung für TYPO3-Websites

Plattform:

Schritt 1: Ihren Einbettungscode erhalten

Gehen Sie zunächst zu Ihrem Asyntai Dashboard und scrollen Sie zum Abschnitt "Einbettungscode". Kopieren Sie Ihren einzigartigen Einbettungscode, der so aussieht:

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

Hinweis: Der obige Code ist nur ein Beispiel. Sie müssen Ihren eigenen einzigartigen Einbettungscode von Ihrem Dashboard kopieren, da er Ihre persönliche Widget-ID enthält.

Schritt 2: TypoScript footerData verwenden (empfohlen)

Der einfachste Weg, den Chatbot auf allen Seiten hinzuzufügen, ist die Verwendung von TypoScript footerData:

Melden Sie sich in Ihrem TYPO3-Backend an
Gehen Sie zu Web → Template
Wählen Sie Ihre Stammseite im Seitenbaum aus
Klicken Sie auf "Edit the whole template record" (oder wählen Sie "Info/Modify" und dann "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>
Ersetzen Sie YOUR_WIDGET_ID durch Ihre tatsächliche Widget-ID aus dem Dashboard
Klicken Sie auf "Save"
Leeren Sie den TYPO3-Cache: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Tipp: Die Verwendung von footerData platziert das Skript direkt vor dem schließenden </body>-Tag, was für Chat-Widgets empfohlen wird, da es das Laden Ihrer Seite nicht verlangsamt.

Alternative: Site-Package verwenden (für Site-Packages)

Wenn Sie ein Site-Package verwenden, können Sie das Skript über Ihre TypoScript-Konfigurationsdatei hinzufügen:

Navigieren Sie zu Ihrem Site-Package-Ordner: packages/your_sitepackage/Configuration/TypoScript/
Öffnen oder erstellen Sie setup.typoscript
Fügen Sie den folgenden Code hinzu:
page.footerData { 99 = TEXT 99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> }
Replace YOUR_WIDGET_ID with your actual widget ID
Leeren Sie den Cache im TYPO3-Backend

Alternative: Fluid-Template verwenden (FooterAssets)

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

Navigieren Sie zu Ihrer Fluid-Template-Datei (normalerweise in Resources/Private/Templates/)
Add a FooterAssets section in your layout or 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>
Make sure your page layout renders the FooterAssets section:
<f:render section="FooterAssets" optional="true" />
Leeren Sie den TYPO3-Cache

Wichtig: Die FooterAssets-Funktion erfordert TYPO3 v8 oder höher. Für ältere Versionen verwenden Sie die TypoScript-footerData-Methode.

Alternative: AssetCollector verwenden (für Entwickler)

Für Extension-Entwickler bietet TYPO3 v10.3+ die AssetCollector-API:

Injizieren Sie in Ihrem PHP-Code (z. B. einem Controller oder Middleware) den AssetCollector
Fügen Sie das Skript mit benutzerdefinierten Attributen hinzu:
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'] );

Schritt 3: Installation überprüfen

Nachdem Sie Ihre Änderungen gespeichert und den Cache geleert haben, besuchen Sie Ihre Website in einem neuen Browser-Tab oder Inkognito-Fenster. Sie sollten den Chat-Widget-Button in der unteren rechten Ecke sehen. Klicken Sie darauf, um sicherzustellen, dass er sich öffnet und korrekt funktioniert.

Widget nicht sichtbar? Stellen Sie sicher, dass Sie alle Caches leeren: Gehen Sie zu Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Versuchen Sie auch, Ihren Browser-Cache zu leeren oder die Seite in einem Inkognito-Fenster aufzurufen. Wenn Sie TypoScript verwenden, überprüfen Sie, ob Ihr Template korrekt in der Seitenhierarchie eingebunden ist.