DokAudit pour Drupal
Des PDF accessibles directement dans Drupal. Les médias, champs de fichier et liens restent tels quels.
Le module DokAudit contrôle les PDF de votre médiathèque Drupal selon PDF/UA-1, WCAG 2.2 et BITV 2.0 (ordonnance fédérale allemande sur l’accessibilité numérique, fondée sur la norme EN 301 549) et les remplace par la version corrigée. L’identifiant de fichier (fid) et l’URI restent identiques. Les médias, champs de fichier et liens dans les textes continuent de fonctionner.
- Drupal 10.3 et 11
- Original sauvegardé, restauration en un clic
- Licence GPL-2.0-or-later
- 20 crédits d’essai = 100 pages
Essai gratuit · Voir la démo en ligne · Prendre rendez-vous
Ce que fait le module
Le module relie votre site Drupal à DokAudit. Il repère les PDF de la médiathèque, les transmet pour contrôle et correction, puis les remplace.
- Contrôle selon PDF/UA-1, WCAG 2.2 et BITV 2.0: DokAudit contrôle chaque PDF, le répare puis le contrôle à nouveau. Dans la vue d’ensemble, vous voyez le score avant et après, les labels obtenus (PDF/UA-1, WCAG 2.2, PDF/A-2a) et le lien vers le rapport de contrôle dans le hub DokAudit.
- Remplacement sur place: La version corrigée remplace le fichier sans créer de nouvelle entité de fichier. Le fid et l’URI restent identiques. Vous n’avez pas à toucher aux médias, aux champs de fichier ni aux liens dans les textes.
- Original sauvegardé: Avant le remplacement, le module dépose l’original sous public://_dokaudit_backup/. « Restaurer l’original » le remet en place en un clic.
- Remplacement uniquement en cas d’amélioration: Le fichier n’est remplacé que si le score augmente au moins du gain minimal paramétré (par défaut : 1 point). Sinon, l’original reste en ligne.
- Nouveaux PDF mis en file automatiquement: Les PDF nouvellement importés ou remplacés sont pris en compte lors de la synchronisation suivante. Si un fichier est réimporté pendant son traitement, le module écarte le résultat et contrôle la nouvelle version.
- Mode « contrôle seul »: En mode « contrôle seul », le module ne remplace rien. Vous voyez d’abord où en sont vos PDF et activez le remplacement plus tard.
Paramètres sous Configuration → Média → DokAudit
L’en-tête affiche d’un coup d’œil l’organisation, le solde de crédits et la clé. Une nouvelle clé est vérifiée à l’enregistrement et l’organisation correspondante s’affiche.
Sans saisie dans les paramètres, c’est la variable d’environnement DOKAUDIT_API_KEY qui s’applique. Une clé enregistrée est prioritaire. Vous définissez en outre :
- Mode : contrôler et remplacer, ou contrôle seul
- Dossiers : ne prendre en compte que certains dossiers, par exemple formulare/ et satzungen/, ou exclure des dossiers
- Gain minimal : ne remplacer qu’à partir de cette amélioration (par défaut 1)
- Imports par exécution du cron : 10 par défaut ; la synchronisation par cron peut être désactivée
- Dossier de sauvegarde et une taille maximale pour les gros PDF (50 Mo par défaut)
La vue d’ensemble sous Contenu → DokAudit
La vue d’ensemble à l’adresse /admin/content/dokaudit est accessible à tous les comptes disposant du droit « Administrer DokAudit » (DokAudit verwalten). Elle récupère les résultats terminés dès son ouverture. Son interface est pour l’instant en allemand.
- Vue d’ensemble: Connexion et solde de crédits, indicateurs clés et liste de tous les PDF enregistrés avec le score avant et après.
- Actions: « Synchroniser maintenant » (Jetzt abgleichen) pour tous les fichiers, « Restaurer l’original » (Original wiederherstellen) et « Contrôler à nouveau » (Erneut prüfen) pour chaque fichier.
- Labels et rapport de contrôle: Pour chaque document, les labels obtenus et un lien vers le rapport de contrôle dans le hub DokAudit, comme preuve pour votre dossier.
- Avertissements: La vue d’ensemble signale les PDF qui n’ont pas encore été contrôlés ainsi qu’un solde de crédits faible.
- Avis de mise à jour: Lorsqu’une version plus récente du module est disponible, l’avis apparaît dans la vue d’ensemble et dans le rapport d’état de Drupal.
- Drush: drush dokaudit:sync synchronise les fichiers et drush dokaudit:restore suivi de l’ID du fichier restaure un original.
Configuration en trois étapes
Une fois le module installé, la configuration prend quelques minutes.
- Créer une clé API: Dans le hub DokAudit, sous Intégrations → Clés API, créez une clé avec droit d’écriture. La clé appartient à votre organisation : les documents apparaissent dans son hub et sont décomptés de son solde de crédits.
- Saisir la clé dans Drupal: Sous Configuration → Média → DokAudit, saisissez l’adresse de l’API et la clé, puis enregistrez.
- Le cron fait le reste: La synchronisation s’exécute à chaque passage du cron. Vous pouvez aussi la lancer à tout moment avec « Synchroniser maintenant » ou via Drush.
Installation et prérequis
Méthode standard – téléchargement du ZIP : téléchargez la version actuelle au format ZIP, décompressez-la dans web/modules/custom/ (dossier dokaudit) et activez le module, par exemple avec drush en dokaudit -y. L’activation du module crée la table dokaudit_file.
Variante avec Composer : décompressez le ZIP dans un dossier de votre projet en dehors de web/modules/custom/ et déclarez-le comme dépôt de type path : composer config repositories.dokaudit '{"type":"path","url":"chemin/vers/dokaudit"}', puis composer require dokaudit/drupal-dokaudit:@dev et drush en dokaudit -y.
Mises à jour : remplacez le dossier, puis exécutez drush updatedb. Le module signale lui-même la disponibilité d’une nouvelle version.
- Drupal 10.3 ou 11
- PHP 8.1 ou supérieur
- Drush 12 ou 13 pour les commandes console
- Un compte DokAudit avec une clé API
DokAudit pour TYPO3 · API REST et autres intégrations
Coûts, licence et protection des données
- Facturation sur vos crédits: Le module lui-même est gratuit. DokAudit facture le contrôle et la correction comme dans le hub : 1 crédit par tranche de 5 pages entamée, dès 0,50 € HT la page avec la formule Secteur public, IA comprise. Voir les tarifs
- Licence GPL: Le module est publié sous licence GPL-2.0-or-later. Vous pouvez consulter et adapter le code source.
- Protection des données: Seuls les fichiers PDF sont transmis, chiffrés via HTTPS. Le traitement a lieu dans un centre de données certifié ISO/IEC 27001 en Allemagne, conformément à l’accord de sous-traitance (RGPD) de votre organisation.
- Votre propre instance: L’adresse de l’API est paramétrable. Si vous exploitez DokAudit dans votre propre centre de données, reliez le module à votre instance.
Questions fréquentes
- Que deviennent les liens vers les PDF ?
- Rien ne change. L’identifiant de fichier (fid) et l’URI restent identiques ; seul le contenu du fichier est remplacé. Les médias, champs de fichier et liens dans les textes pointent toujours vers le même fichier.
- Et si la version corrigée est moins bonne que l’original ?
- Dans ce cas, rien n’est remplacé. Le module ne remplace un fichier que si le score augmente au moins du gain minimal paramétré. Une fois un fichier remplacé, l’original se trouve dans le dossier de sauvegarde et peut être restauré en un clic.
- Des fichiers sont-ils transmis à des tiers ?
- Le module transmet uniquement les fichiers PDF eux-mêmes, chiffrés via HTTPS, à DokAudit. Ils sont traités dans un centre de données certifié ISO/IEC 27001 en Allemagne, conformément à l’accord de sous-traitance de votre organisation. Pour les tâches d’IA, DokAudit fait appel à un prestataire cité comme sous-traitant ultérieur dans l’accord de sous-traitance (en allemand). L’IA peut être limitée à des prestataires situés dans l’UE ou désactivée.
- Le module fonctionne-t-il avec Drupal 10 ?
- Oui, à partir de Drupal 10.3. Drupal 10.3 et 11 sont pris en charge avec PHP 8.1 ou supérieur. Drupal 9 n’est pas pris en charge.
- Ai-je besoin de Composer ou de Drush ?
- Non. La méthode standard est le téléchargement du ZIP : décompressez-le dans web/modules/custom/ et activez le module. Si votre projet utilise Composer, vous pouvez aussi déclarer le dossier décompressé comme dépôt de type path et installer le module avec composer require dokaudit/drupal-dokaudit:@dev. La synchronisation s’effectue via le cron et les boutons de la vue d’ensemble. Drush 12 ou 13 n’est nécessaire que pour les commandes console.
- Combien cela coûte-t-il ?
- Le module est gratuit et publié sous licence GPL. Le contrôle et la correction consomment des crédits comme dans le hub : 1 crédit par tranche de 5 pages entamée, dès 0,50 € HT la page avec la formule Secteur public. À l’inscription, vous recevez 20 crédits d’essai, soit 100 pages. Si le solde est insuffisant, le fichier attend que des crédits soient de nouveau disponibles.
- Puis-je d’abord contrôler sans rien remplacer ?
- Oui. En mode « contrôle seul », vous voyez les scores et les rapports de contrôle, les fichiers restent inchangés. Vous pouvez aussi limiter la synchronisation à certains dossiers.
Rendre accessibles les PDF dans Drupal
Inscrivez-vous, créez une clé API et saisissez-la dans Drupal. 20 crédits d’essai pour 100 pages sont gratuits. Nous répondons volontiers à vos questions sur votre installation lors d’un rendez-vous.
Essai gratuit · Voir la démo en ligne · Prendre rendez-vous