PHPackages mindfulmarkup/mindfula11y - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. mindfulmarkup/mindfula11y ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility) mindfulmarkup/mindfula11y ========================= 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. v0.12.0(1mo ago)43651[1 issues](https://github.com/crinis/mindfula11y/issues)[1 PRs](https://github.com/crinis/mindfula11y/pulls)GPL-2.0-or-laterPHPPHP >=8.2 <=8.4CI passing Since May 30Pushed 3w agoCompare [ Source](https://github.com/crinis/mindfula11y)[ Packagist](https://packagist.org/packages/mindfulmarkup/mindfula11y)[ RSS](/packages/mindfulmarkup-mindfula11y/feed)WikiDiscussions main Synced 2w ago READMEChangelog (10)Dependencies (22)Versions (23)Used By (0) Mindful A11y for TYPO3 ====================== [](#mindful-a11y-for-typo3) Mindful A11y helps editors and integrators find and fix common accessibility issues directly in the TYPO3 backend. What the extension includes --------------------------- [](#what-the-extension-includes) - **Accessibility backend module** with: - **General**: heading and landmark structure overview with issue hints. - **Missing alternative text**: list, filter, and edit image/file references without alt text. - **Scanner (optional)**: run scans, review findings, and export HTML/PDF reports for single or multiple pages or crawls of the entire page tree. - **Optional AI alt text generation** via OpenAI for missing image alt text. - **Per-reference decorative images** that render with native `f:image`/`f:media` and stay out of missing-alt results. - **Accessibility fields for content elements** (heading type, landmark, ARIA labels). - **Fluid ViewHelpers** for accessible heading and landmark rendering and integration with the backend module. - **Page module info box** with quick accessibility status and links. - **CLI cleanup command** to cleanup outdated scan results. - **Accessible server-side form errors** with a localized `Error:` page-title prefix for failed TYPO3 EXT:form validation. Scanner functionality uses the external [MindfulAPI](https://github.com/crinis/mindfulapi) project and is **required** for scanner features. MindfulAPI runs axe-core based technical scans in a headless browser environment. These automated checks are reliable for technical violations but only cover a subset of accessibility issues. Scanner features are available only when **both** requirements are met: - MindfulAPI **v0.7.0 or later** is installed and reachable from TYPO3 (v0.7.0 introduces the `/v1` API routes and the AI agent audit this extension consumes) - Page TSconfig sets `mod.mindfula11y_accessibility.scan.enable = 1` (default is `0`) [![Accessibility module overview in TYPO3 backend with feature selector menu and status callouts for missing alt text, structure checks, and scanner issues](Documentation/Images/readme-accessibility-module-overview.png)](Documentation/Images/readme-accessibility-module-overview.png)[![Missing alternative text workflow showing preview, editable field, generate action, and save action](Documentation/Images/readme-missing-alt-text-workflow.png)](Documentation/Images/readme-missing-alt-text-workflow.png)[![Scanner results panel showing issue severity badges, selector and context details, and HTML/PDF report buttons](Documentation/Images/readme-scanner-results.png)](Documentation/Images/readme-scanner-results.png) Requirements ------------ [](#requirements) - TYPO3 `13.4.x LTS` or `14.3.x LTS` - PHP `8.2` to `8.4` - For scanner features: [MindfulAPI](https://github.com/crinis/mindfulapi) `v0.7.0` or later Installation ------------ [](#installation) ``` composer require mindfulmarkup/mindfula11y ``` Basic setup ----------- [](#basic-setup) 1. Install and enable the extension in TYPO3. 2. In **Admin Tools → Settings → Extension Configuration**, set: - OpenAI key/model (only if you want AI alt text generation) - Scanner API URL/token (only if you want scanner results), for example `http://localhost:3000` or `https://scanner.example.com` - For scanner support: set up [MindfulAPI](https://github.com/crinis/mindfulapi) with Docker first 3. Enable or disable module sections via Page TSconfig: - `mod.mindfula11y_accessibility.missingAltText.enable` - `mod.mindfula11y_accessibility.headingStructure.enable` - `mod.mindfula11y_accessibility.landmarkStructure.enable` - `mod.mindfula11y_accessibility.scan.enable = 1` to use scanner features (off by default) The validation-error page-title prefix is enabled globally by default. Disable it with `enableValidationErrorTitlePrefix` under **Admin Tools → Settings → Extension Configuration**. `typo3/cms-form` is optional; without it, this integration remains inactive. Full documentation ------------------ [](#full-documentation) See `Documentation/Index.md` for complete docs with separate guides for editors, integrators, and developers. - Editors: `Documentation/Editors/Index.md` - Integrators: `Documentation/Integrators/Index.md` - Developers: `Documentation/Developers/Index.md` License ------- [](#license) GPL-2.0-or-later ### Health Score 46 — FairBetter than 92% of packages Maintenance89 Actively maintained with recent releases Popularity20 Limited adoption so far Community7 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~22 days Recently: every ~34 days Total 19 Last Release 40d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/71df8106ceebb6b342c74fde1f434bbdc807a7e2257a93eb0ad7b99c352016ed?d=identicon)[mindfulmarkup](/maintainers/mindfulmarkup) --- Top Contributors [![crinis](https://avatars.githubusercontent.com/u/6907942?v=4)](https://github.com/crinis "crinis (259 commits)") --- Tags accessibilitytypo3typo3-extensionextensionaccessibilitytypo3wcagARIAChatGptbackend-moduleAI Generationalt texta11yscreen readerheadingslandmarkssemantic HTML ### Embed Badge ![Health badge](/badges/mindfulmarkup-mindfula11y/health.svg) ``` [![Health](https://phpackages.com/badges/mindfulmarkup-mindfula11y/health.svg)](https://phpackages.com/packages/mindfulmarkup-mindfula11y) ``` ### Alternatives [friendsoftypo3/content-blocks TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML 103574.3k70](/packages/friendsoftypo3-content-blocks)[eliashaeussler/typo3-form-consent Extension for TYPO3 CMS that adds double opt-in functionality to EXT:form 15100.9k](/packages/eliashaeussler-typo3-form-consent)[pagemachine/typo3-formlog Form log for TYPO3 23243.0k8](/packages/pagemachine-typo3-formlog)[yoast-seo-for-typo3/yoast_seo Yoast SEO for TYPO3 571.8M9](/packages/yoast-seo-for-typo3-yoast-seo)[web-vision/wv_deepltranslate DeepL Translate (CORE) - This extension provides option to translate content element, and TCA record texts to DeepL supported languages. 34311.2k](/packages/web-vision-wv-deepltranslate)[friendsoftypo3/visual-editor TYPO3 CMS Visual Editor - Brings a modern WYSIWYG editing experience to TYPO3 CMS. 6010.0k3](/packages/friendsoftypo3-visual-editor) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)