Zurück zum Dashboard

Dokumentation

Erfahren Sie, wie Sie Asyntai verwenden

So fügen Sie den Asyntai AI Chatbot zu ExpressionEngine hinzu

Schritt-für-Schritt-Anleitung für ExpressionEngine CMS

Einbettungscode erhalten

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: Zum Template-Layout hinzufügen (Empfohlen)

Der einfachste Weg, den Chatbot auf allen Seiten hinzuzufügen, ist die Bearbeitung Ihres Haupt-Layout-Templates im ExpressionEngine-Kontrollpanel:

  1. Gehen Sie im EE-Kontrollpanel zu Developer > Templates > Template Groups
  2. Öffnen Sie Ihre Haupt-Template-Gruppe (normalerweise "site") und bearbeiten Sie das Layout-Template (oder das Template, das alle Seiten umschließt)
  3. Suchen Sie das schließende </body>-Tag
  4. Fügen Sie Ihren Asyntai-Einbettungscode direkt vor dem </body>-Tag ein:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Speichern Sie das Template

Tipp: Das Hinzufügen des Skripts vor dem schließenden </body>-Tag stellt sicher, dass es nach dem Seiteninhalt geladen wird, was für Chat-Widgets empfohlen wird und das Laden Ihrer Seite nicht verlangsamt.

Alternative Methode 1: Verwendung von EE-Template-Partials

ExpressionEngine-Template-Partials ermöglichen es Ihnen, wiederverwendbare Snippets zu erstellen, die in verschiedenen Templates eingebunden werden können:

  1. Gehen Sie zu Entwickler > Templates > Template-Partials
  2. Klicken Sie auf "New", um ein neues Partial namens _asyntai_widget zu erstellen
  3. Fügen Sie Ihren Asyntai-Einbettungscode in den Partial-Inhalt ein:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Speichern Sie das Partial
  5. Binden Sie es in Ihrem Layout-Template direkt vor dem schließenden </body>-Tag ein:
    {embed="_asyntai_widget"} </body>

Hinweis: Die Verwendung von Template-Partials hält Ihren Code organisiert und erleichtert die Aktualisierung des Chatbot-Einbettungscodes an einer zentralen Stelle für Ihre gesamte Website.

Alternative Methode 2: Verwendung des HTML-Headers/Footers von EE

Einige ExpressionEngine-Installationen bieten einen globalen Footer-Bereich zum Hinzufügen von Scripts:

  1. Gehen Sie zu Settings > Content & Design > Global Template Preferences
  2. Wenn Ihre EE-Installation einen globalen Footer-Bereich hat, fügen Sie den Asyntai-Einbettungscode dort ein
  3. Wenn kein globaler Footer-Bereich verfügbar ist, bearbeiten Sie Ihr Haupt-Layout-Template direkt und fügen Sie den Einbettungscode vor dem schließenden </body>-Tag ein:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Speichern Sie Ihre Änderungen

Alternative Methode 3: Verwendung von config.php

Für fortgeschrittene Benutzer können Sie das Chatbot-Script über die ExpressionEngine-Konfiguration oder durch Erstellen eines benutzerdefinierten Add-ons einbinden:

  1. Greifen Sie über FTP, SSH oder Ihren Code-Editor auf Ihre ExpressionEngine-Projektdateien zu
  2. Navigieren Sie zum Verzeichnis system/user/config/ und öffnen Sie config.php
  3. Für benutzerdefinierte JavaScript-Einbindung erwägen Sie die Erstellung eines einfachen EE-Add-ons/einer Erweiterung, die sich in den Hook template_post_parse einklinkt, um das Script beim Seitenrendering einzufügen:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Ersetzen Sie YOUR_WIDGET_ID durch Ihre tatsächliche Widget-ID aus dem Dashboard

Wichtig: Die config.php- und Add-on-Methode ist für fortgeschrittene Benutzer gedacht, die mit der ExpressionEngine-Entwicklung vertraut sind. Für die meisten Benutzer wird die Template-Layout-Methode (Schritt 2) oder die Template-Partials-Methode (Alternative Methode 1) empfohlen.

Schritt 3: Installation überprüfen

Nachdem Sie Ihre Änderungen gespeichert haben, besuchen Sie Ihre ExpressionEngine-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 das Template gespeichert haben und dass Sie das richtige Layout-Template bearbeiten, das Ihre Seiten verwenden. Leeren Sie Ihren Browser-Cache oder öffnen Sie ein Inkognito-Fenster. Wenn das ExpressionEngine-Template-Caching aktiviert ist, leeren Sie den Cache über das Kontrollpanel unter Developer > Utilities > Cache Manager.