DP-46152: pdfA11Y-module

changelogs/DP-46152.yml

@@ -0,0 +1,41 @@
+#
+# Write your changelog entry here. Every pull request must have a changelog yml file.
+#
+# Change types:
+# #############################################################################
+# You can use one of the following types:
+#  - Added: For new features.
+#  - Changed: For changes to existing functionality.
+#  - Deprecated: For soon-to-be removed features.
+#  - Removed: For removed features.
+#  - Fixed: For any bug fixes.
+#  - Security: In case of vulnerabilities.
+#
+# Format
+# #############################################################################
+# The format is crucial. Please follow the examples below. For reference, the requirements are:
+#  - All 3 parts are required and you must include "Type", "description" and "issue".
+#  - "Type" must be left aligned and followed by a colon.
+#  - "description" must be indented with 2 spaces followed by a colon
+#  - "issue" must be indented with 4 spaces followed by a colon.
+#  - "issue" is for the Jira ticket number only e.g. DP-1234
+#  - No extra spaces, indents, or blank lines are allowed.
+#
+# Example:
+# #############################################################################
+# Fixed:
+#  - description: Fixes scrolling on edit pages in Safari.
+#    issue: DP-13314
+#
+# You may add more than 1 description & issue for each type using the following format:
+# Changed:
+#  - description: Automating the release branch.
+#    issue: DP-10166
+#  - description: Second change item that needs a description.
+#    issue: DP-19875
+#  - description: Third change item that needs a description along with an issue.
+#    issue: DP-19843
+#
+Added:
+  - description: pdfa11y module for accessibility checks.
+    issue: DP-46152

composer.json

@@ -249,6 +249,7 @@
         "drupal/paragraphs": "^1.10",
         "drupal/pathauto": "^1.13",
         "drupal/pathologic": "^2",
+        "drupal/pdfa11y": "^1.0",
         "drupal/phpstorm_metadata": "^1.0@alpha",
         "drupal/prepopulate": "^2.0",
         "drupal/private_files_download_permission": "^3",
@@ -498,6 +499,9 @@
             "drupal/pathologic": {
                 "Dynamic routes like image styles break under pathologic (https://www.drupal.org/project/pathologic/issues/2718473)": "https://www.drupal.org/files/issues/2020-01-29/2718473-dynamic-image-style-lookup-20.patch"
             },
+            "drupal/pdfa11y": {
+                "Add figure ALT text and heading structure accessibility checks": "patches/pdfa11y/add-figure-alt-and-heading-structure-checks.patch"
+            },
             "drupal/password_policy": {
                 "Can't edit user profile because password policy validates even when password unchanged": "https://www.drupal.org/files/issues/2020-03-19/password_policy-empty-password-skip-validation-2971079-37.patch"
             },

conf/drupal/config/core.extension.yml

@@ -195,6 +195,7 @@ module:
   path: 0
   path_alias: 0
   pathologic: 0
+  pdfa11y: 0
   pfdp: 0
   phpass: 0
   prepopulate: 0

conf/drupal/config/mass_utility.settings.yml

@@ -1,8 +1,8 @@
 allowed_urls: "https://www.youtube.com/\r\nhttps://docs.digital.mass.gov\r\nhttps://public.dep.state.ma.us/\r\nhttps://calendar.google.com/\r\nhttps://dashboards.digital.mass.gov/\r\nhttps://docs.google.com/\r\nhttps://drive.google.com/\r\nhttps://fusiontables.googleusercontent.com/\r\nhttps://libraryh3lp.com/\r\nhttps://mass-eoeea.maps.arcgis.com/\r\nhttps://massgov.formstack.com/forms/sample\r\nhttps://massgov.github.io\r\nhttps://public.tableau.com/\r\nhttps://www.google.com/\r\nhttps://www.massdot.state.ma.us/\r\nhttps://www.massmarinefisheries.net/\r\nhttps://www.youtube.com/\r\nhttps://youtu.be/\r\nhttps://memamaps.maps.arcgis.com/\r\nhttps://maps.google.com/\r\nhttps://licensing.reg.state.ma.us/\r\nhttps://hwy.massdot.state.ma.us/\r\nhttps://dphanalytics.hhs.mass.gov/\r\nhttps://code.highcharts.com/\r\nhttps://eoeea.maps.arcgis.com/\r\nhttps://eeaonline.eea.state.ma.us/\r\nhttps://gis.massdot.state.ma.us/\r\nhttps://dotfeeds.state.ma.us/\r\nhttps://massgis.maps.arcgis.com/\r\nhttps://recollect.net/\r\nhttp://massdot.maps.arcgis.com/\r\nhttps://massdot.maps.arcgis.com/\r\nhttps://calculator.digital.mass.gov/\r\nhttps://api.recollect.net/\r\nhttps://www.eia.gov/beta/states/iframe\r\nhttps://mdphgis.maps.arcgis.com/\r\nhttps://app.powerbigov.us/\r\nhttps://calc.a4we.org/\r\nhttps://w.soundcloud.com/\r\nhttps://www.google.com/maps\r\nhttps://nedews.nrcc.cornell.edu/\r\nhttps://flo.uri.sh/\r\nhttps://app.smartsheet.com/\r\nhttps://experience.arcgis.com/\r\nhttps://hedfuel.azurewebsites.net/\r\nhttps://dhcd-production-public.s3.amazonaws.com/\r\nhttps://cloud.samsara.com/o/8600/fleet/viewer/\r\nhttps://hwywebqa.massdot.state.ma.us\r\nhttps://player.vimeo.com/video/\r\nhttps://massgov.formstack.com/forms/"
 forms_allowed_hostnames:
-  - '/^mass-forms\.ddev\.site$/'
-  - '/^forms\.mass\.local$/'
-  - '/^forms\.mass\.gov$/'
+  - /^mass-forms\.ddev\.site$/
+  - /^forms\.mass\.local$/
+  - /^forms\.mass\.gov$/
   - '/^[a-zA-Z0-9\-]+-mass-forms\.pantheonsite\.io$/'
   - '/^[a-zA-Z0-9\-]+\.forms\.mass\.gov$/'
 header_mixed_urls: "<front>\r\n"

conf/drupal/config/pdfa11y.help.yml

@@ -0,0 +1,3 @@
+_core:
+  default_config_hash: qG3sK-CpYFfcTOo9g2Ji9tI73GvTfO-LFblSox2wI2I
+help_content: "<h2>Creating Accessible PDFs</h2>\r\n\r\n<p>Accessible PDFs ensure that everyone, including people who use screen readers, magnification software, or other assistive technologies, can read and navigate your content. When PDFs lack proper structure, tags, or alternative text, they can be completely unusable for people with disabilities. Making PDFs accessible is not only a best practice — it's required.</p>\r\n<p>See the <a href=\"https://www.mass.gov/info-details/pdf-document-accessibility-testing-checklist\">PDF Document Accessibility Testing Checklist</a>.\r\n"

conf/drupal/config/pdfa11y.settings.yml

@@ -0,0 +1,13 @@
+_core:
+  default_config_hash: bpMUG7_m9cybmlkiNQxtOxmYmgx2eMtHSSQF2ZeT53Q
+enabled_checks:
+  - pdf_version
+  - tagged_pdf
+  - document_title
+  - document_language
+  - figure_alt_text
+  - heading_structure
+min_pdf_version: '1.4'
+check_on_upload: true
+block_failed_uploads: false
+editor_instructions: 'For guidance on creating accessible PDF documents, see the <a href="https://www.mass.gov/info-details/pdf-document-accessibility-testing-checklist" target="_blank">PDF Document Accessibility Testing Checklist</a> (opens in new tab).'