DokAudit für Drupal
Barrierefreie PDFs direkt in Drupal. Medien, Dateifelder und Links bleiben, wie sie sind.
Das DokAudit-Modul prüft die PDFs Ihrer Drupal-Mediathek nach PDF/UA-1, WCAG 2.2 und BITV 2.0 und ersetzt sie durch die korrigierte Fassung. Datei-ID (fid) und URI bleiben gleich. Medien, Dateifelder und Links im Text stimmen weiter.
- Drupal 10.3 und 11
- Original gesichert, Wiederherstellen mit einem Klick
- Lizenz GPL-2.0-or-later
- 20 Test-Credits = 100 Seiten
Kostenlos testen · Live-Demo ansehen · Termin vereinbaren
Was das Modul tut
Das Modul verbindet Ihre Drupal-Website mit DokAudit. Es findet die PDFs der Mediathek, übergibt sie zur Prüfung und Korrektur und tauscht sie anschließend aus.
- Prüfen nach PDF/UA-1, WCAG 2.2 und BITV 2.0: DokAudit prüft jedes PDF, repariert es und prüft es danach erneut. In der Übersicht sehen Sie die Punktzahl vorher und nachher, die erreichten Siegel (PDF/UA-1, WCAG 2.2, PDF/A-2a) und den Link zum Prüfbericht im DokAudit Hub.
- Ersetzen an Ort und Stelle: Die korrigierte Fassung ersetzt die Datei, ohne eine neue Datei-Entität anzulegen. fid und URI bleiben gleich. Medien, Dateifelder und Links im Text müssen Sie nicht anfassen.
- Original gesichert: Vor dem Ersetzen legt das Modul das Original unter public://_dokaudit_backup/ ab. „Original wiederherstellen“ spielt es mit einem Klick zurück.
- Ersetzt wird nur bei Verbesserung: Die Datei wird nur ausgetauscht, wenn die Punktzahl mindestens um den eingestellten Mindest-Punktgewinn steigt (Standard: 1 Punkt). Sonst bleibt das Original online.
- Neue PDFs automatisch eingereiht: Neu hochgeladene oder ersetzte PDFs kommen beim nächsten Abgleich an die Reihe. Wird eine Datei während der Verarbeitung neu hochgeladen, verwirft das Modul das Ergebnis und prüft die neue Fassung.
- Modus „nur prüfen“: Im Modus „nur prüfen“ ersetzt das Modul nichts. Sie sehen zuerst, wie es um Ihre PDFs steht, und schalten das Ersetzen später ein.
Einstellungen unter Konfiguration → Medien → DokAudit
Im Kopfbereich sehen Sie Organisation, Guthaben und Schlüssel auf einen Blick. Ein neuer Schlüssel wird beim Speichern geprüft, die zugehörige Organisation wird angezeigt.
Ohne Eintrag in den Einstellungen gilt die Umgebungsvariable DOKAUDIT_API_KEY. Ein gespeicherter Schlüssel hat Vorrang. Außerdem legen Sie fest:
- Modus: prüfen und ersetzen oder nur prüfen
- Ordner: nur bestimmte Ordner berücksichtigen, zum Beispiel formulare/ und satzungen/, oder Ordner ausnehmen
- Mindest-Punktgewinn: erst ab dieser Verbesserung ersetzen (Standard 1)
- Uploads je Cron-Lauf: Standard 10, der Abgleich per Cron ist abschaltbar
- Sicherungsordner und eine Obergrenze für große PDFs (Standard 50 MB)
Die Übersicht unter Inhalt → DokAudit
Die Übersicht unter /admin/content/dokaudit steht allen Konten mit dem Recht „DokAudit verwalten“ zur Verfügung. Fertige Ergebnisse holt sie beim Öffnen sofort ab.
- Übersicht: Verbindung und Guthaben, Kennzahlen und die Liste aller erfassten PDFs mit Punktzahl vorher und nachher.
- Aktionen: „Jetzt abgleichen“ für alle Dateien, je Datei „Original wiederherstellen“ und „Erneut prüfen“.
- Siegel und Prüfbericht: Je Dokument die erreichten Siegel und ein Link zum Prüfbericht im DokAudit Hub, als Nachweis für Ihre Akte.
- Hinweise: Die Übersicht weist auf noch ungeprüfte PDFs und auf knappes Guthaben hin.
- Update-Hinweis: Gibt es eine neuere Version des Moduls, steht der Hinweis in der Übersicht und im Statusbericht von Drupal.
- Drush: drush dokaudit:sync gleicht die Dateien ab, drush dokaudit:restore mit der Datei-ID spielt ein Original zurück.
Einrichtung in drei Schritten
Nach der Installation dauert die Einrichtung wenige Minuten.
- API-Schlüssel anlegen: Im DokAudit Hub unter Integrationen → API-Schlüssel einen Schlüssel mit Schreibrecht anlegen. Der Schlüssel gehört zu Ihrer Organisation: Dokumente erscheinen in deren Hub und werden mit deren Guthaben abgerechnet.
- Schlüssel in Drupal eintragen: Unter Konfiguration → Medien → DokAudit API-Adresse und Schlüssel eintragen und speichern.
- Cron erledigt den Rest: Der Abgleich läuft mit jedem Cron-Lauf. Zusätzlich können Sie ihn jederzeit über „Jetzt abgleichen“ oder per Drush starten.
Installation und Voraussetzungen
Standardweg – ZIP-Download: Aktuelle Version als ZIP herunterladen, nach web/modules/custom/ entpacken (Ordner dokaudit) und das Modul aktivieren, zum Beispiel mit drush en dokaudit -y. Das Aktivieren legt die Tabelle dokaudit_file an.
Variante mit Composer: Entpacken Sie das ZIP in einen Ordner Ihres Projekts außerhalb von web/modules/custom/ und binden Sie ihn als Pfad-Repository ein: composer config repositories.dokaudit '{"type":"path","url":"pfad/zu/dokaudit"}', danach composer require dokaudit/drupal-dokaudit:@dev und drush en dokaudit -y.
Updates: Ordner ersetzen, danach drush updatedb. Eine neue Version zeigt das Modul selbst an.
- Drupal 10.3 oder 11
- PHP 8.1 oder neuer
- Drush 12 oder 13 für die Konsolenbefehle
- Ein DokAudit-Konto mit API-Schlüssel
DokAudit für TYPO3 · REST-API und weitere Integrationen
Kosten, Lizenz und Datenschutz
- Abrechnung über Ihre Credits: Das Modul selbst kostet nichts. Prüfung und Korrektur rechnet DokAudit wie im Hub ab: 1 Credit je angefangene 5 Seiten, im Kommunal-Tarif ab 0,50 € je Seite, KI inklusive. Preise ansehen
- Lizenz GPL: Das Modul steht unter GPL-2.0-or-later. Sie können den Quelltext einsehen und anpassen.
- Datenschutz: Übertragen werden nur die PDF-Dateien, verschlüsselt per HTTPS. Die Verarbeitung erfolgt in einem ISO/IEC-27001-zertifizierten Rechenzentrum in Deutschland nach dem Auftragsverarbeitungsvertrag Ihrer Organisation.
- Eigene Instanz: Die API-Adresse ist einstellbar. Betreiben Sie DokAudit im eigenen Rechenzentrum, verbinden Sie das Modul mit Ihrer Instanz.
Häufige Fragen
- Was passiert mit Links auf die PDFs?
- Nichts. Datei-ID (fid) und URI bleiben gleich, nur der Inhalt der Datei wird ausgetauscht. Medien, Dateifelder und Links im Text zeigen weiter auf dieselbe Datei.
- Was passiert, wenn die Korrektur schlechter ist als das Original?
- Dann wird nicht ersetzt. Das Modul tauscht eine Datei nur aus, wenn die Punktzahl mindestens um den eingestellten Mindest-Punktgewinn steigt. Ist eine Datei ersetzt, liegt das Original im Sicherungsordner und lässt sich mit einem Klick zurückspielen.
- Werden Dateien an Dritte übertragen?
- Das Modul überträgt nur die PDF-Dateien selbst, verschlüsselt per HTTPS an DokAudit. Verarbeitet werden sie in einem ISO/IEC-27001-zertifizierten Rechenzentrum in Deutschland nach dem Auftragsverarbeitungsvertrag Ihrer Organisation. Für KI-Aufgaben setzt DokAudit einen Anbieter ein, der im AVV als Unterauftragsverarbeiter genannt ist. KI lässt sich auf Anbieter in der EU beschränken oder abschalten.
- Läuft das Modul mit Drupal 10?
- Ja, ab Drupal 10.3. Unterstützt werden Drupal 10.3 und 11 mit PHP 8.1 oder neuer. Drupal 9 wird nicht unterstützt.
- Brauche ich Composer oder Drush?
- Nein. Der Standardweg ist der ZIP-Download: nach web/modules/custom/ entpacken und das Modul aktivieren. Arbeitet Ihr Projekt mit Composer, können Sie den entpackten Ordner auch als Pfad-Repository einbinden und das Modul mit composer require dokaudit/drupal-dokaudit:@dev installieren. Der Abgleich läuft über Cron und die Schaltflächen in der Übersicht. Drush 12 oder 13 brauchen Sie nur für die Konsolenbefehle.
- Was kostet das?
- Das Modul ist kostenlos und steht unter der GPL. Für Prüfung und Korrektur verbrauchen Sie Credits wie im Hub: 1 Credit je angefangene 5 Seiten, im Kommunal-Tarif ab 0,50 € je Seite. Zum Testen erhalten Sie bei der Registrierung 20 Credits, das sind 100 Seiten. Reicht das Guthaben nicht, wartet die Datei, bis wieder Credits da sind.
- Kann ich zuerst nur prüfen, ohne etwas zu ersetzen?
- Ja. Im Modus „nur prüfen“ sehen Sie Punktzahlen und Prüfberichte, die Dateien bleiben unverändert. Zusätzlich können Sie den Abgleich auf einzelne Ordner beschränken.
PDFs in Drupal barrierefrei machen
Registrieren Sie sich, legen Sie einen API-Schlüssel an und tragen Sie ihn in Drupal ein. 20 Test-Credits für 100 Seiten sind kostenlos. Fragen zu Ihrer Installation klären wir gern in einem Termin.
Kostenlos testen · Live-Demo ansehen · Termin vereinbaren