DokAudit für TYPO3
Barrierefreie PDFs direkt in TYPO3. Links und Inhaltselemente bleiben, wie sie sind.
Die DokAudit-Erweiterung prüft die PDFs in Ihrer TYPO3-Dateiliste nach PDF/UA-1, WCAG 2.2 und BITV 2.0 und ersetzt sie durch die korrigierte Fassung. Die Datei behält ihre sys_file-UID. Alle Links, Inhaltselemente und Dateiverweise bleiben gültig.
- TYPO3 12.4 LTS und 13.4 LTS
- 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 die Erweiterung tut
Die Erweiterung verbindet Ihre TYPO3-Installation mit DokAudit. Sie findet die PDFs in der Dateiliste, ü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. Im Modul 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 über die Dateiverwaltung von TYPO3. Die sys_file-UID und der Speicherort bleiben gleich. Links, Inhaltselemente und Dateiverweise müssen Sie nicht anfassen.
- Original gesichert: Vor dem Ersetzen legt die Erweiterung das Original im Ordner /_dokaudit_backup/ im selben Speicher 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 die Erweiterung das Ergebnis und prüft die neue Fassung.
- Modus „nur prüfen“: Im Modus „nur prüfen“ ersetzt die Erweiterung nichts. Sie sehen zuerst, wie es um Ihre PDFs steht, und schalten das Ersetzen später ein.
Für die Redaktion ändert sich nichts
Redakteurinnen und Redakteure laden PDFs wie gewohnt in die Dateiliste und verlinken sie wie bisher. Der Abgleich läuft im Hintergrund über den Scheduler.
Sie legen fest, welche Speicher und Ordner berücksichtigt werden, zum Beispiel nur /formulare/ und /satzungen/. Der Sicherungsordner sowie _processed_ und _temp_ sind ausgenommen. PDFs über einer einstellbaren Größe überspringt die Erweiterung.
Jede Datei durchläuft dieselben Stationen:
- Neu: erkannt und für den Abgleich eingereiht
- Übermittelt: DokAudit prüft, repariert und prüft nach
- Ersetzt: korrigierte Fassung online, Original gesichert
- Geprüft: nur geprüft oder keine ausreichende Verbesserung
- Wartet: Guthaben reicht nicht, es geht weiter, sobald wieder Credits da sind
Das Modul Datei → DokAudit
Das Backend-Modul steht Administratoren zur Verfügung. Fertige Ergebnisse holt es 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.
- Einstellungen im Modul: API-Adresse und Schlüssel tragen Sie direkt im Modul ein. Der Schlüssel wird beim Speichern geprüft, die zugehörige Organisation wird angezeigt.
- Hinweise: Das Modul weist auf noch ungeprüfte PDFs in der Dateiliste und auf knappes Guthaben hin.
- Update-Hinweis: Gibt es eine neuere Version der Erweiterung, weist das Modul darauf hin und verlinkt den ZIP-Download.
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 TYPO3 eintragen: Im Modul Datei → DokAudit → Einstellungen API-Adresse und Schlüssel eintragen. Alle Optionen stehen zusätzlich unter Einstellungen → Erweiterungskonfiguration → dokaudit.
- Scheduler-Aufgabe anlegen: Eine Scheduler-Aufgabe „Konsolenbefehl ausführen“ mit dokaudit:sync anlegen, zum Beispiel alle 10 Minuten. Danach läuft der Abgleich selbstständig.
Installation und Voraussetzungen
Standardweg – ZIP-Download: Aktuelle Version als ZIP herunterladen und im Erweiterungsmanager hochladen. Der Ordner im ZIP heißt dokaudit.
Variante mit Composer: In Composer-Installationen ohne Upload im Erweiterungsmanager entpacken Sie das ZIP in einen Ordner Ihres Projekts und binden ihn als Pfad-Repository ein: composer config repositories.dokaudit '{"type":"path","url":"pfad/zu/dokaudit"}', danach composer require dokaudit/typo3-dokaudit:@dev und vendor/bin/typo3 extension:setup. Der letzte Befehl legt die Tabelle tx_dokaudit_file an.
Auf der Konsole gleicht vendor/bin/typo3 dokaudit:sync die Dateien ab, vendor/bin/typo3 dokaudit:restore mit der UID der Datei spielt ein Original zurück.
- TYPO3 12.4 LTS oder 13.4 LTS
- PHP 8.1 oder neuer
- Systemerweiterung Scheduler für den regelmäßigen Abgleich
- Ein DokAudit-Konto mit API-Schlüssel
DokAudit für Drupal · REST-API und weitere Integrationen
Kosten, Lizenz und Datenschutz
- Abrechnung über Ihre Credits: Die Erweiterung 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: Die Erweiterung 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 die Erweiterung mit Ihrer Instanz.
Häufige Fragen
- Was passiert mit Links auf die PDFs?
- Nichts. Die Datei behält ihre sys_file-UID und ihren Speicherort, nur der Inhalt wird ausgetauscht. Links im Text, Inhaltselemente und Dateiverweise zeigen weiter auf dieselbe Datei.
- Was passiert, wenn die Korrektur schlechter ist als das Original?
- Dann wird nicht ersetzt. Die Erweiterung 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?
- Die Erweiterung ü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 die Erweiterung mit TYPO3 12?
- Ja. Unterstützt werden TYPO3 12.4 LTS und 13.4 LTS mit PHP 8.1 oder neuer. TYPO3 11 und ältere Versionen werden nicht unterstützt.
- Brauche ich Composer?
- Nein. Der Standardweg ist der ZIP-Download: herunterladen und im Erweiterungsmanager installieren. Arbeitet Ihre Installation mit Composer, binden Sie den entpackten Ordner als Pfad-Repository ein und installieren die Erweiterung mit composer require dokaudit/typo3-dokaudit:@dev.
- Was kostet das?
- Die Erweiterung 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 Speicher oder Ordner beschränken.
PDFs in TYPO3 barrierefrei machen
Registrieren Sie sich, legen Sie einen API-Schlüssel an und tragen Sie ihn in TYPO3 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