EAA-toegankelijkheid: Widget en WCAG-correcties (dfaccessibility)
Installatie, configuratie en gebruik van de module EAA-toegankelijkheid: widget, automatische WCAG-correcties, wettelijke verklaring en statistieken.
DF Accessibility brengt uw PrestaShop-winkel in overeenstemming met de Europese toegankelijkheidsrichtlijn (EAA, Richtlijn (EU) 2019/882) met drie bouwstenen: een toegankelijkheidswidget waarvan u de opties kiest, een motor voor automatische WCAG-correcties op elke pagina en een generator voor de wettelijke toegankelijkheidsverklaring in 8 talen.
Deze documentatie beschrijft versie 1.3.0 van de module, compatibel met PrestaShop 8.0.0 tot 9.x. Geen class-overrides, geen Composer-afhankelijkheid, geen externe requests.
Installatie en updates
- Open in uw PrestaShop-backoffice Modules > Modulebeheer.
- Klik op Een module uploaden en sleep het bestand
dfaccessibility.ziperin. - Klik na de installatie op Configureren.
De module registreert zich op de hooks displayHeader, actionFrontControllerSetMedia, displayBeforeBodyClosingTag en displayFooter (de laatste dient als terugval voor thema’s die de vorige niet aanroepen) en maakt een statistiektabel aan. Direct na de installatie is de widget actief met al zijn opties, en zijn alle automatische correcties ingeschakeld behalve de contrastcorrectie.
Om bij te werken uploadt u het nieuwe ZIP-bestand gewoon over de geïnstalleerde module, zonder te verwijderen: de updatescripts voegen de nieuwe instellingen toe en behouden uw configuratie.
Configuratie
Toegankelijkheidswidget
- Widget inschakelen: toont de zwevende knop in de front-office. De widget uitschakelen stopt ook de toepassing van voorkeuren die bezoekers eerder hebben opgeslagen.
- Positie van de knop: rechtsonder of linksonder.
- Accentkleur: gebruikt voor de knop, de actieve opties in het paneel en de afgedwongen focusrand. Kies een kleur met voldoende contrast tegen wit (het standaardblauw
#2563EBhaalt de AA-verhouding). - Knop verbergen op mobiel: verbergt de zwevende knop onder 768px.
- Knop verbergen in winkelwagen en checkout: haalt de knop weg van de winkelwagen- en bestelpagina’s, ook bij one-page-checkoutmodules die de paginanaam
orderbehouden. - Opties in de widget: één selectievakje per optie (tekstgrootte, hoog contrast, leesbaar lettertype, witruimte, gemarkeerde links, grote cursor, leeslineaal, animaties stoppen, afbeeldingen verbergen). Als geen enkele optie is aangevinkt, wordt de zwevende knop verborgen.
Wanneer de knop verborgen is op mobiel, in de winkelwagen of in de checkout, blijven de voorkeuren die de bezoeker al heeft ingeschakeld en de automatische correcties van kracht. Een bezoeker in hoog contrast blijft in hoog contrast tot aan de betaling.
Een niet aangevinkte optie wordt ook niet meer toegepast bij bezoekers die ze al hadden ingeschakeld. Dat is bewust: zonder knop zou de bezoeker ze niet meer kunnen uitschakelen.
Automatische correcties
Elke correctie is afzonderlijk in te schakelen. Ze worden in de browser van de bezoeker uitgevoerd bij het laden van de pagina en bij later toegevoegde inhoud: uw themabestanden worden nooit gewijzigd.
- Ontbrekende alt-teksten: zie de details hieronder.
- Formuliervelden zonder label: voegt een
aria-labeltoe op basis van de placeholder of de veldnaam. - Links die een nieuw venster openen: voegt
rel=noopeneren een hoorbare waarschuwing voor schermlezers toe. - Iframes zonder titel: voegt een
title-attribuut toe op basis van het brondomein. - ARIA-landmarks: voegt de rollen
bannerencontentinfoen een navigatie-aria-labeltoe wanneer ze ontbreken. - Skiplink: voegt een link „Naar de hoofdinhoud” toe die verschijnt bij de eerste druk op Tab.
- Zichtbare focusrand: dwingt een rand af bij toetsenbordfocus (WCAG-criterium 2.4.7).
- Automatische contrastcorrectie: standaard uitgeschakeld, zie de aparte sectie.
Statistieken
Als het verzamelen is ingeschakeld, telt elke browser de toegepaste correcties op en verstuurt ze hooguit eenmaal per minuut, bij het sluiten of verlaten van de pagina. De tellers worden per dag en per winkel geaggregeerd: geen cookie, geen identificatie, geen persoonsgegevens.
De widget voor de bezoeker
De zwevende knop opent een paneel met de opties die u hebt aangevinkt:
- Tekstgrootte: 5 stappen van 100 tot 150 %.
- Hoog contrast: slimme modus, hieronder beschreven.
- Leesbaar lettertype: schakelt over naar Verdana, Tahoma, Arial.
- Meer tussenruimte: letters 0,12 em, woorden 0,16 em, regelhoogte 1,6 en 2 em tussen alinea’s, de testwaarden van WCAG-criterium 1.4.12.
- Links markeren: gele achtergrond en systematische onderstreping.
- Grote cursor: vergrote pijl en vergrote hand boven links en knoppen.
- Leeslineaal: horizontale balk die de muis volgt.
- Animaties stoppen: neutraliseert CSS-animaties en -overgangen, pauzeert automatisch afspelende video’s en Bootstrap-, Swiper-, Slick- en Owl-sliders (WCAG-criteria 2.2.2 en 2.3.3).
- Afbeeldingen verbergen: verbergt afbeeldingen, video’s en achtergrondafbeeldingen.
- Alle instellingen herstellen: terug naar de oorspronkelijke toestand.
Het paneel is volledig met het toetsenbord te bedienen: focustrap, sluiten met Escape, aria-pressed-status op elke optie. Voorkeuren worden uitsluitend in de localStorage van de browser bewaard en op de volgende pagina’s vóór de eerste weergave opnieuw toegepast, zonder flikkering en zonder gegevens naar uw servers.
Iconenlettertypen (Material Icons van het Classic-thema, Font Awesome) zijn uitgesloten van het leesbare lettertype en de tussenruimte, zodat iconen nooit in tekst veranderen.
Tekstgrootte
De module vergroot de rootgrootte van de pagina vanaf de waarde van uw thema, waardoor alle teksten in rem en em groeien, ook bij thema’s met een root van 62,5 %. Teksten in pixels, die de root niet volgen, worden één voor één vergroot. Elke tekst wordt maar één keer vergroot, ongeacht de eenheid.
Het slimme hoge contrast
Klassieke widgets dwingen op alle elementen een witte achtergrond en volledige dekking af, waardoor het beeld van sliders verdwijnt en verborgen slides, ingeklapte menu’s en achtergronden van modale vensters weer verschijnen. Hier analyseert de module de hele pagina, in blokken zodat ze niet vastloopt:
- effen achtergronden en kleurverlopen worden wit;
- elementen met een achtergrondafbeelding, en bijschriften boven een sliderafbeelding, blijven behouden: hun teksten krijgen een halfdoorzichtig wit vlak;
- teksten worden zwart, links donkerblauw en onderstreept (geel bij aanwijzen), knoppen en velden krijgen een witte achtergrond en een zwarte rand van 2px;
- niets wat het thema verbergt, verschijnt weer.
De afgedwongen kleuren gelden pas als de analyse klaar is, om zwarte tekst op een donkere achtergrond tijdens het laden te voorkomen. Uitschakelen herstelt de oorspronkelijke stijlen, ook inline-stijlen van een paginabouwer.
Op mobiel
Onder 768px wordt de knop 44px (de aanraakdoelgrootte van WCAG-criterium 2.5.5) en staat hij 14px van de randen. Het paneel gebruikt de schermbreedte, tot 320px.
De automatische correcties in detail
Alt-teksten (WCAG 1.1.1)
Voor elke afbeelding zonder alt-attribuut past de module in deze volgorde toe:
- afbeelding verborgen voor hulptechnologieën, trackingpixel, of afbeelding in een link die al tekst bevat: lege
alt(decoratieve afbeelding); - anders het bijschrift
figcaptionof hettitle-attribuut; - anders de producttitel van de omliggende miniatuur;
- als laatste redmiddel de opgeschoonde bestandsnaam, als die betekenisvol is.
Is geen van deze bronnen betrouwbaar, dan blijft de afbeelding ongewijzigd, in plaats van ze met een lege alt ten onrechte voor schermlezers te verbergen.
De automatische correctie is een vangnet. Schrijf voor uw belangrijke productafbeeldingen de alt-teksten met de hand in uw catalogus: de module raakt bestaande alt-attributen nooit aan.
Formulieren (WCAG 1.3.1, 4.1.2)
Velden zonder gekoppeld label, zonder aria-label en zonder title krijgen een aria-label op basis van de placeholder, of anders de veldnaam.
Links en iframes (WCAG 3.2.5, 4.1.2)
Links met target=_blank krijgen rel=noopener en een aria-label aangevuld met „opent in een nieuw venster”. Iframes zonder titel krijgen een title met het ingesloten domein.
Structuur en navigatie (WCAG 1.3.1, 2.4.1, 2.4.7)
ARIA-rollen worden toegevoegd als het thema ze niet declareert, de skiplink wordt bovenaan de pagina ingevoegd en de focusrand wordt via :focus-visible afgedwongen. In het Classic-thema, waar de tag <main> ook de header en de footer omvat, verwijst de skiplink naar de inhoudskolom #content-wrapper. Heeft uw thema al een skiplink, dan voegt de module er geen toe.
Automatische contrastcorrectie (WCAG 1.4.3)
De motor berekent de relatieve luminantie van elke tekst en zijn werkelijke achtergrond, en maakt kleuren onder de vereiste verhouding stap voor stap donkerder of lichter: 4,5, of 3 voor grote tekst (24px, of 18,66px vet). Hij draait wanneer de browser inactief is.
Teksten op een afbeelding, een kleurverloop, een halfdoorzichtige achtergrond of in een slider worden overgeslagen: hun werkelijke achtergrond is niet te berekenen en een correctie zou ze minder leesbaar kunnen maken. Uitgeschakelde teksten worden ook overgeslagen.
Deze correctie wijzigt de tekstkleuren van uw thema. Schakel ze in, controleer het resultaat op uw belangrijkste pagina’s en behoud ze als het bevalt. Daarom staat ze standaard uit.
Inhoud die na de pagina wordt geladen
De correcties gelden ook voor inhoud die na het laden wordt ingevoegd: productlijsten van facetfilters, snelle weergave, venster bij toevoegen aan winkelwagen, oneindig scrollen. Hoog contrast en tekstgrootte worden daar op dezelfde manier toegepast.
EAA-toegankelijkheidsverklaring
Het publiceren van een toegankelijkheidsverklaring is een formele verplichting uit de richtlijn. Klik in de configuratie van de module op Verklaringspagina genereren: er wordt een CMS-pagina aangemaakt in elke taal van uw winkel (sjablonen FR, EN, ES, DE, IT, NL, PL en PT inbegrepen, Engels als terugval voor andere talen), met:
- de conformiteitsstatus ten opzichte van Richtlijn (EU) 2019/882 en de norm EN 301 549;
- de lijst van beschikbare toegankelijkheidsfuncties;
- het meldkanaal naar uw contactformulier, in de taal van de pagina;
- de beroepsmogelijkheden bij de bevoegde nationale autoriteit.
De link naar de verklaring verschijnt automatisch onderaan het widgetpaneel, alleen als de pagina bestaat en actief is. Klik na een update van de module of een naamswijziging van de winkel op Verklaringspagina bijwerken: een bevestiging waarschuwt dat handmatige wijzigingen worden vervangen, daarna wordt de pagina bijgewerkt zonder dat de URL verandert.
Statistieken en bewijs van zorgvuldigheid
De tabel op de configuratiepagina toont over de laatste 30 dagen en per type het aantal toegepaste correcties: alt-teksten, formulierlabels, externe links, iframetitels, ARIA-landmarks, skiplinks en contrastcorrecties. Bij een controle of klacht documenteren deze tellers de genomen technische maatregelen. De knop Statistieken wissen zet de tellers van de huidige winkel op nul.
In multistore worden de statistieken en de verklaring per winkelcontext beheerd.
Goede praktijken en grenzen
De module corrigeert de meest voorkomende technische gebreken, maar sommige WCAG-criteria zijn redactioneel van aard en blijven uw verantwoordelijkheid:
- logische koppenhiërarchie h1 tot h6 in uw CMS-inhoud en productpagina’s;
- redactionele kwaliteit van de alt-teksten van uw belangrijkste afbeeldingen;
- ondertiteling van uw video’s;
- duidelijkheid van de labels van uw knoppen en links.
Geen enkel automatisch hulpmiddel maakt een site „100% conform”. De module geeft u een stevige en gedocumenteerde technische basis; vul die aan met een redactionele controle van uw belangrijkste pagina’s.
Probleemoplossing
- De knop verschijnt niet: controleer of de widget is ingeschakeld, of minstens één optie is aangevinkt en of u niet op een pagina bent waar hij verborgen is (mobiel, winkelwagen, checkout), en leeg de PrestaShop-cache (Geavanceerde parameters > Prestaties).
- Een optie is verdwenen bij een bezoeker: ze is in de configuratie uitgevinkt, wat ook de opgeslagen voorkeur verwijdert.
- Voorkeuren blijven niet bewaard: de bezoeker surft waarschijnlijk in privémodus of zijn browser blokkeert
localStorage; de widget blijft bruikbaar, alleen het bewaren valt weg. - Een zone blijft donker in hoog contrast: een element wijzigt later zijn achtergrond via een script (bijvoorbeeld een vaste header die bij scrollen donker wordt). Schakel de modus uit en weer in, of meld het geval aan de support met de betreffende URL.
- Installatie of update mislukt: upload de nieuwste ZIP over de module, zonder te verwijderen. Versies vóór 1.2.1 konden mislukken met „Undefined array key DFACCESS_WIDGET_OPTIONS”.
- Er komen geen statistieken binnen: controleer of het verzamelen is ingeschakeld en of geen firewall requests naar de
track-controller van de module filtert. De tellers komen gebundeld binnen, mogelijk met enkele minuten vertraging.
Verwijderen
Bij het verwijderen worden de statistiektabel en de configuratiesleutels gewist. De CMS-pagina met de toegankelijkheidsverklaring blijft bewust behouden (ze blijft een wettelijke verplichting): verwijder ze handmatig via Weergave > Pagina’s als u ze niet wilt houden.