包简介

TYPO3 extension that adds a warning overlay icon in the File List module for files missing alternative text, and adds an Alternative text column to file reference tables in the backend.

README 文档

README

TYPO3 extension that adds a warning overlay icon to files in the File List module when the file is missing alternative text, and adds an "Alternative text" column to the file reference tables in the backend.

Requirements

TYPO3 13.4+

Installation

composer require leuchtfeuer/alt-text-checker

After installation, clear the TYPO3 cache. No further configuration is required — the extension works out of the box.

What it does

Warning icon in the File List

The extension hooks into TYPO3's icon rendering via the PSR-14 ModifyIconForResourcePropertiesEvent. It adds an overlay-warning icon to any file in the File List module when:

the file itself has no alternative text set in sys_file_metadata, or
any of its file references has no alternative text set in sys_file_reference

This gives editors a quick visual cue to identify images that need attention before publishing.

"Alternative text" column in reference tables

The extension overrides the backend ElementInformation template to add an Alternative text column to the "References to this item" table. The column shows:

Value	Meaning
Yes	All file references for this relation have alternative text set
No	At least one file reference for this relation is missing alternative text

The column is visible when viewing the info panel of any file in the backend (click the info icon next to a file in the File List).

How to use

Open the File module in the TYPO3 backend.
Navigate to the folder containing your images.
Any image with a yellow warning overlay icon is missing alternative text — either at the file level or in one of its references.
Click the info icon (ℹ) next to a file to open the element information panel.
Scroll to the References section. The Alternative text column shows Yes or No for each relation.
To fix a missing alt text:
- At file level: Edit the file metadata and fill in the Alternative Text field (sys_file_metadata.alternative).
- At reference level: Edit the content element or record that references the file and fill in the Alternative Text field on the image relation.

Once all missing alt texts are filled in and the cache is cleared, the warning icon disappears.

Localization

The extension ships with English and German translations. To add your own language, create a translation file.

License

GPL-2.0-or-later

leuchtfeuer/alt-text-checker 适用场景与选型建议

leuchtfeuer/alt-text-checker 是一款基于 HTML 开发的 Composer 扩展包，目前已累计 7 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 03 月 19 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 leuchtfeuer/alt-text-checker 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 leuchtfeuer/alt-text-checker 我们能提供哪些服务？

定制开发 / 二次开发

基于 leuchtfeuer/alt-text-checker 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

leuchtfeuer/alt-text-checker

包简介