axe-core audit-screenshots als release-artefact

De claim die meestal niet wordt onderbouwd

"WCAG 2.1 AA compliant" staat in talloze plugin-beschrijvingen. Bij directe controle blijkt het label vaak een aspiratie: niemand heeft recent een tool langs de admin- of storefront-pagina's laten lopen. Voor een agency die een toegankelijkheidsbeoordeling moet doen voor een klant in de publieke sector, is een onderbouwde claim onmisbaar — een onderbouwingsloze claim is in dat scenario eerder schadelijk dan helpend.

Wat er voor de Shopware Plugin Suite is opgezet

Voor alle zeven plugin-families in de suite werd een vaste audit-structuur geïntroduceerd: docs/audits/<datum>/. In die folder zit per release:

• Een axe-core JSON-output — de ruwe scan-resultaten van de toolset, niet een zelfgeschreven samenvatting.
• Screenshots — visuele bevestiging van wat is gescand: admin-overzicht, configuratie-formulier, storefront-block. Eén beeld per scangebied.
• Een korte README — context: welke pagina's, welke browser, welke axe-versie, welke bevindingen wel/niet zijn opgepakt.

De live axe-core run gebeurt headless tegen een lokale Shopware-instance met de plugin geïnstalleerd. De screenshots worden vóór commit doorlopen en bijgewerkt — geen oude beelden uit een vorige release.

Waarom dit meer waard is dan een vinkje

Een vinkje "WCAG-compliant" in de plugin-omschrijving zegt: "wij beweren dat het werkt". Een audit-folder zegt: "hier is wat de tool ziet, hier zijn de pagina's, hier zijn de bevindingen, hier is het versie-spoor". Dat is een fundamenteel ander signaal aan een evaluator. Voor agencies die een audit moeten leveren aan een klant — vaak in publiek-sector- of zorg-contexten — is een rapport-met-screenshots een halve audit-besparing. De plugin-leverancier heeft het werk al deels gedaan.

Wat de screenshots feitelijk laten zien

De audits van 27 april 2026 voor de Shopware Plugin Suite tonen 0 violations op de geprioriteerde scangebieden, een handvol "best-practice"-aandachtspunten en een transparante notitie over een eerder geconstateerde WCAG-A-fout die in dezelfde release is opgelost. Geen verstopt verhaal, geen "we hebben er nog niet naar gekeken"-pagina's. Een evaluator die zelf 20 minuten de tijd heeft, kan zien wat is gescand en wat niet.

Onderhouden door de release-flow

Het verschil tussen een eenmalige audit en een audit-cultuur ligt in de release-flow. In de Shopware Plugin Suite is afgesproken dat elke nieuwe release een nieuwe audit-folder krijgt, gedateerd op release-datum. Wat impliciet bewaakt wordt: regressies in toegankelijkheid komen direct aan het licht doordat de scan opnieuw wordt gedraaid, en niet maandenlater wanneer een klant ze meldt. Bewijs is geen losstaand artefact maar een ritueel — net als CHANGELOG-entries en JUnit-rapporten.