Search by

mindfulmarkup / mindfula11y

mindfulmarkup

Find and fix accessibility issues in TYPO3: missing-alt detection and AI alt-text generation, decorative-image controls, heading/landmark checks, axe-core scans with optional AI audits, semantic Fluid ViewHelpers, and accessible form-validation feedback.

Package info

github.com/crinis/mindfula11y

Type:typo3-cms-extension

pkg:composer/mindfulmarkup/mindfula11y

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 380

Dependents: 0

Suggesters: 0

Stars: 4

Open Issues: 4

v0.12.0 2026-07-12 21:37 UTC

Requires

Requires (Dev)

None

Suggests

  • typo3/cms-form: Adds the localized page-title error prefix after failed server-side EXT:form validation.

Provides

None

Conflicts

None

Replaces

None

GPL-2.0-or-later 4c8fca17c758944afb34d26c493d056540476041

extensiontypo3accessibilitywcagARIAscreen readerheadingsa11ybackend moduleChatGptAI Generationalt textlandmarkssemantic HTML

Published on Packagist.org on 2026-07-12 21:40 UTC

This package is auto-updated.

Last update: 2026-10-03 16:29:31 UTC

README

Mindful A11y helps editors and integrators find and fix common accessibility issues directly in the TYPO3 backend.

What the extension includes

  • Heading and landmark checks in the Accessibility module and the page module. The rendered page is analyzed at mobile and desktop sizes. Findings such as skipped heading levels or ambiguous landmark names show in a structure tree.
  • Fixing in place: editors change heading levels and landmark roles right in that tree. Requires templates that use the extension's Fluid ViewHelpers.
  • Missing alternative text: find, filter and fix images without alternative text, mark them decorative, and optionally generate suggestions with OpenAI.
  • Accessibility fields for content elements: heading type, landmark role and landmark name.
  • Scanner (optional): axe-core scans of pages, page trees or whole sites via the external MindfulAPI service, with HTML/PDF reports and an optional AI review.
  • Page module info box with the page's accessibility status.
  • Form error titles (optional): a localized Error: page-title prefix after failed EXT:form validation.

Accessibility module Overview for a page with a skipped heading level: notices for the last scan and the page structure, and the heading tree with the finding on the affected row and a level select per heading Missing alternative text card with an image preview, the decorative-image option, an AI-generated suggestion in the alternative text field, and Generate and Save buttons Scanner view with the AI review option, critical and serious severity counts, and axe rule groups, one expanded to show the page URL, selector and offending markup

Requirements

  • TYPO3 13.4 LTS (13.4.18 or later) or 14.3 LTS
  • PHP 8.2 to 8.4
  • Optional, for the scanner: MindfulAPI v0.7.0 or later (v0.7.1 or later for the AI review), reachable from TYPO3. Its axe-core checks reliably find technical violations but cover only a subset of accessibility issues.
  • Optional, for AI alternative text: an OpenAI API key
  • Optional, for the form-error title prefix: typo3/cms-form

Installation

composer require mindfulmarkup/mindfula11y
vendor/bin/typo3 extension:setup

extension:setup creates the database fields. Upgrading from a release that stored heading levels in tx_mindfula11y_headinglevel? Also run the upgrade wizard "Mindful A11y: Migrate heading type data from old to new field".

Basic setup

  1. Templates: render content headings with <mindfula11y:heading> and landmark containers with <mindfula11y:landmark> (see the developer guide). The structure checks work on any page, but only headings and landmarks rendered through the ViewHelpers can be fixed from the backend.
  2. Permissions: grant editor groups access to the Accessibility module and the relevant tables and fields (see the permissions checklist).
  3. Optional features in Admin Tools → Settings → Extension Configuration:
    • OpenAI key and model for AI alternative text
    • scannerApiUrl and scannerApiToken for the scanner, then enable it per page tree with mod.mindfula11y_accessibility.scan.enable = 1 (off by default)
    • enableValidationErrorTitlePrefix for the form-error title prefix (off by default)

The structure checks and the Missing alternative text view are on by default. Switch them off per page tree via Page TSconfig (mod.mindfula11y_accessibility.headingStructure.enable, .landmarkStructure.enable, .missingAltText.enable).

Full documentation

See Documentation/Index.md, with separate guides per role:

License

GPL-2.0-or-later