[Plugin Pack Task] P03 WP Block Accessibility Guardian

[ashleyshaw]

---

title: Task - P03 WordPress Block Accessibility Guardian
description: Plugin for scanning and improving block editor accessibility
last_updated: 2026-06-08
created: 2026-06-08
status: active
type: task
parent: EPIC-01

Task: P03 - WordPress Block Accessibility Guardian

Overview

The WordPress Block Accessibility Guardian plugin provides automated scanning and remediation tools for ensuring that custom blocks and block editor usage comply with Web Content Accessibility Guidelines.

Requirements

Functional Requirements

• Scan custom blocks for accessibility compliance
• Check block attributes and properties for ARIA support
• Validate keyboard navigation in block controls
• Audit colour contrast ratios in block previews
• Provide real-time accessibility feedback
• Generate accessibility audit reports
• Suggest remediation strategies

Technical Requirements

• PHP 7.4 minimum
• Compatible with WordPress 6.0+
• Integration with WordPress Block API
• Support for custom block development
• WP-CLI command support

Accessibility Requirements

• The scanning interface itself must comply with WCAG 2.2 AA standards
• All reports must be accessible and screen-reader friendly
• Audit results must be presented in multiple formats
• Dashboard indicators must have text alternatives
• Configuration options must be keyboard navigable

Acceptance Criteria

• Scan and identify blocks with accessibility issues
• Detect missing ARIA attributes
• Check keyboard navigation support
• Audit colour contrast compliance
• Generate detailed reports (WCAG 2.2 AA compliant)
• Suggest remediation improvements
• Documentation and usage guide completed

Implementation Notes

• Use accessibility testing libraries for validation
• Implement incremental scanning for performance
• Provide both automated and manual check options
• Create developer documentation for custom block checks
• Support bulk remediation suggestions

Definition of Ready (DoR)

• Task described and scoped
• Estimate added if relevant

Definition of Done (DoD)

• Task completed and documented
• Changelog entry prepared for PR
• PR uses correct branch prefix

[linear-code]

LS-1005

LS-1073

[github-actions]

✅ Template check passed after update. Thanks for fixing the issue body.