So funktioniert die Behebung von Mängeln der Barrierefreiheit, Schritt für Schritt

Ein Projekt mit Validiscan läuft in fünf Schritten ab: ein Ausgangsscan, Änderungen am Code Ihres Shops, ein Verifizierungsscan, das Remediation Evidence Package und, wenn Sie möchten, der Regressionsschutz. Nichts gelangt in Ihren Live-Shop, bevor Sie, Ihr Entwicklungsteam oder Ihre Agentur die Änderungen zusammenführen, veröffentlichen oder einspielen.

Die fünf Schritte im Überblick

In jedem Schritt erledigt Validiscan die Arbeit, Sie haben ein oder zwei Dinge zu tun, und Sie erhalten etwas, das Sie prüfen können.

  1. 1

    Ausgangsscan

    Was Validiscan tut
    Scannt die Seiten Ihres Shops nach WCAG 2.2 Stufe AA in Desktop- und in Smartphone-Größe und arbeitet die manuellen Prüfungen ab
    Was Sie tun
    Einem vollständigen Scan schriftlich zustimmen
    Was Sie erhalten
    Die Liste der gefundenen Fehler, jeweils mit dem, was der Fehler für Ihre Kundinnen und Kunden bedeutet
  2. 2

    Änderungen am Code Ihres Shops

    Was Validiscan tut
    Behebt, was sich im Code beheben lässt, und prüft jede Änderung, bevor sie ausgeliefert wird
    Was Sie tun
    Zugriff auf Ihr Repository oder Ihr Shopify-Theme geben oder eine Kopie Ihrer Theme-Dateien hochladen; danach die Änderungen prüfen und sie zusammenführen, veröffentlichen oder einspielen. Auf Shopify können Sie die Theme-Kopie in der Vorschau ansehen und selbst veröffentlichen
    Was Sie erhalten
    Ein Pull Request, eine unveröffentlichte Kopie Ihres Themes oder ein Patch-Paket
  3. 3

    Verifizierungsscan

    Was Validiscan tut
    Scannt die betroffenen Seiten erneut, sobald die Änderungen live sind
    Was Sie tun
    Die Änderungen live stellen und danach den Verifizierungsscan anfordern
    Was Sie erhalten
    Die Befunde, die der Scan nicht mehr findet, als behoben markiert
  4. 4

    Remediation Evidence Package

    Was Validiscan tut
    Erstellt das Paket aus den Scans und den manuellen Prüfungen
    Was Sie tun
    Das Paket lesen und den Entwurf der Erklärung zur Barrierefreiheit prüfen lassen
    Was Sie erhalten
    PDF, DOCX und JSON in einem ZIP-Archiv mit SHA-256-Prüfsummen
  5. 5

    Regressionsschutz (optional)

    Was Validiscan tut
    Scannt Ihren Shop jede Woche erneut und vergleicht ihn mit dem verifizierten Ergebnis
    Was Sie tun
    Entscheiden, ob Sie ihn möchten
    Was Sie erhalten
    Eine E-Mail, wenn ein erneuter Scan eine Veränderung findet, und eine Zeitleiste aller erneuten Scans
Details: wovon die Dauer eines Projekts abhängt, und die fünf Schritte im Kundenportal

Wie lange ein Projekt dauert, hängt vor allem von den Schritten 2 und 3 ab: Dort wartet das Projekt darauf, dass Sie oder Ihre Agentur die Änderung prüfen und live stellen. Die Scans, die Prüfung jeder Änderung und das Paket sind die Arbeit von Validiscan.

Das Kundenportal, in dem Sie das Projekt verfolgen, zeigt dieselben fünf Schritte, bis die ersten Ergebnisse vorliegen. Dort heißt Schritt 1 „Erster Scan“; diese Website verwendet den festen Begriff Ausgangsscan.

Was braucht Validiscan vor dem Ausgangsscan von Ihnen?

Validiscan braucht vor dem Ausgangsscan drei Antworten: die schriftliche Einwilligung der Betreiberin oder des Betreibers des Shops in einen vollständigen Scan, den Weg, auf dem die Änderungen in Ihren Code gelangen sollen, und ob KI Korrekturen der Stufe ASSISTED entwerfen darf. Ohne erfasste Einwilligung startet kein vollständiger Scan.

  • Einwilligung in einen vollständigen Scan

    Validiscan führt einen vollständigen Scan erst aus, wenn die Betreiberin oder der Betreiber des Shops schriftlich zugestimmt hat, und erfasst die Einwilligung. Ohne diesen Eintrag startet kein vollständiger Scan.

  • Zugriff auf Ihren Code

    Einer von drei Wegen: Zugriff auf das GitHub-Repository, in dem Ihr Theme liegt, ein Theme-Access-Passwort für Ihren Shopify-Shop oder gar kein Zugriff auf Ihre Systeme. Im letzten Fall lädt Ihr Entwicklungsteam eine Kopie der Dateien Ihres Themes hoch, und die Änderungen kommen als Patch-Paket zurück.

  • Ihre Antwort zu KI-Entwürfen

    KI wird nur eingesetzt, um Korrekturen der Stufe ASSISTED zu entwerfen, und nur mit Ihrer Zustimmung. Bis Sie zustimmen, ist sie ausgeschaltet.

Details: die Einwilligung, die drei Wege zu Ihrem Code und die KI-Entwürfe

Bevor die Arbeit beginnt, braucht Validiscan drei Antworten von Ihnen: Ihre Einwilligung in den Scan, den Weg, auf dem die Änderungen in Ihren Code gelangen sollen, und ob KI einige davon entwerfen darf.

  • Einwilligung in einen vollständigen Scan. Ein vollständiger Scan geht weiter als der kostenlose Check: Er legt ein Produkt in den Warenkorb und öffnet den ersten Schritt im Checkout. Validiscan führt ihn erst aus, wenn die Betreiberin oder der Betreiber des Shops schriftlich zugestimmt hat. Validiscan erfasst die Einwilligung im eigenen System, mit dem Zeitpunkt und dem Namen der Person bei Validiscan, die sie erfasst hat. Ohne diesen Eintrag startet kein vollständiger Scan.
  • Zugriff auf Ihren Code. Einer von drei Wegen, die weiter unten erklärt werden: Zugriff auf das GitHub-Repository, in dem Ihr Theme liegt, ein Theme-Access-Passwort für Ihren Shopify-Shop oder gar kein Zugriff auf Ihre Systeme. Im letzten Fall lädt Ihr Entwicklungsteam eine Kopie der Dateien Ihres Themes hoch, und die Änderungen kommen als Patch-Paket zurück. Das ist auch der Weg, wenn Ihr Theme an einem anderen Ort als GitHub liegt, zum Beispiel auf GitLab oder Bitbucket.
  • Ihre Antwort zu KI-Entwürfen. KI wird nur eingesetzt, um Korrekturen der Stufe ASSISTED zu entwerfen, und nur mit Ihrer Zustimmung. Bis Sie zustimmen, ist sie ausgeschaltet. Wie Validiscan mit Ihren Daten umgeht

Was geschieht im Ausgangsscan?

Der Ausgangsscan prüft eine Auswahl von Seiten jedes Seitentyps in Ihrem Shop nach WCAG 2.2 Stufe AA und listet jeden gefundenen Fehler auf. Der Scanner führt 102 automatisierte Regeln aus. Ein Scan kann nicht alles nachweisen. Validiscan arbeitet außerdem 35 manuelle Prüfungen ab, die jedes WCAG-Kriterium abdecken, das keine Regel prüft.

Automatisierte Regeln
102
Manuelle Prüfungen
35
Ausgewählte Seiten, voreingestelltes Limit
150
Desktop-Größe, standardmäßig
1440 × 900 Pixel
Smartphone-Größe, standardmäßig
390 × 844 Pixel
Details: welche Seiten, Warenkorb und Checkout, die Regeln und die manuellen Prüfungen

Der Ausgangsscan prüft die Seiten Ihres Shops nach WCAG 2.2 Stufe AA und listet jeden gefundenen Fehler auf, jeweils mit dem, was er für Ihre Kundinnen und Kunden bedeutet.

Der Scan lädt eine Auswahl von Seiten jedes Seitentyps in Ihrem Shop, darunter die Startseite, Produktlisten, Produktseiten, den Warenkorb, den ersten Schritt im Checkout, Suchergebnisse, die Anmeldeseite, die Kontaktseite und die Rechtstexte. Wie viele Seiten je Seitentyp er lädt und wie hoch das Seitenlimit ist, wird für jeden Shop festgelegt; voreingestellt liegt das Limit bei 150 ausgewählten Seiten, und Suchergebnisse, die Anmeldeseite, die Kontaktseite, Rechtstexte, der Warenkorb und der erste Schritt im Checkout können noch dazukommen. Jede Seite wird standardmäßig in Desktop-Größe (1440 × 900 Pixel) und in Smartphone-Größe (390 × 844 Pixel) geladen. Um Warenkorb und Checkout zu erreichen, legt der Scan ein Produkt in den Warenkorb und öffnet den ersten Schritt im Checkout. Er schließt nie einen Kauf ab und gibt nie Zahlungsdaten ein.

Der Scanner führt 102 automatisierte Regeln aus: Regeln von axe-core und eigene Prüfungen von Validiscan für Probleme, die für Shops typisch sind, etwa bei Cookie-Bannern, Karussells, Formularen im Checkout und Preisaktualisierungen. Ein Scan kann nicht alles nachweisen. Validiscan arbeitet außerdem eine Checkliste mit 35 manuellen Prüfungen ab, die jedes WCAG-Kriterium abdeckt, das keine Regel prüft, und hält jede Prüfung mit Notizen als „Bestanden“, „Nicht bestanden“ oder „Nicht anwendbar“ fest.

Die Methode, die Standards und die Grenzen automatisierter Tests

Wie sortiert Validiscan die Befunde?

Validiscan geht die Befunde in der Triage durch, bevor etwas ausgeliefert wird. Derselbe Fehler auf vielen Seiten ist ein einziger Befund, mit der Zahl der betroffenen Seiten und Elemente, und jeder Befund hat eine von drei Korrekturstufen: AUTO, ASSISTED oder MANUAL.

Jeder Befund hat eine von drei Korrekturstufen:

AUTO
Ein deterministisches Rezept ändert den Quellcode des Themes: Derselbe Code erhält immer dieselbe Änderung.
ASSISTED
Die Änderung erfordert eine Einschätzung, zum Beispiel beim Namen einer Icon-Schaltfläche. KI darf sie nur entwerfen, wenn Sie dem zugestimmt haben, und Validiscan prüft jede entworfene Änderung, bevor sie ausgeliefert wird.
MANUAL
Nur Anleitung: eine Inhalts- oder Designentscheidung, die jemand treffen muss, etwa bei Untertiteln für Ihre Videos. Die Arbeit an Befunden der Stufe MANUAL, bei denen Sie selbst inhaltlich entscheiden müssen, ist nicht Teil eines Projekts.
Details: zusammengefasste Befunde und falsch positive Befunde

Bevor etwas ausgeliefert wird, geht Validiscan die Befunde durch. Dieser Schritt heißt Triage. Derselbe Fehler auf vielen Seiten, etwa eine Schaltfläche ohne Namen im Kopfbereich, ist ein einziger Befund, mit der Zahl der betroffenen Seiten und Elemente. Stellt sich heraus, dass ein Befund kein Fehler ist, wird er mit einer schriftlichen Begründung als falsch positiv markiert. Das Remediation Evidence Package führt solche Befunde als ausgeschlossene Befunde auf.

Wer prüft eine Änderung, bevor sie bei Ihnen ankommt?

Validiscan prüft jede Änderung, bevor sie ausgeliefert wird, und ausgeliefert werden nur Änderungen, die die automatische Validierung bestanden haben und die Validiscan freigegeben hat. Danach prüft Ihr Entwicklungsteam die Änderung noch einmal, oder Sie sehen sich die Theme-Kopie auf Shopify in der Vorschau an. Bei Validiscan prüft William Quaade Rasmussen die Änderungen.

Details: was die Validierung prüft, die Checkliste für Ihr Entwicklungsteam und wer bei Validiscan prüft

Validiscan prüft jede Änderung, bevor sie ausgeliefert wird: den Diff, das Ergebnis der automatischen Validierung und die Erklärung, was geändert wurde und warum. Die Validierung prüft jede geänderte Liquid-, Twig-, PHP-, HTML-, XML-, JavaScript- oder JSON-Datei mit einem Parser oder einer Syntaxprüfung für ihren Dateityp auf Fehler, und jede geänderte CSS-, SCSS- oder LESS-Datei mit einer Strukturprüfung, die nach nicht geschlossenen geschweiften Klammern, Zeichenketten und Kommentaren sucht, die Datei aber nicht kompiliert; keine dieser Prüfungen führt den Code Ihres Themes aus. Ausgeliefert werden nur Änderungen, die die Validierung bestanden haben und die Validiscan freigegeben hat. Eine abgelehnte Änderung erhält eine schriftliche Begründung und wird nicht ausgeliefert.

Danach prüft Ihr Entwicklungsteam die Änderung noch einmal, als gewöhnlichen Pull Request oder Patch, oder Sie sehen sich die Theme-Kopie auf Shopify in der Vorschau an. Die Checkliste in jedem Pull Request bittet Ihr Entwicklungsteam darum, den Branch außerhalb des Live-Shops auszuprobieren, die betroffenen Seiten zu prüfen und die geänderten Elemente allein mit der Tastatur und, wo möglich, mit einem Screenreader zu bedienen.

Bei Validiscan prüft William Quaade Rasmussen die Änderungen; er führt das Unternehmen allein. Weil die Änderungen in Ihrem Code liegen und das Paket Ihre Datei ist, hängt in Ihrem Shop danach nichts von Validiscan ab; der Regressionsschutz kann zum Ende jedes Monats gekündigt werden. Über Validiscan

Wie gelangen die Änderungen in Ihren Code?

Validiscan liefert Änderungen auf einem von drei Wegen aus: als Pull Request auf GitHub, als unveröffentlichte Kopie Ihres Shopify-Themes oder als Patch-Paket. Keiner davon berührt Ihren Live-Shop: Was live geht, entscheiden Sie oder Ihr Entwicklungsteam.

Die drei Wege, auf denen eine Auslieferung in Ihren Code gelangt
Weg Was Validiscan braucht Was ankommt Wer es live stellt
Ein Pull Request auf GitHub Zugriff auf das GitHub-Repository, in dem Ihr Theme liegt, über die GitHub App von Validiscan oder ein Zugriffstoken Ein einziger Pull Request gegen Ihren Standard-Branch, von einem neuen Branch aus, jede Korrektur als eigener Commit Sie oder Ihr Entwicklungsteam, durch Merge und Deployment des Pull Requests
Eine unveröffentlichte Kopie Ihres Shopify-Themes Ein Theme-Access-Passwort für Ihren Shopify-Shop Ein neues, unveröffentlichtes Theme mit dem Namen Validiscan A11y <date> in Ihrem Shopify-Adminbereich Sie, durch Veröffentlichen der Theme-Kopie
Ein Patch-Paket Kein Zugriff auf Ihre Systeme, aber ein Export Ihres Themes: eine einzige ZIP-Datei von bis zu 100 MB, hochgeladen im Kundenportal Ein ZIP-Archiv für Ihr Entwicklungsteam, das Validiscan Ihnen schickt Sie oder Ihr Entwicklungsteam, durch Einspielen des Pakets
Woraus ein Pull Request von Validiscan besteht
Branch
validiscan/a11y-<date>-<id>, zum Beispiel validiscan/a11y-20260924-9f8e7d6c
Commits
einer je Korrektur, mit einer Nachricht der Form fix(a11y): <finding title> (WCAG <criteria>)
Gegen
Ihren Standard-Branch; in ihn wird nichts übertragen
Beschreibung
eine Übersichtstabelle, eine Erklärung jeder Änderung und eine Checkliste für die Prüfung

Ein Pull Request auf GitHub

Liegt Ihr Theme in einem GitHub-Repository, geben Sie Validiscan Zugriff darauf, über die GitHub App von Validiscan oder ein Zugriffstoken. In der Einrichtung von Validiscan sind die Berechtigungen der App so festgelegt: Lese- und Schreibzugriff auf die Inhalte und die Pull Requests des Repositorys und Lesezugriff auf seine Metadaten, sonst nichts. Ein Zugriffstoken braucht dieselben Berechtigungen, und zwar für dieses eine Repository. Bei jeder Auslieferung geschieht dann Folgendes:

  1. Validiscan legt von Ihrem Standard-Branch aus einen neuen Branch mit dem Namen validiscan/a11y-<date>-<id> an, zum Beispiel validiscan/a11y-20260924-9f8e7d6c.
  2. Jede Korrektur wird einzeln committet, mit einer Nachricht der Form fix(a11y): <finding title> (WCAG <criteria>). So lässt sich jede Korrektur für sich behalten oder zurücknehmen.
  3. Validiscan öffnet einen einzigen Pull Request gegen Ihren Standard-Branch, mit einer Übersichtstabelle, einer Erklärung jeder Änderung und einer Checkliste für die Prüfung.

In Ihren Standard-Branch wird nichts übertragen. Ihr Entwicklungsteam prüft den Pull Request, probiert den Branch in einer Vorschau- oder Staging-Umgebung aus und führt ihn zusammen. Schließen Sie den Pull Request, ohne ihn zusammenzuführen, etwa weil sich Ihr Standard-Branch inzwischen weiterentwickelt hat und der Pull Request sich nicht mehr konfliktfrei zusammenführen lässt, kommen seine Änderungen wieder auf die Liste von Validiscan für eine spätere Auslieferung, die erneut von Ihrem Standard-Branch in seinem dann aktuellen Stand ausgeht.

Eine unveröffentlichte Kopie Ihres Shopify-Themes

Auf Shopify können Sie Validiscan stattdessen ein Theme-Access-Passwort für Ihren Shop geben. Validiscan lädt Ihr Live-Theme herunter, wendet die Änderungen an und lädt das Ergebnis als neues, unveröffentlichtes Theme mit dem Namen Validiscan A11y <date> hoch, zum Beispiel Validiscan A11y 2026-09-24. Validiscan lädt nie etwas in Ihr Live-Theme hoch und veröffentlicht nie ein Theme.

Sie finden die Kopie in Ihrem Shopify-Adminbereich unter „Onlineshop“ und dann „Themes“. Sehen Sie sich die Kopie in der Vorschau an, prüfen Sie die betroffenen Seiten, auch allein mit der Tastatur, und veröffentlichen Sie sie, wenn Sie zufrieden sind. Bis dahin sehen Ihre Besucherinnen und Besucher Ihr Live-Theme. Die Kopie ist Ihr Live-Theme im Stand vom Tag der Auslieferung: Ändern Sie das Live-Theme danach, übernehmen Sie dieselbe Änderung vor dem Veröffentlichen auch in die Kopie, sonst geht sie verloren. Behalten Sie Ihr bisheriges Theme, bis Sie sicher sind; Sie können wieder zu ihm wechseln.

Ein Patch-Paket und woher ein Theme-Export kommt

Ohne Zugriff auf ein Repository oder einen Shopify-Shop kommen die Änderungen als Patch-Paket: ein ZIP-Archiv, das Validiscan Ihnen für Ihr Entwicklungsteam schickt. Es enthält:

  • PATCH.md: was geändert wurde und warum, je Befund, mit der genauen Codeänderung und einer Anleitung zum Einspielen;
  • validiscan-a11y.patch: alle Änderungen in einem einzigen Patch, der sich mit git apply einspielen lässt;
  • diffs/: dieselben Änderungen als eine Patch-Datei je Korrektur, um sie einzeln einzuspielen;
  • files/: die vollständigen geänderten Dateien, auf Grundlage Ihres Theme-Exports;
  • README.md: was das Archiv enthält und womit Sie beginnen.

Grundlage des Pakets ist ein Export Ihres aktuellen Themes: eine einzige ZIP-Datei von bis zu 100 MB, die ein Admin Ihrer Organisation im Kundenportal hochlädt, zum Beispiel Ihre Entwicklerin oder Ihr Entwickler. Validiscan verweist dann bei jeder Änderung auf die genaue Datei und Zeile. Ohne Export gibt es keinen Quellcode, der sich ändern ließe, und deshalb lässt sich auch kein Patch-Paket erstellen.

Woher ein Theme-Export kommt, je Plattform
Plattform So erhalten Sie den Export
Shopify Öffnen Sie im Shopify-Adminbereich „Onlineshop“ und dann „Themes“. Wählen Sie im Menü des Themes, das Sie verwenden, „Theme-Datei herunterladen“. Shopify sendet die ZIP-Datei per E-Mail.
Shopware Ihr Entwicklungsteam erstellt ein ZIP Ihres Theme-Plugins: seinen Ordner unter custom/plugins, so wie er in Ihrem Shop installiert ist.
WooCommerce Ihr Entwicklungsteam erstellt ein ZIP Ihres Theme-Ordners unter wp-content/themes, einschließlich des Child-Themes, falls Sie eines verwenden.
Magento Ihr Entwicklungsteam erstellt ein ZIP Ihres Theme-Ordners unter app/design/frontend.

Shopify beschreibt den Download eines Themes im Hilfeartikel „Downloading themes“, auf Englisch: Die ZIP-Datei geht an die E-Mail-Adresse des Mitarbeiterkontos, das sie angefordert hat.

Wie die Auslieferungsdokumente aussehen

Unten steht die Beschreibung eines Pull Requests genau so, wie die Anwendung sie für ihren fiktiven Testshop Nordlicht Outdoor schreibt. Darunter folgen, eingeklappt, die PATCH.md und die README.md eines Patch-Pakets für denselben Shop. Diese Dokumente gibt es auf Englisch und auf Deutsch; die Titel der Befunde, die Erklärungen der Änderungen und die Namen der WCAG-Kriterien bleiben darin englisch. Die Links in den Beispielen sind als einfacher Text wiedergegeben: In einer echten Auslieferung öffnen sie den Befund in Validiscan, nach einer Anmeldung. Ein weiterer Unterschied: Im Beispiel der PATCH.md ist jede Änderung gegenüber dem ursprünglichen Theme dargestellt, daher lassen sich die zweite und die dritte Änderung darin, beide in sections/header.liquid, nicht nacheinander einspielen. In einem echten Patch-Paket baut jeder Patch in diffs/ auf den vorherigen auf, und die Patches lassen sich in der Reihenfolge ihrer Nummern einspielen. Außerdem wurden die Beispiele der PATCH.md und der README.md für ein Paket ohne Theme-Export erstellt: Deshalb steht in der PATCH.md der Hinweis, es habe keine Kopie Ihrer Theme-Dateien vorgelegen, und in beiden fehlt der Ordner files/. Ein echtes Patch-Paket entsteht immer aus Ihrem Theme-Export; es enthält diesen Hinweis nicht, dafür aber den Ordner files/ mit den vollständigen geänderten Dateien.

Beschreibung eines Pull Requests, wie sie für einen fiktiven Shop erstellt wurde Beispieldaten

Korrekturen zur Barrierefreiheit von Validiscan

Dieser Pull Request behebt 3 Barrierefreiheitsprobleme, die Validiscan auf Nordlicht Outdoor (https://nordlicht-outdoor.example) gefunden hat. Alle Änderungen sind gewöhnliche Anpassungen am Quellcode Ihres Themes: keine Skripte, keine Overlays, nichts, was zusätzlich im Browser Ihrer Besucher ausgeführt wird. Jede Korrektur ist ein eigener Commit. So können Sie die Änderungen einzeln prüfen, übernehmen oder zurücknehmen.

An Ihrer Live-Website wurde nichts geändert Validiscan hat nur diesen Branch und diesen Pull Request angelegt. Es wurde nichts in Ihren Standard-Branch übertragen und nichts auf Ihrer Live-Website veröffentlicht; Merge und Deployment bleiben vollständig in Ihrer Hand.

Übersicht

Die Tabelle lässt sich seitlich verschieben.

# Befund WCAG-Erfolgskriterium Auswirkung Dateien
1 <html> element must have a lang attribute 3.1.1 Language of Page (A) Schwerwiegend layout/theme.liquid
2 Images must have alternative text 1.1.1 Non-text Content (A) Kritisch sections/header.liquid
3 Buttons must have discernible text 4.1.2 Name, Role, Value (A) Kritisch sections/header.liquid

Was geändert wurde und warum

1. <html> element must have a lang attribute
  • WCAG-Erfolgskriterium: 3.1.1 Language of Page (A)
  • Auswirkung: Schwerwiegend
  • Dateien: layout/theme.liquid (geändert, +1 -1)
  • Befund in Validiscan öffnen (Screenshots und alle betroffenen Seiten; Anmeldung erforderlich)

Adds lang="{{ request.locale.iso_code }}" to the <html> element so screen readers pronounce the page in the right language (WCAG 3.1.1).

2. Images must have alternative text
  • WCAG-Erfolgskriterium: 1.1.1 Non-text Content (A)
  • Auswirkung: Kritisch
  • Dateien: sections/header.liquid (geändert, +1 -1)
  • Befund in Validiscan öffnen (Screenshots und alle betroffenen Seiten; Anmeldung erforderlich)

The logo image is the only content of the home link, so it gets the shop name as its alternative text (WCAG 1.1.1).

3. Buttons must have discernible text
  • WCAG-Erfolgskriterium: 4.1.2 Name, Role, Value (A)
  • Auswirkung: Kritisch
  • Dateien: sections/header.liquid (geändert, +1 -1)
  • Befund in Validiscan öffnen (Screenshots und alle betroffenen Seiten; Anmeldung erforderlich)

The icon-only search button gets an accessible name from the theme’s locale file (WCAG 4.1.2).

Nicht enthalten

Eine freigegebene Korrektur konnte nicht angewendet werden: Der betroffene Code hat sich seit ihrer Erstellung geändert, oder eine andere Korrektur dieser Lieferung ändert dieselben Zeilen. Validiscan erstellt sie neu und liefert sie separat.

  • Links must have discernible text

Checkliste für die Prüfung

  • Prüfen Sie den Diff jedes Commits; die Änderungen sind klein und auf die oben genannten Dateien beschränkt.
  • Stellen Sie diesen Branch in einer Vorschau- oder Staging-Umgebung bereit (nicht in Ihrem Live-Shop).
  • Öffnen Sie die betroffenen Seiten und prüfen Sie, ob sie wie bisher aussehen und funktionieren.
  • Bedienen Sie die geänderten Elemente nur mit der Tastatur (Tab, Umschalt+Tab, Eingabe, Leertaste, Esc): Alles muss erreichbar und der Fokus sichtbar sein.
  • Prüfen Sie die geänderten Elemente nach Möglichkeit mit einem Screenreader (zum Beispiel NVDA oder VoiceOver).
  • Führen Sie den Merge durch, wenn Sie zufrieden sind. Validiscan prüft die betroffenen Seiten anschließend mit einem Verifizierungsscan.

Erstellt von Validiscan (validiscan.com) am 24. September 2026 · Lieferung 9f8e7d6c

PATCH.md eines Patch-Pakets Beispieldaten
PATCH.md anzeigen, mit der Codeänderung für jeden Befund

Korrekturen zur Barrierefreiheit für Nordlicht Outdoor

Erstellt von Validiscan am 24. September 2026 für https://nordlicht-outdoor.example. Dieses Dokument beschreibt 3 Änderungen am Quellcode, die Barrierefreiheitsprobleme auf Nordlicht Outdoor beheben, mit der genauen Codeänderung für jeden Befund und einer Anleitung zur Umsetzung.

An Ihrer Live-Website wurde nichts geändert. Sie oder Ihr Entwickler übernehmen die Änderungen, testen sie und veröffentlichen sie. Es handelt sich um gewöhnliche Anpassungen am Quellcode Ihres Themes: keine Skripte, keine Overlays.

Übersicht

Die Tabelle lässt sich seitlich verschieben.

# Befund WCAG-Erfolgskriterium Auswirkung Dateien
1 <html> element must have a lang attribute 3.1.1 Language of Page (A) Schwerwiegend layout/theme.liquid
2 Images must have alternative text 1.1.1 Non-text Content (A) Kritisch sections/header.liquid
3 Buttons must have discernible text 4.1.2 Name, Role, Value (A) Kritisch sections/header.liquid

So übernehmen Sie die Änderungen

Mit git

Entpacken Sie dieses Archiv und führen Sie dann diese Befehle im Stammverzeichnis Ihres Themes aus (dem Ordner, der die unten genannten Pfade enthält). Ersetzen Sie dabei path/to/bundle durch den Ordner, in den Sie das Archiv entpackt haben. Der erste Befehl prüft nur, ob sich die Änderungen anwenden lassen; der zweite wendet alle an.

git apply --check path/to/bundle/validiscan-a11y.patch
git apply path/to/bundle/validiscan-a11y.patch

Wenn Sie die Korrekturen lieber einzeln übernehmen möchten, wenden Sie die Dateien in diffs/ in numerischer Reihenfolge mit git apply an.

Ohne git

Alternativ können Sie jede Änderung anhand der folgenden Abschnitte von Hand in einem Code-Editor vornehmen.

So lesen Sie eine Änderung: Zeilen, die mit - beginnen, werden entfernt; Zeilen, die mit + beginnen, werden hinzugefügt. Alle übrigen Zeilen sind unveränderter Kontext, der Ihnen hilft, die richtige Stelle zu finden. Die Zeilennummern nach @@ sind nur ungefähre Angaben, falls sich die Datei inzwischen geändert hat.

Uns lag keine Kopie Ihrer Theme-Dateien vor. Die Dateipfade folgen daher der Standardstruktur Ihrer Plattform. Falls ein Pfad in Ihrem Theme nicht existiert, suchen Sie in Ihrem Theme nach den unveränderten Kontextzeilen der Änderung.

Änderungen

1. <html> element must have a lang attribute
  • WCAG-Erfolgskriterium: 3.1.1 Language of Page (A)
  • Auswirkung: Schwerwiegend
  • Dateien: layout/theme.liquid (geändert, +1 -1)
  • Patch-Datei: diffs/01-a1b2c3d4.patch
  • Befund in Validiscan öffnen (Screenshots und alle betroffenen Seiten; Anmeldung erforderlich)

Adds lang="{{ request.locale.iso_code }}" to the <html> element so screen readers pronounce the page in the right language (WCAG 3.1.1).

diff --git a/layout/theme.liquid b/layout/theme.liquid
--- a/layout/theme.liquid
+++ b/layout/theme.liquid
@@ -1,5 +1,5 @@
 <!doctype html>
-<html class="no-js">
+<html class="no-js" lang="{{ request.locale.iso_code }}">
   <head>
     <title>{{ page_title }}</title>
   </head>
2. Images must have alternative text
  • WCAG-Erfolgskriterium: 1.1.1 Non-text Content (A)
  • Auswirkung: Kritisch
  • Dateien: sections/header.liquid (geändert, +1 -1)
  • Patch-Datei: diffs/02-b2c3d4e5.patch
  • Befund in Validiscan öffnen (Screenshots und alle betroffenen Seiten; Anmeldung erforderlich)

The logo image is the only content of the home link, so it gets the shop name as its alternative text (WCAG 1.1.1).

diff --git a/sections/header.liquid b/sections/header.liquid
--- a/sections/header.liquid
+++ b/sections/header.liquid
@@ -1,6 +1,6 @@
 <header class="header">
   <a href="/" class="header__heading-link">
-    <img src="{{ 'logo.svg' | asset_url }}" width="120" height="40">
+    <img src="{{ 'logo.svg' | asset_url }}" width="120" height="40" alt="{{ shop.name }}">
   </a>
   <button type="button" class="header__icon header__icon--search">
     <svg class="icon icon-search" aria-hidden="true"></svg>
3. Buttons must have discernible text
  • WCAG-Erfolgskriterium: 4.1.2 Name, Role, Value (A)
  • Auswirkung: Kritisch
  • Dateien: sections/header.liquid (geändert, +1 -1)
  • Patch-Datei: diffs/03-c3d4e5f6.patch
  • Befund in Validiscan öffnen (Screenshots und alle betroffenen Seiten; Anmeldung erforderlich)

The icon-only search button gets an accessible name from the theme’s locale file (WCAG 4.1.2).

diff --git a/sections/header.liquid b/sections/header.liquid
--- a/sections/header.liquid
+++ b/sections/header.liquid
@@ -2,7 +2,7 @@
   <a href="/" class="header__heading-link">
     <img src="{{ 'logo.svg' | asset_url }}" width="120" height="40">
   </a>
-  <button type="button" class="header__icon header__icon--search">
+  <button type="button" class="header__icon header__icon--search" aria-label="{{ 'general.search.search' | t }}">
     <svg class="icon icon-search" aria-hidden="true"></svg>
   </button>
 </header>

Nicht enthalten

Diese freigegebenen Korrekturen ließen sich nicht auf Ihren Theme-Export anwenden: Der betroffene Code weicht von der Version ab, für die sie erstellt wurden, oder eine andere Korrektur dieses Pakets ändert dieselben Zeilen. Sie sind nicht Teil dieses Pakets; Validiscan erstellt sie neu.

  • Links must have discernible text (sections/header.liquid)

Nach der Umsetzung

  1. Testen Sie die betroffenen Seiten vor der Veröffentlichung in einer Vorschau- oder Staging-Umgebung.
  2. Bedienen Sie die geänderten Elemente nur mit der Tastatur: Alles muss erreichbar und der Fokus sichtbar sein.
  3. Veröffentlichen Sie die Änderungen und geben Sie uns Bescheid: Validiscan prüft die betroffenen Seiten dann mit einem Verifizierungsscan.

Erstellt von Validiscan (validiscan.com) am 24. September 2026 · Lieferung 9f8e7d6c

Fragen? Schreiben Sie an info@validiscan.com und nennen Sie die Lieferung 9f8e7d6c.

README.md eines Patch-Pakets Beispieldaten
README.md anzeigen, mit dem Inhalt des Archivs

Validiscan: Korrekturen zur Barrierefreiheit für Nordlicht Outdoor

Dieses Archiv enthält 3 Korrekturen zur Barrierefreiheit für Ihr Theme, erstellt von Validiscan am 24. September 2026. Beginnen Sie mit PATCH.md: Dort werden alle Änderungen erläutert, und Sie erfahren, wie Sie sie übernehmen.

Inhalt

  • PATCH.md: was geändert wurde und warum, je Befund, mit der genauen Codeänderung und einer Anleitung
  • validiscan-a11y.patch: alle Änderungen dieses Pakets in einem Patch (Unified Diff; anwendbar mit git apply)
  • diffs/: dieselben Änderungen als eine Patch-Datei je Korrektur, einzeln in numerischer Reihenfolge anwendbar
  • README.md: diese Datei

Schnellstart

  1. Sichern Sie Ihr Theme oder arbeiten Sie mit einer Kopie bzw. einem Vorschau-Theme.
  2. Wenden Sie die Patches mit git apply an (siehe PATCH.md) oder nehmen Sie die Änderungen von Hand vor.
  3. Testen Sie die betroffenen Seiten und veröffentlichen Sie sie anschließend.

Nichts in diesem Archiv wird von selbst auf Ihrer Website ausgeführt: keine Skripte, keine Widgets, keine Overlays. Jede Korrektur ist eine Änderung am Quellcode Ihres eigenen Themes.


Erstellt von Validiscan (validiscan.com) am 24. September 2026 · Lieferung 9f8e7d6c

Fragen? Schreiben Sie an info@validiscan.com und nennen Sie die Lieferung 9f8e7d6c.

Wie prüft Validiscan, ob die Änderungen wirken?

Ein Verifizierungsscan prüft, ob die Änderungen wirken, sobald sie in Ihrem Shop live sind. Ein Befund mit ausgelieferter Änderung, den der Verifizierungsscan auf keiner der Seiten mehr findet, auf denen er zuletzt gefunden wurde, wird als behoben markiert; ein behobener Befund, der wieder auftritt, ist wieder offen.

Läuft
sobald die Änderungen in Ihrem Shop live sind
Umfasst
die Seitentypen, die von den Änderungen betroffen sind, und jede Seite, auf der ein ausgelieferter Befund zuletzt gefunden wurde
Wer ihn anfordert
ein Admin Ihrer Organisation im Kundenportal, oder Sie per E-Mail an Validiscan
Details: welche Seiten der Scan umfasst und wie Sie ihn anfordern

Sobald die Änderungen in Ihrem Shop live sind, prüft ein Verifizierungsscan, ob sie wirken. Er umfasst die Seitentypen, die von den Änderungen betroffen sind, und jede Seite, auf der ein ausgelieferter Befund zuletzt gefunden wurde. Ein Befund mit ausgelieferter Änderung, den der Verifizierungsscan auf keiner der Seiten mehr findet, auf denen er zuletzt gefunden wurde, wird als behoben markiert. Ein behobener Befund, der wieder auftritt, ist wieder offen.

Was Sie tun: Stellen Sie die Änderungen live, durch Merge und Deployment des Pull Requests, durch Veröffentlichen der Theme-Kopie oder durch Einspielen des Pakets. Bitten Sie danach um den Verifizierungsscan: Ein Admin Ihrer Organisation fordert ihn im Kundenportal an, oder Sie geben Validiscan per E-Mail Bescheid.

Was hält das Remediation Evidence Package fest?

Das Remediation Evidence Package ist ein datierter Nachweis darüber, was geprüft und geändert wurde und was der Verifizierungsscan bestätigt hat. Es enthält den Entwurf einer Erklärung zur Barrierefreiheit für Ihren Shop, gekennzeichnet als Entwurf für die rechtliche Prüfung, und hält fest, dass es kein Zertifikat ist und keine Aussage über die Einhaltung gesetzlicher Vorgaben trifft.

Grundlage
der Ausgangsscan, der Verifizierungsscan und die manuellen Prüfungen
Dateien
PDF, DOCX und JSON in einem ZIP-Archiv
Prüfsummen
SHA-256
Fertiges Paket
ändert sich nicht mehr; eine Berichtigung ist eine neue Version
Wo Sie es erhalten
im Kundenportal
Details: die Grundlage des Pakets, seine Dateien und seine Aussage zum Umfang

Nach dem Verifizierungsscan erstellt Validiscan das Remediation Evidence Package: einen datierten Nachweis darüber, was geprüft und was geändert wurde und was der Verifizierungsscan bestätigt hat. Grundlage sind der Ausgangsscan, der Verifizierungsscan und die manuellen Prüfungen. Sie erhalten es als PDF, DOCX und JSON in einem ZIP-Archiv mit SHA-256-Prüfsummen. Es enthält den Entwurf einer Erklärung zur Barrierefreiheit für Ihren Shop, gekennzeichnet als Entwurf für die rechtliche Prüfung. Ein fertiges Paket ändert sich nicht mehr; eine Berichtigung ist eine neue Version. Sie laden das Paket im Kundenportal herunter.

Seine Aussage zum Umfang lautet: „Konformität mit den Erfolgskriterien von WCAG 2.1 Stufe AA und WCAG 2.2 Stufe AA, geprüft auf den aufgeführten Seiten zu den angegebenen Daten.“ Dort heißt es außerdem: „Dieses Paket belegt eine Prüfung und die durchgeführten Arbeiten zur Behebung. Es ist kein Zertifikat und trifft keine Aussage über die Einhaltung gesetzlicher Vorgaben.“

Was das Remediation Evidence Package enthält

Was geschieht nach dem Projekt?

Der Regressionsschutz ist der optionale letzte Schritt: Validiscan scannt Ihren Shop jede Woche erneut und vergleicht das Ergebnis mit dem letzten Verifizierungsscan nach den Korrekturen. Ein behobenes Problem, das zurückkehrt, etwa nach einem Update des Themes oder einer App, ist wieder offen; die Behebung dessen, was ein erneuter Scan findet, ist nicht Teil des Regressionsschutzes.

Details: was ein Projekt umfasst, wann Sie eine E-Mail erhalten, und die Zeitleiste

Ein Projekt gilt für einen Shop: eine Domain und ein Theme. Es umfasst den Ausgangsscan, die manuellen Prüfungen, die Korrekturen der Stufen AUTO und ASSISTED, ausgeliefert auf einem der drei oben beschriebenen Wege, einen Verifizierungsscan und das Remediation Evidence Package.

Der Regressionsschutz ist der optionale letzte Schritt und wird monatlich abgerechnet. Validiscan scannt Ihren Shop jede Woche erneut und vergleicht das Ergebnis mit dem Ausgangsstand, also dem letzten Verifizierungsscan nach den Korrekturen. Behobene Probleme können zurückkehren, etwa nach einem Update des Themes oder einer App. Ein zurückgekehrtes Problem ist wieder offen.

Validiscan schickt je erneutem Scan höchstens eine E-Mail: wenn der Scan ein behobenes Problem wiedergefunden hat, ein neues Problem gefunden hat, ein Problem nicht mehr findet oder eine Veränderung bei den erfassten Seiten festgestellt hat, und wenn der Scan nicht abgeschlossen werden konnte. Ein erneuter Scan ohne eines dieser Ergebnisse löst keine E-Mail aus, es sei denn, Sie haben Validiscan darum gebeten. Das Kundenportal zeigt jeden erneuten Scan auf einer Zeitleiste. Die Behebung dessen, was ein erneuter Scan findet, ist nicht Teil des Regressionsschutzes.

Wie der Regressionsschutz funktioniert

Beginnen Sie mit einem kostenlosen Check Ihres Shops.

Senden Sie die Adresse Ihres Shops. Validiscan scannt ihn und antwortet mit jedem Fehler, den der Scan nachweisen kann, jeweils mit der Seite und dem Code.

Kostenlosen Check anfordern

Oder schreiben Sie an info@validiscan.com.

Was der kostenlose Check umfasst und was nicht
Sie senden
die Adresse Ihres Shops
Gescannte Seiten
bis zu 15
Sie erhalten
jeden Fehler, den der Scan nachweisen kann, mit Seite und Code
In Ihrem Shop
nur öffentliche Seiten; keine Anmeldung, nichts gekauft, kein Formular abgeschickt
Was er nicht ist
ein vollständiges Audit

Nachricht an Validiscan

Für einen kostenlosen Check nennen Sie die Adresse Ihres Shops und seine Plattform.

Validiscan verwendet, was Sie senden, um Ihnen zu antworten. Datenschutzerklärung