This module integrates Adobe PDF Services API with Drupal to automatically analyze, check accessibility, and optimize uploaded PDF files. It helps ensure PDFs are compliant with standards like PDF/UA, improves performance by compressing files, and offers options for displaying PDFs with the Adobe PDF Embed Viewer. The module supports blocking uploads with accessibility errors and provides a dashboard for monitoring processing status.
PDF Services integrates Adobe PDF Services API with Drupal, enabling automated PDF analysis, accessibility checking, and optimization for uploaded files. It helps ensure your site's PDFs are accessible, compliant, and optimized for performance.
Features
- NEW Block Uploads for Failing PDF Accessibility: For new uploads fields can be set to prevent saving the PDF if it contains ADA errors. Separate permission for a Bypass Justification to document exemptions for users with that permission.
- Automated PDF analysis: Extracts properties like page count, size, and structure from uploaded PDFs.
- Accessibility compliance checking: Validates PDFs against PDF/UA standards and generates detailed accessibility reports and remediation suggestions.
- Adobe PDF Embed Viewer: Field formatter with lots of options for displaying your PDF's (LightBox, Full Screen, Two Column etc.). With local overrides so editors can tailor the display to the document.
- PDF optimization: Compresses and linearizes PDFs to reduce file size, with configurable thresholds and compression levels.
- Field-level configuration: Allows per-field settings for PDF processing, so different content types or fields can have unique handling.
- Asynchronous queue processing: Uses Drupal's queue system to process PDFs in the background, ensuring content editing remains fast.
- Status dashboard: Provides an admin dashboard to monitor processing status, view reports, and manage the queue.
- Email notifications: Notifies editors when accessibility issues are detected.
- Views integration: Exposes PDF analysis and accessibility results for use in Drupal Views.
- Customizable via hooks: Other modules can alter processing logic using
hook_pdf_services_should_process_file_alter().
Use cases include government, education, or any organization needing to ensure uploaded PDFs are accessible and optimized, with minimal manual intervention.
Post-Installation
- Configure Adobe API credentials at
/admin/config/content/pdf-services. - Set processing options (batch size, retry limits, notifications).
- Edit file fields on content types to enable PDF processing and set field-level options.
- Upload PDFs—processing is automatic on the next cron run.
- Monitor processing and view reports at
/admin/config/content/pdf-services/queue.
Additional Requirements
- Adobe PDF Services API credentials (Client ID and Secret). Sign up here.
- Optional: HTML email module like Symfony Mailer Lite
- No additional contributed modules required, but Drupal core's File module is needed.
Similar projects
- PDF Preview: Generates thumbnails/previews, but does not analyze or optimize PDFs.
- Entity Print: Creates PDFs from entities, not for analyzing uploads.
- PDF Reader: Embeds a PDF viewer, but does not check accessibility or optimize.
- pdf: Integrates pdf.js for in-browser viewing.
- pdfa11y Similar but doesn't use the adobe API
PDF Services is unique in providing deep integration with Adobe's enterprise-grade PDF analysis and accessibility tools, focusing on compliance and optimization.
Supporting this Module
Maintained by the city of Tampa web development team. Contribute via pull requests, report issues, or share your use cases to help improve the module.
Community Documentation
- Adobe PDF Services API Documentation
- See the README for API usage examples and advanced configuration.