README

Accessibility Quality Gate brings accessibility checks directly into the TYPO3 editorial workflow.

It combines CKEditor inline feedback, backend issue management, manual and automated scans, and configurable quality gate rules to help editors and integrators catch common accessibility issues before content goes live.

More information, pricing, documentation, and portal access are available on the project website:

https://typo3.priebera.sk/

Features

Free

• CKEditor 5 inline highlighting for accessibility issues
• Backend overview and page detail modules
• Issue tracking with ignore / unignore workflow
• Stable issue fingerprints across rescans
• Manual scans via CLI
• Automated scans via TYPO3 Scheduler
• Changed-only scan mode for incremental rescans
• Quality gate warning mode on page publish / unhide
• CSV export
• TCA-based field discovery for tt_content RTE and file fields
• Settings module for enabling and disabling scanned fields
• Built-in WCAG 2.1 Level AA-oriented rules for common TYPO3 content problems

Trial / PRO / Agency

• Remote frontend accessibility scans
• Remote page detail with issue breakdown and screenshot preview
• PDF export for overview and page detail reports
• Remote CSV export
• Per-site quality gate configuration
• Quality gate blocking mode on publish / unhide
• Diff tracking for new and resolved issues across scans
• Multi-site support for agencies

Plan details, trial access, and pricing:

• Trial: https://typo3.priebera.sk/trial
• Pricing: https://typo3.priebera.sk/pricing

Requirements

• TYPO3 13.4 LTS
• PHP 8.2 or higher
• No additional services required for the Free version

Screenshots

Overview

Page detail

CKEditor inline highlighting

Links

Compatibility

Built-in rules

RTE rules

Structured rules

structured.file_reference_alt checks image file references, falls back to file metadata alt text if no reference-level alt text is set, and supports decorative images via the file reference setting.

Installation

composer require priebera/typo3-a11y-quality-gate

Then:

1. Install and activate the extension in the TYPO3 Extension Manager
2. Apply database schema updates
3. Flush caches
4. Open the Accessibility Quality Gate module in the backend
5. Run Re-scan TCA in Settings once
6. Configure a Scheduler task or run scans manually via CLI

For full setup and usage instructions, see the documentation: https://typo3.priebera.sk/docs

Configuration

Field settings

In the Settings module you can:

• refresh supported fields from TCA
• enable or disable individual fields
• control which fields are included in future scans

Changes are applied only after clicking Save settings.

Quality Gate

A default ruleset is created automatically on first use.

For site-specific rulesets, set site_identifier to match the TYPO3 site configuration identifier.

CLI usage

# Scan a subtree
./vendor/bin/typo3 a11y:scan --root-pid=1

# Scan a single page
./vendor/bin/typo3 a11y:scan --page-uid=42

# Scan changed content only
./vendor/bin/typo3 a11y:scan --root-pid=1 --changed-only

# Scan a specific language
./vendor/bin/typo3 a11y:scan --root-pid=1 --language=1

Backend User TSconfig

options.a11y_quality_gate {
    showToolbarItem = 1
    showScanAll = 1
    showScanNow = 1
}

Scope

Accessibility Quality Gate is a TYPO3-native editorial quality layer. It helps editors and integrators detect common accessibility issues in TYPO3 content fields and manage them directly inside TYPO3.

It does not replace a full accessibility audit, rendered-page review, keyboard testing, assistive technology testing, or a professional WCAG review.

Some rules reflect best practices and may not always correspond to a hard WCAG 2.1 failure in every context. All findings should be reviewed in context.

License

GPL-2.0-or-later