Libration Accessibility

Le manuel de l'extension d'accessibilité : de l'installation à la personnalisation du widget, jusqu'aux rapports d'audit, à la déclaration et aux outils IA. Tous les réglages se trouvent dans WordPress sous Réglages → Accessibilité.

Installation

Sélectionnez le ZIP de l'extension dans le back-end WordPress sous Extensions → Ajouter → Téléverser une extension et installez-le — ou déposez le dossier libration-accessibility dans /wp-content/plugins/.
Activez l'extension dans la liste des extensions. Vous y trouverez aussi directement le lien Réglages.
C'est tout — le widget d'accessibilité apparaît immédiatement en bas à droite de votre site. Toutes les corrections de base (liens d'évitement, indicateur de focus, landmarks ARIA) sont actives d'origine.

Les mises à jour arrivent directement via le système de mise à jour de WordPress — les versions Pro via le serveur de mise à jour Libration, la version gratuite via le répertoire d'extensions de wordpress.org.

Activer la licence Pro

Vous trouverez votre clé de licence dans l'e-mail de commande et dans l'espace client.

Ouvrez Réglages → Accessibilité → Licence.
Saisissez la clé (format LIB-XXXX-XXXX-XXXX) et cliquez sur Activer.
Le tarif (Pro, Pro AI ou Agency) s'affiche et toutes les fonctions incluses se déverrouillent — une seule clé pour tout, y compris les fonctions IA.

Les licences Agency peuvent être activées sur jusqu'à 25 sites ; l'onglet Licence et l'espace client affichent la liste des sites utilisés. Avec « Détacher la licence de ce site », vous libérez une place — pratique lors de la migration de projets clients.

Le widget propose aux visiteurs dix modes d'affichage et quatre curseurs — tous les réglages sont conservés 30 jours dans le navigateur du visiteur (sans tracking, sans transmission au serveur) :

Modes d'affichage	Inversion des couleurs · Monochrome · Contraste sombre · Contraste clair · Saturation réduite · Saturation élevée · Mise en évidence des liens · Mise en évidence des titres · Lecteur d'écran (lecture au clic/à la sélection) · Mode lecture
Curseurs	Échelle du contenu · Taille de police · Hauteur de ligne · Espacement des caractères (80–200 % chacun)
Langues	L'interface suit la langue du site — 28 langues européennes sont incluses

Dans l'onglet Widget, vous pouvez désactiver des groupes de fonctions individuellement (p. ex. niveaux de gris, modes de contraste, curseurs de police, soulignement des liens) si vous souhaitez un panneau plus épuré.

Tout se trouve dans l'onglet Widget → Bouton flottant :

Position	Quatre coins : en bas à droite (par défaut), en bas à gauche, en haut à droite, en haut à gauche
Marge au bord	8–80 px de distance par rapport au bord de la page
Taille	S (48 px) · M (56 px) · L (64 px)
Icône	Personne (par défaut) · Personne en fauteuil roulant · Curseurs — ou une image personnalisée issue de la médiathèque (PNG/SVG, format carré recommandé)

Vous pouvez aussi désactiver complètement le bouton et placer le panneau vous-même — voir Intégration.

Couleur d'accent	Colore le bouton, les tuiles actives et les curseurs. Via le sélecteur de couleur (palette, HEX, RGB) — ou comme variable CSS, voir ci-dessous.
Arrondi du panneau	Rayon des angles du panneau, 4–40 px
Thème du panneau	Clair (blanc) · Sombre (anthracite) · Variables personnalisées (couplage au design)
Branding	Lien « powered by Libration » au pied du panneau — désactivable à partir de Pro, marque blanche à partir d'Agency

Couplage au design via variables CSS

Pour les développeurs : au lieu de couleurs fixes, vous pouvez coupler le widget aux propriétés personnalisées CSS de votre thème. Il suit alors automatiquement chaque changement de design — mode sombre inclus.

Couleur d'accent

Dans le champ Couleur d'accent, saisissez simplement la variable au lieu d'une valeur hexadécimale :

var(--primary)   ou en abrégé :   --primary

Arrière-plan du panneau et couleur du texte

Réglez le thème du panneau sur Variables personnalisées et saisissez les noms des variables définies par votre thème, p. ex. :

:root { --site-bg: #ffffff; --site-text: #1d1d1f; }
@media (prefers-color-scheme: dark) {
  :root { --site-bg: #1c1b22; --site-text: #f4f4f5; }
}

Le widget reprend background: var(--site-bg) et color: var(--site-text) et en dérive automatiquement toutes les couleurs secondaires (fonds des tuiles, séparateurs, bordures) via color-mix(). Si le site passe en mode sombre via une media query ou une classe, le widget suit sans configuration supplémentaire.

Des valeurs de repli sont intégrées : si une variable n'est pas définie sur la page, le widget utilise blanc/anthracite.

Bloc Gutenberg

Recherchez « Panneau d'accessibilité » dans l'éditeur de blocs (catégorie Widgets). Le bloc affiche le même panneau que le bouton flottant — idéal pour le footer, les pop-ups ou une page « Accessibilité » dédiée. Dans la barre latérale du bloc, vous réglez le titre, l'affichage du titre et le bouton de réinitialisation.

Shortcode

Le panneau à n'importe quel endroit — y compris dans les fichiers du thème via do_shortcode() :

[libration_accessibility]

[libration_accessibility title="Aide à la navigation" show_title="1" show_reset="0"]

Attribut	Valeurs	Signification
`title`	Texte	Titre du panneau (par défaut : « Options d'accessibilité »)
`show_title`	`1` / `0`	Afficher le titre
`show_reset`	`1` / `0`	Afficher le bouton de réinitialisation

Elementor

Si Elementor est actif, le widget « Libration Accessibility – Options d'accessibilité » apparaît automatiquement dans le panneau Elementor (catégorie Général, mots-clés « accessibility », « accessibilité »). Placez-le par glisser-déposer ; le titre, l'affichage du titre et le bouton de réinitialisation se règlent directement dans les options du widget.

WPBakery

Si WPBakery (Visual Composer) est actif, vous trouverez l'élément « Libration Accessibility – Options d'accessibilité » dans le catalogue d'éléments sous Contenu — avec les trois mêmes options que le bloc et le shortcode.

Divi

Lorsque Divi est actif, le module « Libration Accessibility – outils d’accessibilité » apparaît dans le Divi Builder — avec les trois mêmes options que le bloc et le shortcode. Divi 5 exécute toujours ce module via sa compatibilité Divi 4.

Déclaration d'accessibilité Pro

L'onglet Déclaration génère une déclaration d'accessibilité conforme au BFSG (la loi allemande sur l'accessibilité) et à l'EAA, sous forme de page WordPress :

Renseignez l'organisation, l'e-mail de contact et, si vous le souhaitez, un numéro de téléphone.
Choisissez le statut de conformité — partiellement conforme est l'état habituel et honnête.
Complétez les limitations connues (p. ex. « Les anciens documents PDF ne sont pas encore accessibles »).
Choisissez la langue — les 28 langues de l'extension sont disponibles (l'allemand et l'anglais sont maintenus par la rédaction, d'autres suivront).
Créer la page — la déclaration est publiée comme page ; en cas de modification, enregistrez simplement à nouveau et la page est mise à jour.

Ajoutez un lien vers la déclaration dans le footer de votre site — c'est ce qu'attendent les utilisateurs et la surveillance du marché. La déclaration ne remplace pas un conseil juridique.

Sous-titres & transcriptions

L’onglet Médias liste chaque fichier vidéo et audio de la médiathèque et indique lesquels disposent de sous-titres vérifiés. Un traitement produit une piste de sous-titres (WebVTT) à partir de la bande son, et si vous le souhaitez une transcription et des traductions.

Minutes média

La facturation se fait en minutes média : une minute commencée de durée par passage. Une vidéo de dix minutes avec transcription et deux traductions consomme donc trois fois dix minutes. Les corrections dans l’éditeur sont gratuites. Sans licence, chaque site dispose d’un essai unique.

L’éditeur

« Ouvrir dans l’éditeur » place les sous-titres à côté du son. Un clic sur une carte saute à l’endroit correspondant. L’éditeur contrôle les règles qui rendent les sous-titres lisibles : deux lignes de 37 caractères au maximum, une durée d’affichage comprise entre une et six secondes, quinze caractères par seconde au plus. Les écarts s’affichent comme remarque — ils ne bloquent rien, mais ils sont presque toujours fondés.

Trois raccourcis sont intégrés : Locuteur ajoute un nom, [bruit] signale un son pertinent, Décaler les temps corrige un décalage sur tout le fichier.

La validation — l’essentiel

Des sous-titres automatiques ne satisfont pas au critère WCAG 1.2.2 : les noms propres ne sont pas toujours corrects, les locuteurs ne sont pas nommés, les bruits pertinents manquent. Un média ne compte donc comme couvert qu’après votre validation — dans la vue d’ensemble comme dans le texte de la déclaration d’accessibilité. Cette validation est une affirmation, pas une formalité : vous confirmez avoir lu et corrigé les sous-titres.

Vidéos tierces intégrées

YouTube et Vimeo ne peuvent pas être sous-titrés de l’extérieur. Traitez ici le fichier d’origine, téléchargez le fichier SRT depuis l’éditeur après validation et importez-le sur la plateforme.

Réglages

La piste validée peut être rattachée automatiquement à la vidéo lors de la diffusion — y compris pour les vidéos issues d’un constructeur de pages. Une transcription dépliable sous le média satisfait au critère 1.2.1 pour l’audio seul et sert aussi la recherche. Le champ Vocabulaire de ce site accueille noms propres, produits et termes techniques, un par ligne : ce contexte améliore la qualité plus que n’importe quel modèle plus grand.

Documents PDF

Les PDF publiés sur un site relèvent du BFSG via la norme EN 301 549, chapitre 10. Une version HTML accessible ne remplace expressément pas un PDF inaccessible. L’onglet Documents recense donc tous les PDF de la médiathèque, les contrôle et peut les traiter.

Le contrôle est gratuit

Le contrôle s’effectue selon PDF/UA-1 et examine les balises, l’ordre de lecture, les métadonnées, les textes alternatifs, les en-têtes de tableau et les pages numérisées. Il ne consomme aucun crédit : vous pouvez contrôler chaque document autant de fois que vous le souhaitez, même sans licence. Le résultat est un score de 0 à 100 et une liste des constats par gravité.

Traitement et essai

Le traitement coûte une unité par page traitée. Il génère les balises et la structure, définit le titre et la langue du document, marque les éléments décoratifs comme artefacts, propose des textes alternatifs pour les illustrations et pose les en-têtes de tableau lorsqu’ils sont identifiables. L’essai traite au plus la moitié des pages, ne consomme pas de crédit et fournit un fichier d’essai — il ne modifie pas le document lui-même.

Le feu tricolore

Trois états, et c’est celui du milieu qui compte le plus : non contrôlé, traité automatiquement, non vérifié, vérifié et validé. Une machine ne peut pas juger si l’ordre de lecture est correct sur le fond, si un texte alternatif dit ce qu’il faut ou si un tableau complexe reste compréhensible. Un document traité reste donc « traité automatiquement, non vérifié » jusqu’à ce que quelqu’un l’ait relu et validé. Seuls les documents validés comptent dans les indicateurs et dans le texte de la déclaration.

Remplacer l’original ou le doubler

Par défaut, le traitement crée un nouveau fichier suffixé -accessible à côté de l’original ; les liens existants continuent de fonctionner. « Remplacer » échange le fichier d’origine et conserve l’ancienne version en .bak. Attention : cela met fin à l’antériorité.

Antériorité

Selon le § 1 al. 4 du BFSG, les documents publiés avant le 28 juin 2025 sont exemptés des exigences — tant qu’ils restent inchangés. Ces fichiers sont signalés dans la liste. Remplacer ou réimporter l’un d’eux fait perdre l’exemption. Ceci est une indication, pas un conseil juridique.

Texte pour la déclaration

En bas de l’onglet figure un paragraphe chiffré sur l’état des documents PDF — en allemand ou en anglais, prêt à copier. Le générateur de déclaration d’accessibilité peut le reprendre.

Rapport d'audit & PDF

L'onglet Rapport d'audit regroupe trois outils :

Vue d'ensemble — statistiques sur les images sans texte alternatif, progression de la liste de contrôle et statut global. C'est aussi ici que vous lancez le rapport d'audit PDF Pro : une documentation justificative optimisée pour l'impression (synthèse, mesures actives, liste de contrôle complète, liste des images), que vous enregistrez en PDF via la boîte de dialogue d'impression.
Analyse des images — liste détaillée de toutes les images sans texte alternatif, avec aperçu, emplacements et lien direct vers l'édition. La version gratuite affiche les 50 premières images ; Pro vérifie sans limite et exporte en CSV.
Liste de contrôle BFSG — 27 critères selon les WCAG 2.1 AA en cinq catégories, avec barre de progression et enregistrement. L'auto-évaluation est intégrée au rapport PDF.

Fonctions IA Pro AI

Les fonctions IA s'exécutent sur les serveurs Libration en Allemagne et sont activées via votre licence. Vous trouverez les quotas par tarif sous Tarifs.

Textes alternatifs automatiques

Au téléversement : interrupteur « Textes alternatifs automatiques au téléversement » — les nouvelles images sont décrites de manière asynchrone.
Rattraper l'existant : « Vérifier la médiathèque » compte les images sans texte alternatif, « Générer maintenant » les traite avec une barre de progression. Les textes alternatifs existants restent intacts.
Langue : suit la langue du site, modifiable dans l'onglet IA.

FALC & lecture à voix haute par IA

Le FALC (facile à lire et à comprendre) et la lecture à voix haute par IA font partie du tarif Pro AI et sont activés automatiquement via votre licence dès qu'ils sont disponibles pour votre compte — vous voyez leur statut dans l'onglet IA.

Options back-end

Widget du tableau de bord	Vue d'ensemble du statut sur le tableau de bord WP — désactivable sous Général → Intégration back-end
Barre d'administration	Accès rapide « Accessibilité » dans la barre supérieure — également désactivable
Visualiseur de tabulation	Affiche aux admins l'ordre de tabulation avec des numéros directement dans le front-end (onglet Ordre de tabulation)
Notifications e-mail	Notification optionnelle lorsqu'une image sans texte alternatif est téléversée

Aperçu des tarifs

	Free	Pro	Pro AI	Agency
Widget + corrections de base + liste de contrôle	✓	✓	✓	✓
Vérification des textes alternatifs	50 images	illimitée + CSV	illimitée + CSV	illimitée + CSV
Déclaration d'accessibilité + rapport PDF	—	✓	✓	✓
IA : textes alternatifs / FALC / lecture à voix haute	—	—	✓	✓ (mutualisé)
Sites web	∞	1	1	jusqu'à 25
Branding désactivable / marque blanche	—	✓ / —	✓ / —	✓ / ✓

Tarifs et commande : libration.io/#pricing · Gestion : espace client

Dépannage

Les obstacles les plus fréquents et leurs solutions — la plupart des problèmes se règlent en quelques minutes.

Le widget n'apparaît pas dans le front-end

Vérifiez d'abord que l'extension est bien activée dans la liste des extensions et que le bouton flottant est activé dans l'onglet Widget. Ensuite, la cause la plus fréquente est une extension de cache ou d'optimisation : videz le cache (p. ex. WP Rocket, LiteSpeed Cache, Cloudflare) et rechargez la page dans une fenêtre de navigation privée. Si le widget reste absent, excluez les fichiers de Libration Access de l'optimisation — la marche à suivre est détaillée sous Extensions de cache et d'optimisation. Vérifiez également si des règles d'exclusion (certaines pages ou certains types de contenu) s'appliquent.

La clé de licence n'est pas acceptée

La clé a le format LIB-XXXX-XXXX-XXXX — attention aux espaces en début ou en fin lors de la copie depuis l'e-mail de commande. Si la limite de sites de votre tarif est atteinte, le serveur refuse l'activation : ouvrez l'espace client et libérez une place avec « Détacher la licence de ce site ». Si l'activation échoue avec une erreur de connexion, votre serveur ne parvient pas à joindre libration.io — demandez à votre hébergeur d'autoriser les connexions HTTPS sortantes vers libration.io (pare-feu, fichier hosts).

Les fonctions IA ne renvoient aucun résultat

Cause la plus fréquente : le quota mensuel est épuisé — l'onglet IA affiche votre consommation et vous recevez un e-mail d'avertissement à 80 % et à 100 %. Vous pouvez acheter du quota supplémentaire dans l'espace client. Vérifiez aussi que votre tarif inclut bien l'IA (Pro AI ou Agency — voir Tarifs). Si les requêtes restent totalement sans réponse, votre serveur bloque peut-être les connexions HTTPS sortantes vers le proxy Libration — en cas de doute, demandez à votre hébergeur.

La lecture à voix haute utilise la voix système au lieu de la voix IA

La voix IA nécessite une licence Pro AI (ou Agency) active et du quota disponible — s'il manque l'un des deux, le widget revient automatiquement à la voix système du navigateur. Vérifiez la licence et la consommation dans l'onglet IA. La première lecture d'une page prend en outre un court instant : l'audio est généré sur le serveur puis mis en cache — à partir de la deuxième lecture, il démarre immédiatement.

Le widget ne s'accorde pas visuellement avec le thème

La position, la taille, la couleur d'accent et le thème du panneau se règlent sous Réglages → Accessibilité → Widget. Si vous souhaitez que le widget suive automatiquement les couleurs de votre thème — mode sombre inclus —, couplez-le à votre design via les variables CSS : voir Couplage au design. Il reste ainsi cohérent même après un changement de thème, sans retouche manuelle des couleurs.

Extensions de cache et d'optimisation : bien exclure Libration Accessibility

Si le widget manque, si le panneau s'ouvre sans style ou si le bouton ne réagit pas, une extension d'optimisation en est presque toujours la cause : elle regroupe le JavaScript, le minifie ou en retarde l'exécution (« Delay JavaScript », « Defer »). La solution est toujours la même — exclure Libration Access de l'optimisation. Seule l'écriture diffère : certaines extensions se contentent du mot-clé libration-accessibility, d'autres exigent le chemin complet de chaque fichier JavaScript.

Voici les fichiers concernés — tous se trouvent dans le dossier de l'extension :

/wp-content/plugins/libration-accessibility/assets/frontend.js
/wp-content/plugins/libration-accessibility/assets/frontend.css
/wp-content/plugins/libration-accessibility/assets/libration-tts.js
/wp-content/plugins/libration-accessibility/assets/libration-easy-lang.js

libration-tts.js et libration-easy-lang.js ne sont chargés que si la lecture vocale IA ou le langage simplifié est actif. Si votre extension demande des handles WordPress plutôt que des chemins (une liste de sélection au lieu d'un champ de texte), il s'agit de libration-frontend, libration-tts et libration-easy-lang.

Important : frontend.js dépend de deux éléments que WordPress place juste avant — jQuery et un petit bloc de configuration (libration_ajax). Si un optimiseur déplace le script du widget mais laisse la configuration en place (ou renvoie jQuery en fin de page), le widget se casse. Excluez donc toujours jQuery également lorsque vous excluez Libration Access du « delay » ou du « defer ».

Où saisir l'exclusion selon l'extension (les libellés changent légèrement d'une version à l'autre, l'emplacement reste le même) :

WP Rocket	Optimisation des fichiers → « Fichiers JavaScript exclus », ainsi que « Retarder l'exécution du JavaScript → Fichiers exclus ». Saisie : `libration-accessibility` (un motif par ligne) et `jquery`.
LiteSpeed Cache	Optimisation des pages → Réglages JS → « JS Excludes » et « JS Deferred Excludes ». Saisie : `libration-accessibility`.
Autoptimize	JS, CSS & More → « Exclure des scripts d'Autoptimize » — une liste séparée par des virgules. À ajouter : `libration-accessibility/assets/`.
W3 Total Cache	Minify → « Never minify the following JS files ». Le mot-clé ne suffit pas ici — indiquez le chemin sans le domaine : `wp-content/plugins/accessibility/assets/frontend.js` (une ligne par fichier).
SiteGround Optimizer	Frontend → JavaScript → « Exclure des fichiers JS du regroupement/report ». La sélection se fait par handle : `libration-frontend`, `libration-tts`, `libration-easy-lang`.
Perfmatters	Assets → JavaScript → exclusions de « Delay JavaScript » ou Script Manager. Saisie : `libration-accessibility`.
Jetpack Boost / NitroPack	Liste d'exclusion de l'optimisation JavaScript. Saisie : `libration-accessibility`.
Cloudflare Rocket Loader	Ne propose aucune liste d'exclusion. Si le widget ne pose problème qu'avec Rocket Loader activé, désactivez-le ou excluez les pages concernées par une règle.

Méthode éprouvée si vous ignorez quel réglage est en cause : désactivez complètement « regrouper le JavaScript » et « retarder l'exécution du JavaScript », videz le cache et vérifiez la page en navigation privée. Si le widget fonctionne alors, réactivez les options une par une — avec les exclusions ci-dessus. Deux ou trois passages suffisent à identifier l'option responsable sans renoncer à l'optimisation de tout votre site.

Cette exception ne vous coûte pratiquement rien : les ressources de Libration Access sont déjà minifiées et regroupées — une minification supplémentaire n'économise que quelques kilo-octets.

Le scan externe signale « quota atteint » ou une erreur

Le scan a des limites mensuelles par tarif : Free 2, Pro 20, Agency 100 scans — le compteur se réinitialise au changement de mois. Le scanner ne peut en outre analyser que des pages accessibles publiquement : le mode maintenance, une protection par mot de passe basic-auth ou un environnement de développement local empêchent l'accès et provoquent une erreur. Désactivez brièvement la protection ou scannez le site en production.

Une mise à jour disponible ne s'affiche pas

WordPress ne vérifie les mises à jour qu'environ toutes les douze heures. Lancez la vérification manuellement : Tableau de bord → Mises à jour → « Vérifier à nouveau » — cela vide le transient de mise à jour. Si la mise à jour Pro n'apparaît toujours pas, jetez un œil à votre licence : si elle a expiré, le serveur de mise à jour ne livre plus que les mises à jour de la version gratuite ; après le renouvellement dans l'espace client, les mises à jour Pro sont de nouveau disponibles immédiatement.

Votre problème n'est pas dans la liste ? Contactez-nous — tous les détails sous Support. Vous gérez votre licence, vos factures et vos quotas dans l'espace client.

Support

Une question, un bug, une suggestion ? Écrivez à support@libration.io — les clients Pro reçoivent une réponse prioritaire. Il est utile d'indiquer vos versions de WordPress et de l'extension (voir la liste des extensions) ainsi qu'une brève description de ce que vous attendiez et de ce que vous avez constaté à la place.