What does it do? 

The AI Tools extension provides automatic generation of ALT and title texts for images using the OpenAI ChatGPT API. This helps improve website accessibility by ensuring all images have meaningful alternative texts.

How It Works 

Unlike most TYPO3 extensions that generate ALT and title texts for sys_file_reference records, this extension sets the metadata directly on the sys_file record.

This approach has several advantages:

• One-time generation – Each image only needs to be processed once, regardless of how many times it's used across your website
• Consistent texts – The same image always has the same ALT and title text, ensuring consistency
• Lower API costs – No redundant API calls for the same image used in multiple places
• Automatic inheritance – All sys_file_reference records automatically inherit the texts from the parent sys_file
• Centralized management – Edit the text once, and it updates everywhere the image is used

Key Features 

• AI-powered text generation: Uses OpenAI's GPT-4 Vision API to analyze images and generate appropriate ALT and title texts
• Multi-language support: Generate texts in multiple languages based on your site configuration
• Backend module: Dedicated backend module in the File section for managing image metadata
• Bulk processing: Process multiple images at once with progress tracking
• Per-language control: Enable or disable AI text generation for specific languages via site configuration
• Auto-generation: Optionally auto-generate texts when file references are saved
• Customizable prompts: Configure the AI prompt template to match your requirements

Screenshots 

Batch Processing 

You can process all files in the fileadmin in a batch:

Manual Editing 

You can always manually change the texts and also use the backend module without an OpenAI account or ChatGPT key:

Language Switching 

All translations at one place:

Disable Languages 

Languages can be excluded from the AI translation in the site configuration:

Auto-Generation 

The sysFile texts are generated during save (can be disabled in the Extension Manager) but can be overridden individually for every sysFileReference:

Requirements 

• TYPO3 12.4 LTS
• PHP 8.1 or higher
• OpenAI API key with access to GPT-4 Vision models
• nnhelpers extension (for database utilities)

Support This Project 

If you find this extension useful, please consider supporting its development:

Your support helps us maintain and improve this extension.

Privacy Notice 

Installation via Composer 

The recommended way to install this extension is via Composer:

composer require nng/nnaitools

Installation via TER 

Alternatively, you can install the extension from the TYPO3 Extension Repository (TER):

1. Go to Admin Tools > Extensions
2. Search for "nnaitools"
3. Click the import icon to install the extension

After Installation 

1. Activate the extension in the Extension Manager
2. Clear all caches
3. Configure the extension settings (see Configuration)
4. Assign backend user permissions for the module

Dependencies 

This extension requires:

• nnhelpers: Database utility functions (automatically installed via Composer)

Support This Project 

This extension is free and open source. If it helps you improve your website's accessibility, please consider supporting its development:

Extension Configuration 

Configure the extension in Admin Tools > Settings > Extension Configuration > nnaitools.

/fileadmin/templates/.*
/fileadmin/_processed_/.*
.*placeholder.*

Cost Control Settings 

The extension provides built-in cost tracking and limiting to help you manage API expenses.

Site Language Configuration 

You can disable AI text generation for specific languages in your site configuration.

1. Go to Site Management > Sites
2. Edit your site configuration
3. For each language, you'll find a checkbox "Disable the automatic alt-/title-text generation via AI"
4. Check this box to exclude the language from AI text generation

When a language is disabled:

• It will appear grayed out in the backend module's language dropdown
• No texts will be generated for this language during bulk processing
• The language will be skipped in auto-generation

Backend User Permissions 

To allow backend users access to the AI Tools module:

1. Go to System > Backend Users
2. Edit the user or user group
3. Under Access Lists > Modules, enable File > AI Tools

Support This Project 

If this extension saves you time and helps improve your website's accessibility, please consider supporting its development:

Your contribution helps us maintain, improve, and add new features to this extension.

Backend Module 

The AI Tools backend module is located in the File section of the TYPO3 backend, below the Filelist module.

Token Statistics and Cost Overview 

The backend module displays real-time token usage and cost information in the toolbar.

Estimated Cost = (Input Tokens / 1000 × costPerInputTokens) + (Output Tokens / 1000 × costPerOutputTokens)

Auto-Generation 

When Auto-generate on Save is enabled in the extension configuration, the extension will automatically generate texts when:

1. A sys_file_reference record is saved
2. The ALT text or title text is empty
3. The referenced file is an image

This works for all enabled languages in your site configuration.

API Response Format 

The extension expects the OpenAI API to return a JSON response in this format:

{
  "de": {
    "alt": "German ALT text",
    "title": "German title text"
  },
  "en": {
    "alt": "English ALT text",
    "title": "English title text"
  }
}

The language keys correspond to the two-letter ISO codes from your site configuration.

Support This Project 

Enjoying this extension? Help us keep it maintained and add new features:

Every contribution, no matter how small, is greatly appreciated!

API Rate Limits 

The OpenAI API has rate limits that may affect bulk processing of large image collections. If you encounter rate limit errors, try:

• Processing images in smaller batches
• Waiting a few minutes between bulk operations
• Upgrading your OpenAI API plan for higher limits

Image Size Limitations 

Very large images may take longer to process or fail due to API timeouts. The extension automatically uses optimized image URLs, but extremely large files may still cause issues.

Multi-Site Environments 

The extension automatically detects the current site based on the HTTP host. In complex multi-site setups, ensure your site configurations have correct base and baseVariants settings.

Cache Issues 

After changing extension configuration or site language settings, clear all TYPO3 caches to ensure the changes take effect.

Reporting Issues 

If you encounter any problems, please report them on the extension's issue tracker.

Support This Project 

Found a solution to a problem? Consider giving back:

Your support helps us fix bugs and improve the extension.