Das brauchst du
Zugriff auf den Quellcode und den gemeinsamen Layout- oder HTML-Einstieg deiner Anwendung. Lege in Accessonaut zuerst ein Projekt mit deiner tatsächlichen Website-Domain an und öffne im Projekt die Einbauseite.
Schritt für Schritt
- Öffne im Next.js App Router das gemeinsame Root-Layout. Importiere Script aus next/script.
- Verwende next/script mit der öffentlichen widget.js-Adresse, data-project-id und strategy="afterInteractive". Die Datenattribute entsprechen deinem Einbaucode.
- Platziere die Einbindung einmal im gemeinsamen Layout. Bei React ohne Next.js kannst du den normalen Einbaucode in das HTML-Dokument übernehmen.
- Baue und veröffentliche die Anwendung. Prüfe harte Seitenaufrufe und clientseitige Navigation auf doppelte Buttons oder verlorene Einstellungen.
So sieht die Einbindung aus
Verwende den fertigen Code aus deinem Projekt. Das Beispiel benötigt deine echte Projekt-ID und die öffentlich erreichbare Service-Adresse.
import Script from 'next/script';
<Script
src="https://accessonaut.com/widget.js"
data-project-id="DEINE_PROJEKT_ID"
data-language="de"
strategy="afterInteractive"
/>Das Design an deine Website anpassen
Öffne im Accessonaut-Projekt „Widget & Browser-Assistent“. Fünf Vorlagen und eine Live-Vorschau helfen dir beim Gestalten: Farben, Schriften, Menübreite, Ecken, Schatten, Symbol oder beschrifteter Öffner sowie eigene Texte. Position und Randabstände lassen sich für Desktop und Smartphone abstimmen. Nach dem Speichern übernimmt dein vorhandener Einbaucode das Projektdesign automatisch; die öffentliche Konfiguration wird bis zu einer Minute zwischengespeichert.
Im WordPress-Plugin kannst du stattdessen lokale Einstellungen wählen. Diese haben Vorrang vor dem Projektdesign. Die Gestaltung ist in allen Tarifen verfügbar. Im Free-Tarif bleibt der Accessonaut-Hinweis sichtbar. Persönliche Leseeinstellungen deiner Besuchenden haben Vorrang vor Designvorgaben.
Darauf achten
Nutze als Script-Quelle die öffentliche Accessonaut-Service-Domain. Gib keine API-Schlüssel und keine Umgebungsvariablen mit Geheimnissen an den Browser weiter. CSP-Regeln müssen Script und Konfigurationsabruf erlauben.
Einbau prüfen
- Öffne die öffentliche Website in einem privaten Fenster. Das Widget wird genau einmal angezeigt.
- Erreiche den Button mit der Tastatur. Öffne das Panel, ändere die Textgröße und schließe es wieder.
- Prüfe Startseite, Unterseite, Formular und mobile Ansicht. Das Widget darf keine wichtigen Bedienelemente verdecken.
- Prüfe im Netzwerk-Tab, dass widget.js und die Projektkonfiguration von deiner Service-Adresse geladen werden. Bei Fehlern kontrolliere Domain, Projekt-ID und CSP.
- Bei Free-Projekten bleibt der sichtbare Accessonaut-Hinweis Bestandteil des Widgets. Berechtigungen kommen aus deinem Projekt.
Datenschutz und Grenzen
Beim Laden ruft der Besucherbrowser das Script und die Projektkonfiguration vom Accessonaut-Dienst ab. Dabei fallen IP-Adresse, Browser-Anfragedaten und Website-Hostname an. Darstellungswünsche werden lokal im Browser gespeichert. Berücksichtige die Einbindung in deinen Datenschutzhinweisen und prüfe deine konkrete Konfiguration.
Die Lesehilfen erzeugen keine Konformitätsgarantie. Prüfe Barrieren im Quellcode und vollständige Nutzerabläufe zusätzlich automatisch und manuell.