KI-Chat-Agent für Ihre Grav-Website

Was Sie brauchen

Hazelchat in fünf Schritten zu Grav hinzufügen

1. In Hazelchat

   Agenten vorbereiten

   Fügen Sie Ihre Inhalte hinzu, prüfen Sie die Angaben und probieren Sie Ihren Agenten aus. Tragen Sie unter Website → Auf Ihrer Website installieren die Domain Ihrer Website ein.

2. In Hazelchat

   Installationscode kopieren

   Kopieren Sie den Installationscode. Er enthält Ihren öffentlichen Widget-Schlüssel, der kein Passwort ist.

3. In Grav

   Plugin installieren

   Öffnen Sie im Admin Plugins, klicken Sie auf Hinzufügen und installieren Sie Hazelchat. Oder führen Sie bin/gpm install hazelchat aus. Die Installation allein lädt noch nichts auf Ihrer Website. Ohne Gravs Plugin-Liste laden Sie grav-plugin-hazelchat-1.0.1.zip herunter und unter Werkzeuge → Direkte Installation (im Admin von Grav 2: Direct Install) hoch, oder entpacken Sie die Datei nach user/plugins.

4. In Grav

   Code im Admin einfügen

   Öffnen Sie im Admin Plugins → Hazelchat, fügen Sie den Code in das Feld Installationscode ein und klicken Sie auf Speichern. Haben Sie früher schon ein Hazelchat-Skript in ein Theme-Template eingefügt, entfernen Sie es, damit der Chat nur einmal lädt.

5. Auf Ihrer Website

   Einschalten und testen

   Klicken Sie in Hazelchat auf Veröffentlichen und einschalten (oder Einschalten, wenn Ihr veröffentlichter Agent unverändert ist). Hazelchat prüft, ob das Skript auf Ihrer Website ist, bevor der Agent live geht. Öffnen Sie dann Ihre Website, stellen Sie im Chat eine Frage, kehren Sie zu Hazelchat zurück und klicken Sie auf Ja, ich habe diese Antwort gesehen.

An Ihre Entwickler schicken

Jemand anderes baut und veröffentlicht Ihre Website? Kopieren Sie diese Nachricht, setzen Sie an der markierten Stelle Ihren Installationscode ein und schicken Sie sie ab.

Bitte fügt den Hazelchat-Chat zu unserer Grav-Website hinzu:

1. bin/gpm install hazelchat ausführen
   (oder im Admin unter Plugins das Plugin Hazelchat hinzufügen).
2. In user/config/plugins/hazelchat.yaml:
   enabled: true
   code: '[unser Installationscode aus Hazelchat]'
   (oder im Admin unter Plugins → Hazelchat einfügen).
3. Veröffentlichen, dann bin/grav clearcache ausführen.

Anleitung: https://hazelchat.co/de/integrations/grav/

Was das Plugin macht

Es fügt den Seiten Ihrer Website ein Skript hinzu, sonst nichts. Ihre Inhalte, Antworten, Anfragen und die Abrechnung bleiben in Ihrem Hazelchat-Arbeitsbereich.

Das Plugin setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in jede HTML-Seite Ihrer Website, in jeder Sprache. Der Admin und Seiten in anderen Formaten, etwa JSON oder RSS, laden den Chat nie. Die Adresse des Skripts steht fest im Plugin und lässt sich in den Einstellungen nicht ändern. Das Plugin speichert nur den Code und einen Schalter in user/config/plugins/hazelchat.yaml, legt keine Datenbanktabellen an, stellt keine Anfragen von Grav an Hazelchat und sendet nichts. Seine Admin-Texte gibt es auf Deutsch und Englisch, und es ist freie Software unter der MIT-Lizenz.

Einwilligung der Besucher

Mit Gravs Consent-Plugin (Grav 2) müssen Sie nichts einrichten. Hazelchat erscheint im Banner unter „Notwendig“: Der Chat setzt keine Cookies und speichert nur einen Verweis auf das Gespräch, bis der Tab geschlossen wird. Sollen Besucher den Chat erst erlauben, schalten Sie in den Plugin-Einstellungen Auf meinen Consent-Manager warten ein. Hazelchat steht dann unter „Funktional“, startet ohne Neuladen der Seite, sobald ein Besucher diese Kategorie erlaubt, und vergisst das Gespräch, wenn er die Einwilligung widerruft. Consent fragt Ihre Besucher einmal neu, nachdem ein Plugin etwas zu seiner Liste hinzugefügt hat.

Mit einem anderen Einwilligungs-Tool schalten Sie Auf meinen Consent-Manager warten ein. Der Chat bleibt dann geschlossen und sendet keine Anfragen, bis Ihr Einwilligungs-Tool diese Zeile ausführt (sie wirkt auch, wenn das Tool eine gespeicherte Wahl beim Laden der Seite erneut meldet):

(function (start) { document.readyState === 'loading' ? document.addEventListener('DOMContentLoaded', start) : start(); })(function () { window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true })); });

Senden Sie detail: false, wenn ein Besucher seine Einwilligung widerruft. Muss Ihre Website sogar das Herunterladen des Skripts blockieren, lassen Sie Ihr Einwilligungs-Tool auch dieses Skript blockieren. Fertige Einstellungen für verbreitete Cookie-Banner finden Sie unter Cookie-Banner.

Wenn der Chat nicht erscheint

• Kein Hazelchat unter Plugins?

  Prüfen Sie, ob der Ordner user/plugins/hazelchat heißt und eine hazelchat.php enthält, und ob das Plugin aktiviert ist.

• „Only official GPM URLs are allowed“?

  Grav installiert von einer Webadresse standardmäßig nur, wenn sie auf getgrav.org liegt. Führen Sie stattdessen bin/gpm install hazelchat aus, oder laden Sie die ZIP-Datei zuerst herunter und dann hoch, oder geben Sie bin/gpm direct-install die Datei.

• Cache leeren

  Speichern im Admin genügt. Nach einer Änderung in user/config/plugins/hazelchat.yaml führen Sie bin/grav clearcache aus.

• Code prüfen

  Fügen Sie den ganzen Installationscode ein oder nur seinen 64-stelligen Schlüssel. Alles andere, etwa ein API-Schlüssel, zeigt nichts, und Hazelchats Prüfung meldet, dass der Chat nicht gefunden wurde.

• Skript unverändert lassen

  Gravs Asset-Pipeline fasst das Skript nicht an. Schreibt ein Cache- oder Optimierungsdienst Ihre Seiten um, nehmen Sie https://app.hazelchat.co/widget.js vom Zusammenfassen und verzögerten Laden aus.

• Content-Security-Policy

  Grav sendet für Ihre Seiten keine. Tun es Ihr Server oder ein Plugin, erlauben Sie https://app.hazelchat.co in script-src, connect-src und frame-src.

• Eine zweite Domain

  Der Free-Tarif gilt für eine Website. Eine zweite Grav-Website auf einer anderen Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

Aktualisieren Sie im Admin unter Plugins, oder führen Sie bin/gpm update hazelchat aus. Ohne Gravs Plugin-Liste laden Sie die neue ZIP-Datei herunter und unter Werkzeuge → Direkte Installation hoch, oder ersetzen Sie den Ordner user/plugins/hazelchat.

1.0.1 (November 2026): keine Änderung an der Funktion des Plugins. Die README nennt jetzt, wie Installationen gezählt werden, dass die Skriptdatei schon vor der Einwilligung lädt und wann sich der Consent-Schalter empfiehlt.

1.0.0 (November 2026): bringt den Hazelchat-Chat mit einem Installationscode in den Plugin-Einstellungen auf jede HTML-Seite einer Website mit Grav 1.7 oder Grav 2; optional wartet er auf Ihren Consent-Manager; nennt Hazelchat im Banner von Gravs Consent-Plugin; Admin-Texte auf Deutsch und Englisch.