BFSG Scout

Erste Schritte: Vom Kauf bis zum ersten Bericht
Anleitung Version 1.0 · für Plugin v0.11.x

Willkommen! Diese Anleitung führt Sie in 5 Schritten von der Bestellung zum aktiven Plugin und in weiteren 4 Schritten durch die ersten Scans und Berichte. Lesezeit: ca. 15 Minuten. Praktische Umsetzung: ca. 20-30 Minuten.

Was Sie brauchen, bevor Sie anfangen
  • Ihre Digistore24-Bestellbestätigungs-Mail (mit Lizenzschlüssel)
  • Zugang zum WordPress-Admin-Bereich der Website, auf der Sie BFSG Scout einsetzen wollen
  • Administrator-Rechte (für die Plugin-Installation)
  • WordPress-Version 6.2 oder höher und PHP 8.0 oder höher

Teil 1: Plugin aktivieren (5 Schritte, ca. 10 Minuten)

1 Plugin-ZIP herunterladen

Nach dem Kauf bei Digistore24 haben Sie eine Bestellbestätigung per E-Mail erhalten. Darin finden Sie zwei wichtige Informationen:

  • Einen Download-Link für die Plugin-Datei (ZIP)
  • Ihren Lizenzschlüssel im Format BFSG-PRO-XXXX-XXXX-XXXX (Pro Single) oder BFSG-AGEN-XXXX-XXXX-XXXX (Agency)

Klicken Sie auf den Download-Link in der Mail. Die ZIP-Datei (ca. 240 KB) wird auf Ihren Computer heruntergeladen. Entpacken Sie die ZIP nicht — WordPress benötigt sie genau so.

Digistore24-Bestellbestätigungs-Mail mit markiertem Download-Link
Schlüssel sicher aufbewahren Speichern Sie den Lizenzschlüssel auch ausserhalb der Mail (z.B. Passwort-Manager). Sie brauchen ihn jedes Mal, wenn Sie das Plugin auf einer neuen Site aktivieren.

2 In WordPress hochladen und installieren

Loggen Sie sich in den WordPress-Admin-Bereich Ihrer Website ein (typischerweise unter https://ihre-website.de/wp-admin).

Navigieren Sie über das linke Menü zu Plugins → Installieren. Klicken Sie oben auf der Seite auf den Button „Plugin hochladen".

WordPress-Plugins-Seite mit hervorgehobenem Plugin-hochladen-Button

Es erscheint ein Datei-Auswahl-Bereich. Klicken Sie auf „Datei auswählen" und wählen Sie die heruntergeladene ZIP-Datei aus. Klicken Sie dann auf „Jetzt installieren".

Upload-Dialog mit ausgewählter ZIP-Datei und Jetzt-installieren-Button

WordPress lädt die Datei hoch und entpackt sie automatisch. Nach 5-10 Sekunden erscheint die Erfolgs-Meldung.

3 Plugin aktivieren

Nach erfolgreicher Installation zeigt WordPress den Button „Plugin aktivieren". Klicken Sie darauf.

Erfolgs-Seite nach Plugin-Upload mit Plugin-aktivieren-Button

WordPress wechselt zurück zur Plugins-Liste. BFSG Scout sollte jetzt aktiv sein (kein blauer Aktivieren-Link mehr) und im linken Hauptmenü erscheint ein neuer Eintrag „BFSG Scout".

Linkes WordPress-Admin-Menü mit hervorgehobenem BFSG-Scout-Eintrag

4 Lizenzschlüssel eintragen

Klicken Sie im linken Menü auf BFSG Scout → Lizenz. Sie sehen die Lizenz-Verwaltungsseite.

BFSG-Scout-Lizenz-Seite vor Eingabe des Schlüssels

Im Bereich „Lizenzschlüssel" tragen Sie Ihren Schlüssel aus der Bestellbestätigung in das Eingabefeld ein. Achten Sie auf das exakte Format mit Bindestrichen.

Klicken Sie auf „Lizenz aktivieren". Das Plugin verbindet sich kurz mit dem Lizenz-Server (1-3 Sekunden).

Lizenz-Seite mit eingegebenem Schlüssel und Lizenz-aktivieren-Button
Wenn die Aktivierung fehlschlägt Häufigste Ursachen: Tippfehler im Schlüssel, Schlüssel wurde widerrufen, oder die Domain ist bereits anderweitig aktiviert (Slot-Limit erreicht). Siehe Abschnitt „Häufige Probleme" weiter unten.

5 Aktivierung verifizieren

Nach erfolgreicher Aktivierung zeigt die Lizenz-Seite folgende Informationen:

  • Status: „Aktiv" (grün hinterlegt)
  • Aktive Edition: „Pro" oder „Agency"
  • Aktueller Schlüssel: maskiert dargestellt (z.B. BFSG-AGEN-XHU...QX9C)
  • Gültig bis: ein Datum 1 Jahr in der Zukunft
Lizenz-Seite nach erfolgreicher Aktivierung mit grünem Aktiv-Badge
Geschafft Plugin ist aktiviert und einsatzbereit. Sie können jetzt mit Schritt 6 fortfahren oder die Anleitung zu einem späteren Zeitpunkt weiterlesen.
Hinweis für Agency-Käufer Sie haben mit Agency 25 oder Agency 50 Slot-Lizenzen, mit denen Sie das Plugin auf 25 bzw. 50 Kundenseiten gleichzeitig betreiben können. Pro Site wird Schritt 1-5 einmal durchgeführt — derselbe Lizenzschlüssel auf jeder Site. Der Server zählt automatisch die belegten Slots.

Teil 2: Erste Schritte mit dem Plugin

6 Den ersten Scan starten

Im linken Menü unter BFSG Scout finden Sie folgende Untermenü-Einträge:

  • Dashboard — Überblick über Scan-Aktivität und Befunde
  • Website scannen — neuer Scan startet hier
  • Fundstellen — alle gefundenen Probleme, gefiltert nach Priorität
  • Letzte Scans — Historie aller bisherigen Scans
  • Medienprüfung — Untersuchung von Bildern und Medien-Dateien
  • Berichte — generierte Berichte als HTML/PDF
  • Lizenz, Einstellungen, Hilfe — Verwaltung

Klicken Sie auf „Website scannen". Geben Sie die URL ein, die geprüft werden soll (z.B. https://ihre-website.de) und klicken Sie auf „Scan starten".

Website-scannen-Seite mit eingegebener URL und Scan-Optionen

Der Scan dauert je nach Seitengröße zwischen 30 Sekunden und 3 Minuten. Während des Scans sehen Sie einen Fortschrittsbalken. Schließen Sie das Browser-Fenster nicht.

Laufender Scan mit Fortschrittsbalken
Was wird geprüft BFSG Scout führt eine technische Vorprüfung typischer Barrierefreiheits-Probleme durch. Geprüft werden u.a.: fehlende Alt-Texte bei Bildern, Links ohne erkennbaren Text, Buttons ohne zugänglichen Namen, fehlende Sprach-Attribute, Kontrast-Probleme. Eine vollständige juristische Prüfung nach BFSG ersetzt der Scan nicht.

7 Fundstellen verstehen und bearbeiten

Nach Abschluss des Scans erscheint die Fundstellen-Liste. Jede Fundstelle hat:

  • Eine Priorität: Kritisch, Hoch, Mittel, Niedrig
  • Eine Quelle: PHP-Scan oder Browser-Scan
  • Eine Kategorie: z.B. img_missing_alt, link_no_accessible_name
  • Einen Status: Offen, In Bearbeitung, Erledigt, Ignoriert
  • Eine konkrete Empfehlung zur Behebung
Fundstellen-Tabelle mit verschiedenen Prioritäten und Status-Auswahl

Über die Filter oben können Sie nach Scan, Priorität, Status und Kategorie filtern. Bei jeder Fundstelle können Sie über das Dropdown „Aktion" den Status ändern: Offen → In Bearbeitung → Erledigt.

Tipp: mit Kritisch anfangen Sortieren Sie nach Priorität „Kritisch" und arbeiten Sie diese zuerst ab. Das sind die wichtigsten Punkte für Barrierefreiheit. „Mittel" und „Niedrig" sind oft Empfehlungen, deren Umsetzung sinnvoll, aber nicht zwingend ist.

Über den Button „CSV-Export" können Sie die gefilterten Fundstellen als Excel-kompatible Datei herunterladen — praktisch für interne Aufgaben-Verteilung oder Übergabe an Entwickler.

8 Bericht erstellen und exportieren

Klicken Sie im Menü auf „Berichte". Sie können drei verschiedene Bericht-Typen generieren:

  • Kurzbericht — 1-2 Seiten, Management-Zusammenfassung mit Ampel-Status
  • Managementbericht — 4-6 Seiten, mit Diagrammen und Empfehlungen pro Bereich
  • Detailbericht — alle Fundstellen einzeln, technisch detailliert (10+ Seiten)
Berichte-Seite mit den drei Bericht-Typ-Karten zur Auswahl

Wählen Sie den gewünschten Bericht-Typ, klicken Sie auf „Bericht erstellen" und wählen Sie den zugrundeliegenden Scan aus. Der Bericht wird als HTML angelegt und ist sofort verfügbar.

Vorschau eines fertigen Berichts mit Logo, Ampel und Fundstellen-Übersicht

Über den Button „Drucken / als PDF speichern" erstellen Sie eine PDF-Datei (über die Browser-Druckfunktion). Diese können Sie an Kunden weitergeben oder archivieren.

Wichtig: kein Konformitäts-Zertifikat Die Berichte sind eine technische Arbeitsgrundlage, kein juristisches Konformitäts-Zertifikat. Sie zeigen typische technische und redaktionelle Probleme, ersetzen aber keine vollständige manuelle Prüfung durch einen Sachverständigen.

9 Agency-Branding (nur für Agency-Editionen)

Nur für Agency-Käufer relevant Falls Sie die Pro-Single-Edition haben, können Sie diesen Schritt überspringen. Sie sind fertig mit der Einrichtung.

Mit der Agency-Edition können Sie Berichte unter Ihrem eigenen Logo und mit Ihren Kontaktdaten erstellen. Klicken Sie im Menü auf BFSG Scout → Agenturmodus.

Agenturmodus-Einstellungs-Seite mit Logo-Upload und Kontaktdaten

Tragen Sie folgende Daten ein:

  • Agentur-Name — erscheint im Bericht-Header
  • Logo — laden Sie eine PNG- oder JPG-Datei hoch (empfohlen: 300x80 Pixel, transparent)
  • Kontakt-Daten — Adresse, Telefon, E-Mail, Webseite (für die Berichts-Fußzeile)
  • Kunden-Bezeichnung — optional, erscheint im Bericht-Titel (z.B. „Erstellt für: Müller GmbH")

Speichern Sie die Einstellungen. Beim nächsten Bericht-Export werden alle Berichte automatisch mit Ihrem Branding versehen.

Bericht mit Agency-Logo im Header und Agency-Kontaktdaten im Footer

Häufige Probleme und Lösungen

Lizenzschlüssel wird nicht akzeptiert

Mögliche Ursachen und Lösungen:

  • Tippfehler: Der Schlüssel hat 4 Blöcke à 4-8 Zeichen, getrennt durch Bindestriche. Kopieren Sie ihn aus der Mail, statt ihn abzutippen.
  • Schlüssel widerrufen: Falls Ihre Bestellung storniert wurde (z.B. Rückerstattung), ist der Schlüssel deaktiviert. Bitte kontaktieren Sie den Support.
  • Slot-Limit erreicht: Pro Single = 1 Site. Wenn Sie das Plugin auf einer zweiten Site aktivieren wollen, müssen Sie es erst auf der ersten deaktivieren.
  • Domain bereits aktiv: Falls Sie das Plugin schon mal auf dieser Domain hatten und neu installieren, kann das Aktivieren fehlschlagen. Im Zweifel Support kontaktieren — wir können den alten Slot freigeben.

Browser-Scan funktioniert nicht (nur PHP-Scan läuft)

Der Browser-Scan benötigt eine JavaScript-Bibliothek. Falls die nicht geladen wird, sehen Sie eine Hinweis-Meldung. Mögliche Ursachen:

  • Ein anderer Plugin oder ein AdBlocker blockiert die Datei
  • Die Datei axe.min.js fehlt im Plugin-Ordner (extrem selten)
  • Ihr Hosting blockiert JavaScript-Dateien aus Plugin-Ordnern

Lösung: Im Zweifel reicht der PHP-Scan für die meisten Fälle. Bei Problemen Support kontaktieren mit Angabe der WordPress- und PHP-Version.

Fundstellen-Liste ist leer nach Scan

Wenn ein Scan keine Fundstellen findet, kann das zwei Gründe haben:

  • Gut: Ihre Seite hat tatsächlich keine offensichtlichen technischen Probleme — Glückwunsch.
  • Möglicherweise problematisch: Der Scan konnte die Seite nicht aufrufen (Login-Bereich, IP-Sperre, Wartungsmodus). Prüfen Sie unter „Letzte Scans", ob der Scan-Status „Erfolgreich" ist und wie viele Seiten geprüft wurden.

„Update-Server gerade nicht erreichbar" auf der Lizenz-Seite

Aktuell bekannt In der aktuellen Version (v0.11.x) ist die automatische Update-Pipeline noch nicht voll funktionsfähig. Diese Meldung können Sie ignorieren — Updates erhalten Sie zunächst manuell per E-Mail. Eine spätere Plugin-Version wird Updates automatisch ausspielen.

Plugin-Seite zeigt einen Fehler („kritischer Fehler")

Wenn eine bestimmte Plugin-Seite einen Fehler zeigt, gehen Sie wie folgt vor:

  1. Andere Plugin-Seiten weiter erreichbar? Falls ja: Plugin selbst funktioniert, nur eine Seite hat einen Bug. Melden bitte an Support.
  2. Plugin komplett unzugänglich? In der WordPress-Plugin-Liste das Plugin deaktivieren, dann den Support kontaktieren.
  3. WordPress-Admin-Bereich komplett unzugänglich? Per FTP in den Ordner /wp-content/plugins/ gehen und den Ordner bfsg-scout umbenennen (z.B. zu bfsg-scout-deaktiviert) — das deaktiviert das Plugin notfallmäßig. Dann Support kontaktieren.

Support kontaktieren

Wenn Sie nach Durcharbeiten dieser Anleitung weitere Fragen haben oder ein Problem nicht selbst lösen können:

E-Mail-Support: support@marketing-fabrik.com

Damit wir schnell helfen können, nennen Sie uns bitte folgende Informationen:

  • Ihre Bestellnummer (aus der Digistore-Mail)
  • Die Domain, auf der Sie das Plugin einsetzen
  • Eine kurze Beschreibung des Problems
  • Welcher Schritt der Anleitung funktioniert noch — und welcher nicht
  • Falls möglich: einen Screenshot
System-Status-Export Bei technischen Problemen ist ein „System-Status-Export" hilfreich. Sie finden den Export unter BFSG Scout → Systemstatus. Klicken Sie dort auf „Support-Paket exportieren". Sie erhalten eine ZIP-Datei mit anonymisierten Diagnose-Daten, die Sie der Support-Mail anhängen können.

Kostenloses Erstgespräch vereinbaren

Wir melden uns innerhalb von 24 Stunden bei Ihnen

🔒 Diese Seite ist durch reCAPTCHA geschützt. Es gelten die Datenschutzerklärung und Nutzungsbedingungen von Google.