PHPackages                             barrierefrei-space/alt-text-gen - 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 &amp; Helpers](/categories/utility)
4. /
5. barrierefrei-space/alt-text-gen

ActiveTypo3-cms-extension[Utility &amp; Helpers](/categories/utility)

barrierefrei-space/alt-text-gen
===============================

TYPO3 extension for AI-powered accessible image alt text generation.

1.1.1(2w ago)113GPL-2.0-or-laterPHPPHP ^8.2CI passing

Since May 21Pushed 2w agoCompare

[ Source](https://github.com/barrierefreispace/alt-text-gen)[ Packagist](https://packagist.org/packages/barrierefrei-space/alt-text-gen)[ Docs](https://www.barrierefrei.space)[ RSS](/packages/barrierefrei-space-alt-text-gen/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (6)Used By (0)

barrierefrei.space ALT Text Generator
=====================================

[](#barrierefreispace-alt-text-generator)

[English](README.md) | [Deutsch](README.de.md)

Website:

TYPO3 extension for AI-generated accessible ALT text, subscription management, and charity impact display.

The extension adds an ALT text generator to TYPO3 image references, provides a branded backend Subscription Center, and includes a small Donation Widget that shows the total amount donated to charity through the site's subscription.

Features
--------

[](#features)

- AI ALT text generation for `sys_file_reference.alternative`
- Magic wand action directly next to TYPO3 image ALT fields
- Per-image generation preferences persisted on the file reference:
    - Style: `tx_barrierefrei_space_style`
    - SEO keywords: `tx_barrierefrei_space_seo_keywords`
- 20 free usages per domain after installation
- Backend Subscription Center for license and subscription management
- Real Site URL resolution from TYPO3 site configuration
- English and German backend UI
- Donation Widget content element showing total donated amount

Requirements
------------

[](#requirements)

- PHP `>= 8.2`
- TYPO3 `^13.0 || ^14.0`
- A configured TYPO3 site base URL
- Outbound HTTPS access from TYPO3 to the barrierefrei.space API

Installation
------------

[](#installation)

Install the extension directly from Packagist:

```
composer require barrierefrei-space/alt-text-gen
```

To require a specific release line:

```
composer require barrierefrei-space/alt-text-gen:^1.0
```

Enable in TYPO3
---------------

[](#enable-in-typo3)

1. Enable the extension key `barrierefrei_space`.
2. Run database updates in the Install Tool or Maintenance module.
3. Include the static TypoScript template `ALT Text Generator`.
4. Clear TYPO3 caches.

Database updates add these fields to `sys_file_reference`:

- `tx_barrierefrei_space_style`
- `tx_barrierefrei_space_seo_keywords`

Extension Configuration
-----------------------

[](#extension-configuration)

TYPO3 backend path:

`Settings -> Extension Configuration -> barrierefrei_space`

Available setting:

- `licenseKey`: license key for the current site subscription

The service endpoint is built in and hidden from Extension Configuration.

The Site URL is resolved from the current TYPO3 site configuration and cannot be edited in Extension Configuration. Make sure your site base URL is configured correctly in TYPO3.

ALT Text Generation
-------------------

[](#alt-text-generation)

Open a TYPO3 record that contains an image reference. The extension adds a magic wand control next to the Alternative Text field.

The generator sends the image and generation preferences to the API, then writes the generated accessible ALT text back into the field.

Supported backend languages:

- English
- German

Subscription Center
-------------------

[](#subscription-center)

Backend module:

`Web -> Subscription Center`

Route:

`/module/web/barrierefrei-space/subscription`

The Subscription Center provides:

- Current license and subscription status
- Current resolved Site URL
- Latest license key returned for the site
- Plan cards for subscription and top-up purchase
- Billing portal access
- Subscription cancellation for the current plan
- Status timeline with pagination
- First-open guide that can be reopened with the question mark icon
- Loading states for refresh, subscribe, cancel, and buy-once actions
- Links to barrierefrei.space and subscription contact information

Stripe checkout and billing portal links open in a new browser tab to avoid TYPO3 backend iframe CSP restrictions.

Donation Widget
---------------

[](#donation-widget)

The extension provides a frontend content element:

`Donation Widget`

CType:

`barrierefreispace_donationwidget`

The widget shows only the total amount donated to charity for this site's subscription and links to:

The amount is fetched from the API using the configured `licenseKey` and the resolved TYPO3 Site URL.

### Widget Position

[](#widget-position)

In the content element Appearance tab, only these layout choices are available:

- Fixed bottom left
- Fixed bottom right

The widget is intentionally compact and fixed-position so it can communicate charity impact without taking over the page layout.

Internationalization
--------------------

[](#internationalization)

Language files:

- English: `Resources/Private/Language/locallang.xlf`
- German: `Resources/Private/Language/de.locallang.xlf`

The backend UI follows the TYPO3 backend user language.

Migration Notes
---------------

[](#migration-notes)

Current Donation Widget CType:

`barrierefreispace_donationwidget`

An upgrade wizard migrates legacy list type values to the current CType:

- `alttextgen_donationwidget`
- `barrierefrei_space_donationwidget`
- `barrierefreispace_donationwidget`

Troubleshooting
---------------

[](#troubleshooting)

### Composer cannot find the package

[](#composer-cannot-find-the-package)

Make sure the package name is spelled correctly and Packagist is enabled in your Composer configuration.

```
composer require barrierefrei-space/alt-text-gen
```

### Site URL is wrong

[](#site-url-is-wrong)

The extension does not provide a Site URL override. Fix the TYPO3 site configuration instead.

Check:

- Site Management -&gt; Sites
- The site's configured base URL
- Reverse proxy / HTTPS headers, if TYPO3 runs behind a proxy

### License status does not update

[](#license-status-does-not-update)

Check:

- `licenseKey` is saved in Extension Configuration
- TYPO3 can reach the API over HTTPS
- The displayed Site URL matches the site used for the subscription
- TYPO3 caches were cleared after configuration changes

### Donation Widget is not visible

[](#donation-widget-is-not-visible)

Check:

- Static TypoScript template `ALT Text Generator` is included
- `licenseKey` is configured
- Site URL is resolved correctly
- The API returns a donation payload for the subscription
- The content element uses one of the fixed bottom layouts

License
-------

[](#license)

Copyright (c) 2026 barrierefrei.space

Licensed under GPL-2.0-or-later. See [LICENSE](LICENSE).

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance97

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

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 ~1 days

Total

4

Last Release

14d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/234874e1b6bd028028b63d30ce45d5d6665966a123c8c7ac81718c120d633695?d=identicon)[veritium](/maintainers/veritium)

---

Tags

aiaccessibilitytypo3wcagalt text

### Embed Badge

![Health badge](/badges/barrierefrei-space-alt-text-gen/health.svg)

```
[![Health](https://phpackages.com/badges/barrierefrei-space-alt-text-gen/health.svg)](https://phpackages.com/packages/barrierefrei-space-alt-text-gen)
```

###  Alternatives

[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

41515.2k](/packages/wazum-sluggi)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

101466.4k44](/packages/friendsoftypo3-content-blocks)[typo3/cms-styleguide

TYPO3 extension to showcase TYPO3 Backend capabilities

106749.2k26](/packages/typo3-cms-styleguide)[jweiland/events2

Events 2 - Create single and recurring events

2165.2k3](/packages/jweiland-events2)[in2code/lux

Living User eXperience - LUX - the Marketing Automation tool for TYPO3.

2156.6k1](/packages/in2code-lux)[wapplersystems/ws-scss

Compiles SCSS to CSS at runtime with caching, TypoScript variables and EXT: import support

11144.8k7](/packages/wapplersystems-ws-scss)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
