PDF/UA & ADA Media Scanner

By hadesboun

0+ active installationsVersion 1.2.0

Local zero-upload Media Library scanner for ADA Title II (WCAG 2.1 AA) and ISO 14289-1 (PDF/UA-1) structural tokens with 1-click CSV export.

Description

PDF/UA & ADA Media Scanner audits every .pdf inside your WordPress wp-content/uploads directory using 100% pure PHP (zero external binaries, zero Composer packages, and zero client documents uploaded off your server).

Built for municipal web teams, public universities, healthcare portals, and WordPress agencies preparing for the DOJ ADA Title II web & document accessibility rule and ISO 14289-1 (PDF/UA-1).

What It Inspects

  • /StructTreeRoot — Verifies presence of a logical tag structure tree (catches untagged PDFs immediately).
  • /MarkInfo (/Marked true) — Checks marked-content conformance flags required by ISO 14289-1 Clause 7.1.
  • /Lang — Checks primary natural language declaration ((en-US) or XMP xml:lang) for screen reader pronunciation.
  • /Title — Verifies document title metadata in /Info or XMP dc:title.
  • /DisplayDocTitle — Checks /ViewerPreferences << /DisplayDocTitle true >> so assistive technologies announce the title instead of a raw filename.
  • /Encrypt — Flags encrypted PDFs whose security dictionaries may block screen-reader text extraction.
  • Compressed Object Streams (FlateDecode) — Expands bounded PDF 1.5+ object streams in memory so modern InDesign, Word, and Acrobat exports are inspected accurately without false negatives.

Key Features

  1. Executive KPI Cards: Total Media Library PDFs, Passing ADA Title II / ISO 14289-1 structural indicators, and Failing / Untagged PDF counts.
  2. Filterable Diagnostic Table: Inspect per-file token badges, estimated page counts, and missing clause notes right under Tools -> PDF/UA & ADA Scanner.
  3. 1-Click Audit CSV Export: Download a UTF-8 CSV inventory for remediation scoping, stakeholder reporting, or editorial cleanup.
  4. Strict WordPress Security: Capability-gated (manage_options), nonce-protected POST actions (wp_nonce_field / check_admin_referer), CSV formula-injection neutralization, and strict output escaping (esc_html, esc_url, esc_attr).

Offline CLI & Turnkey Remediation Ecosystem

  • Free CLI Starter ($0+): https://pdfuapartnerdesk.gumroad.com/l/compliance-starter-kit
  • GitHub Open Source CLI & GitHub Action: https://github.com/hadesloc/pdfua-ada-checker
  • PDF Accessibility Studio Pro ($19 / $65 / $195): https://hadesloc.github.io/pdfua-partner-desk/#pricing

Scope Notice: Self-serve technical diagnostic software — not legal advice or formal WCAG/ISO certification. For full clause-by-clause ISO 14289-1 validation, run veraPDF 1.30+.

External Services

By default, this plugin performs 100% of PDF structural token inspection locally in PHP without making outbound HTTP requests or transmitting any Media Library files off your server.

If a site administrator chooses to run full ISO 14289-1 (PDF/UA-1) clause-by-clause validation outside WordPress, the plugin documentation references our optional hosted validator service:

  • Service: PDF/UA & ADA Title II Compliance Checker API (veraPDF 1.30.3)
  • Optional Endpoint: https://pdfua-ada-checker.onrender.com/api/check
  • Data Sent (Only When Explicitly Submitted by User): An uploaded PDF file is validated in an ephemeral directory and deleted immediately (0 files retained). The WordPress plugin never sends Media Library PDFs automatically in the background.
  • Support & Privacy Contact: drtheloc@gmail.com

Support

For technical support, bug reports, or accessibility remediation questions, contact drtheloc@gmail.com or open an issue at https://github.com/hadesloc/pdfua-ada-checker.

Installation

  1. Download pdfua-ada-media-scanner.zip from the latest GitHub Release (v1.2.0).
  2. In WordPress Admin, navigate to Plugins -> Add New -> Upload Plugin, select pdfua-ada-media-scanner.zip, and click Install Now.
  3. Click Activate Plugin.
  4. Open Tools -> PDF/UA & ADA Scanner to view your Media Library KPI summary, inspect failing PDFs, or export the CSV report.

FAQ

Does this plugin send any Media Library PDFs to an external API or cloud service?

No. Every byte is inspected locally on your WordPress host using standard PHP file streams. Zero bytes leave your server.

Does it require `pdftotext`, Poppler, Java, or `exec()` shell access?

No. It runs on pure PHP 7.4+ (including restricted shared/managed WordPress hosts where exec() and shell_exec() are disabled).

Does a PASS badge guarantee full WCAG 2.1 AA / ISO 14289-1 legal compliance?

No automated structural pre-check replaces full veraPDF 1.30+ validation and human assistive-technology review (reading order, meaningful alt text, color contrast, and table headers). A FAIL badge, however, deterministically pinpoints PDFs missing mandatory structural markers such as /StructTreeRoot or /Lang.

Changelog

1.2.0

  • Initial public release packaged alongside pdf-accessibility-local Python wheel (v1.2.0 ecosystem release).
  • Added bounded FlateDecode stream expansion for PDF 1.5+ /ObjStm catalog & XMP metadata detection.
  • Added KPI summary cards, status filter views, nonce-protected rescan, and 1-click UTF-8 CSV export.