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

Schritt-für-Schritt-Anleitung für Concrete-CMS-Websites (ehemals Concrete5)

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: Code zum Theme-Footer hinzufügen (Empfohlen)

Der beste Weg, den Chatbot zu allen Seiten Ihrer Concrete CMS-Website hinzuzufügen, ist die Bearbeitung der Footer-Datei Ihres Themes:

Greifen Sie auf Ihre Concrete CMS-Installation über FTP oder Dateimanager zu
Navigieren Sie zum Verzeichnis /application/themes/your_theme_name/
Suchen und öffnen Sie die Datei footer.php (oder das entsprechende Footer-Template)
Suchen Sie die Zeile mit dem schließenden </body>-Tag
Fügen Sie Ihren Asyntai-Einbettungscode direkt vor dem </body>-Tag ein
Speichern Sie die Datei und laden Sie sie zurück auf Ihren Server, wenn Sie lokal bearbeiten
Concrete-CMS-Cache leeren: Dashboard → System & Einstellungen → Cache leeren

Tipp: Das Hinzufügen des Codes vor dem schließenden </body>-Tag stellt sicher, dass der Chatbot nach Ihrem Seiteninhalt geladen wird, was eine bessere Seitenladeleistung bietet. Diese Methode fügt den Chatbot automatisch zu jeder Seite hinzu, die dieses Theme verwendet.

Alternative Methode 1: HTML-Block (am einfachsten für Nicht-Entwickler)

Wenn Sie es vorziehen, keine Theme-Dateien zu bearbeiten, können Sie den integrierten HTML-Block von Concrete CMS verwenden:

Melden Sie sich in Ihrem Concrete CMS Dashboard an
Navigieren Sie zu der Seite, auf der Sie den Chatbot hinzufügen möchten
Klicken Sie auf Seite bearbeiten (Stiftsymbol in der Symbolleiste)
Klicken Sie auf Add Block in dem Bereich, in dem Sie den Code platzieren möchten
Suchen und wählen Sie den HTML-Block
Fügen Sie Ihren Asyntai-Einbettungscode in den HTML-Editor ein
Klicken Sie auf Add, um den Block zu speichern
Klicken Sie auf Veröffentlichen, um die Änderungen live zu schalten

Hinweis: Die HTML-Block-Methode eignet sich hervorragend zum Hinzufügen des Chatbots auf bestimmten Seiten. Für eine seitenweite Installation müssen Sie den HTML-Block auf jeder Seite hinzufügen oder die oben beschriebene Theme-Footer-Methode verwenden. Die visuelle Platzierung des Blocks beeinflusst nicht, wo der Chatbot erscheint – er wird weiterhin in der unteren rechten Ecke angezeigt.

Alternative Methode 2: Theme-Header-Datei

Sie können den Code auch zur Header-Datei Ihres Themes für eine seitenweite Installation hinzufügen:

Greifen Sie auf Ihre Concrete CMS-Dateien über FTP oder Dateimanager zu
Navigieren Sie zu /application/themes/ihr_theme_name/
Öffnen Sie die Datei header.php (oder elements/header.php)
Suchen Sie das schließende </head>-Tag
Fügen Sie Ihren Asyntai-Einbettungscode direkt vor dem </head>-Tag ein
Speichern und laden Sie die Datei hoch
Leeren Sie den Cache über das Dashboard

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

Tipp: Stellen Sie sicher, dass Sie die erforderlichen Header-Elemente mit <?php View::element('header_required'); ?> in Ihrer header.php-Datei einbinden, damit Concrete CMS ordnungsgemäß funktioniert.

Alternative Methode 3: Benutzerdefiniertes Template (Fortgeschritten)

Für Entwickler, die mehr Kontrolle wünschen, können Sie ein benutzerdefiniertes Seiten-Template erstellen:

Erstellen Sie eine neue Seiten-Template-Datei in /application/themes/your_theme_name/
Oder kopieren Sie ein vorhandenes Template (z.B. default.php) und benennen Sie es um
Fügen Sie Ihren Asyntai-Einbettungscode zur Template-Datei vor </body> hinzu
Gehen Sie im Concrete CMS Dashboard zu Pages & Themes
Klicken Sie auf Page Types
Wählen Sie den Seitentyp aus, mit dem Sie dieses Template verwenden möchten
Weisen Sie Ihr benutzerdefiniertes Template dem Seitentyp zu
Alle Seiten mit diesem Seitentyp enthalten jetzt den Chatbot

Wichtig: Sichern Sie immer Ihre Theme-Dateien, bevor Sie Änderungen vornehmen. Testen Sie Ihre Modifikationen wenn möglich zuerst auf einer Staging-Website. Fehlerhafte Bearbeitungen von Theme-Dateien können das Layout oder die Funktionalität Ihrer Website beeinträchtigen.

Schritt 3: Installation überprüfen

Nachdem Sie Ihre Änderungen vorgenommen und den Cache geleert haben, öffnen 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 den Cache von Concrete CMS geleert haben (Dashboard → System & Settings → Clear Cache). Versuchen Sie, Ihre Website in einem Inkognito-Fenster anzuzeigen. Überprüfen Sie, ob Sie alle Dateiänderungen gespeichert und hochgeladen haben. Öffnen Sie die Browser-Konsole (F12), um auf JavaScript-Fehler zu prüfen.