Comment auditer sa boutique PrestaShop pour la conformité WCAG 2.1 AA

Depuis le 28 juin 2025, l'European Accessibility Act (EAA) exige des boutiques en ligne qui vendent aux consommateurs de l'Union européenne d'être utilisables par les personnes handicapées. Un marchand PrestaShop doit donc savoir quelles pages posent problème, quoi corriger et ce qu'il doit publier pour viser la conformité WCAG 2.1 AA. Le module EAA Accessibility Checker organise cet audit d'accessibilité dans le back-office, de l'analyse à la déclaration, et montre aussi ce qu'aucun outil ne peut faire seul.

Mon site e-commerce est-il obligé d'être accessible ?

Oui, si vous vendez à des consommateurs de l'Union européenne : l'EAA s'applique depuis le 28 juin 2025 aux services de commerce en ligne.

La directive (UE) 2019/882 fixe l'objectif, et la norme EN 301 549 reprend les critères WCAG 2.1 niveau AA comme référence technique. La loi nationale précise l'autorité de contrôle et les recours. Le module préremplit le texte national et l'autorité de contrôle pour la France, la Belgique, l'Espagne, l'Italie, la Pologne et l'Allemagne ; les autres pays partent du modèle européen.

Les microentreprises qui fournissent des services sont exemptées par le texte européen. Cette exemption ne dispense pas de vérifier vos autres obligations, notamment celles qui viennent de votre pays ou de vos clients publics. Le module aide à mesurer et à documenter ; il ne remplace pas un conseil juridique.

PrestaShop est-il conforme WCAG 2.1 AA sans module ?

Non. Le cœur de PrestaShop ne garantit pas le niveau AA : le thème, les modules et vos contenus décident d'une grande partie du résultat.

Un thème peut produire des contrastes trop faibles, des boutons sans nom lisible ou un focus invisible. Vos fiches produits peuvent contenir des images sans texte alternatif. Le tunnel de commande ajoute ses propres champs et messages d'erreur. Aucun de ces points ne se règle par une case à cocher dans les réglages de la boutique.

Le module sert aux marchands qui vendent en Europe et veulent une trace de leur démarche. Il sert aussi aux agences qui doivent documenter plusieurs boutiques. Il est moins utile à une microentreprise de services réellement exemptée, ou à un marchand qui attend d'un outil qu'il rende la boutique conforme sans toucher au thème ni aux contenus : ce n'est pas ce que fait un scanner.

Comment auditer ma boutique pour la conformité WCAG 2.1 AA, étape par étape ?

Installez le module, activez la licence, puis lancez une analyse dans votre navigateur depuis l'écran « 1. Analyser ».

Voici le parcours dans le back-office :

1. Ouvrez Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez l'archive ZIP.
2. Cliquez sur Configurer, saisissez la Clé de licence et le Secret de licence de votre compte client, puis cliquez sur Activer la licence.
3. Ouvrez le module par le bouton Ouvrir le module d'accessibilité ou par le menu WePresta > Accessibilité (EAA).
4. Dans 1. Analyser, gardez le mode Dans votre navigateur (recommandé) et les pages proposées cochées, puis cliquez sur Lancer l'analyse. Gardez la page ouverte : une quinzaine de pages prennent environ une minute.
5. Dans 2. Corriger, filtrez par gravité et commencez par les problèmes graves présents sur beaucoup de pages.
6. Dans Réglages, activez les corrections utiles, puis relancez une analyse pour mesurer leur effet.
7. Avancez dans 3. Vérifier, puis préparez la déclaration dans 4. Publier.

L'analyse dans le navigateur ouvre chaque page de façon invisible et la contrôle avec axe-core, tel que vos visiteurs la voient. Elle mesure les contrastes, les attributs ARIA, les contenus ajoutés par les scripts et l'effet des corrections. L'analyse par le serveur lit le HTML et sert aux analyses programmées ; elle ne mesure pas les contrastes.

Un scanner automatique suffit-il pour être conforme ?

Non. Un scan trouve des défauts techniques, mais il ne juge ni la pertinence d'un texte alternatif ni la clarté d'un message d'erreur.

L'analyse automatique repère les images sans attribut, les champs sans étiquette, les titres mal hiérarchisés ou les contrastes insuffisants. Elle ne peut pas décider si un texte alternatif décrit vraiment l'image, si une vidéo a des sous-titres, si l'ordre de lecture a du sens ou si un message d'erreur aide le client à corriger sa saisie. Ces critères demandent un regard humain.

La checklist du module couvre les 50 critères WCAG 2.1 A et AA et, en option, les 6 critères WCAG 2.2. Pour chacun, vous lisez ce qu'il demande, ce que l'analyse en contrôle, puis vous donnez votre verdict : respecté, non respecté ou non applicable. Une note garde la trace de ce que vous avez vérifié, avec l'auteur et la date. Un critère n'est compté comme respecté qu'après votre vérification et sans problème ouvert.

Le rythme compte autant que la première analyse. Dans Réglages, activez Analyser la boutique automatiquement, choisissez la fréquence, le jour et l'heure, puis les destinataires du rapport. La tâche cron de l'hébergeur ou l'adresse à secret lance l'analyse ; le rapport indique les problèmes ouverts, nouveaux et résolus depuis l'analyse précédente. L'écran Rapport produit une version imprimable et des exports CSV.

Comment corriger sans casser mon thème et valider la navigation au clavier ?

Activez les corrections une par une, puis vérifiez la navigation au clavier sur l'accueil, une fiche produit, le panier et la commande.

Six corrections sont proposées dans Réglages. Le lien d'évitement « Aller au contenu principal » n'est ajouté que si votre thème n'en a pas. Les boutons et liens réduits à une icône reçoivent un nom lisible. Les icônes décoratives sont masquées aux lecteurs d'écran quand la commande a déjà un nom. Les champs qui n'ont qu'un texte indicatif reçoivent une étiquette. La saisie automatique est déclarée sur les formulaires de compte et d'adresse. Le focus visible ajoute un anneau net autour de l'élément atteint au clavier.

Chaque correction ajoute une information manquante et ne retire jamais ce que votre thème déclare. Le bouton Activer les corrections recommandées active les cinq premières ; le focus visible s'active à part, car il change l'apparence du focus. L'analyse suivante dans le navigateur mesure leur effet.

Pour les images, ouvrez Légendes des images. L'écran affiche le taux d'images légendées par langue, puis les images page par page, avec des filtres par langue, par état et par produit. Le bouton Utiliser le nom du produit pour les légendes vides de cette page donne une première légende ; chaque saisie est enregistrée aussitôt. Réécrivez ensuite les légendes utiles pour décrire ce que montre l'image, plutôt que de répéter le nom du produit.

Le clavier reste le test le plus rapide du tunnel. Sur la page de commande, vérifiez que chaque champ a une étiquette, que les messages d'erreur sont annoncés et que le focus reste visible. Ces points figurent dans la checklist et dans les problèmes relevés par l'analyse.

Que doit contenir une déclaration d'accessibilité ?

Elle doit indiquer l'état de conformité, les contenus non accessibles et leurs alternatives, et la façon de vous joindre.

L'écran 4. Publier prépare ce document sur le modèle européen. Vous choisissez le pays de référence, l'état de conformité (totalement, partiellement ou non conforme), le contact et le délai de réponse. Le bouton Insérer les critères non respectés reprend votre checklist pour remplir les contenus non accessibles. Les textes se rédigent dans chaque langue de la boutique.

Activez l'option Publier la déclaration sur la boutique pour mettre la page en ligne à une adresse lisible dans chaque langue. Le lien en pied de page s'active séparément. Tant que la déclaration n'est pas publiée, son adresse répond « page introuvable » et vous pouvez la prévisualiser dans le back-office.

Une licence valide conditionne tout cela. Depuis la version 2.0.1, sans licence valide, le module se désactive entièrement : la déclaration répond « page introuvable », son lien en pied de page disparaît, les corrections automatiques s'arrêtent et les analyses programmées ne tournent plus. Vos analyses, décisions, checklist, textes de déclaration, légendes, réglages et secrets sont conservés. La page de configuration reste accessible avec le formulaire de licence ; après le renouvellement, ouvrez-la : le module se réactive et une déclaration publiée revient à la même adresse.

Un incident passager du serveur de licence ne coupe pas une licence payée : le module accorde 7 jours de tolérance à compter de la première erreur, et un abonnement renouvelé est reconnu au contrôle suivant. La date d'échéance est revérifiée au plus une fois par heure, seulement lorsqu'elle a plus de 7 jours. Le gestionnaire de modules refuse d'activer le module sans licence valide.

Pour aller plus loin, la documentation du module détaille chaque écran et chaque réglage, et la fiche du module résume les fonctions et les prérequis. Si votre boutique vend aussi des produits soumis à d'autres obligations européennes, regardez l'Anti-greenwashing EmpCo, le passeport digital du produit et l'audit de sécurité : ils documentent d'autres volets de la même exigence de transparence.