amdeu / typo3-label-editor
Translation Label Editor
Package info
github.com/amdeu/typo3-label-editor
Type:typo3-cms-extension
pkg:composer/amdeu/typo3-label-editor
Requires
- typo3/cms-core: ^13.4
README
A TYPO3 backend module for editing translation labels (locallang files) without modifying the original extension files. This extension's intended goal is to allow editors to independently translate frontend labels without requiring developer involvement.
Features
- 📝 Edit labels - Customize any label from any extension
- 🌍 Multi-language support - Edit multiple languages simultaneously
- ➕ Add custom labels - Create new labels that don't exist in the original files
- 🔍 Search & filter - Quickly find labels
- 🎯 Non-destructive - Original extension files remain untouched
Works with locallang_formats if you want to use YAML, JSON, or PHP array files instead of XLF.
📋 Requirements
- TYPO3 13.4
- PHP 8.2
📦 Installation
composer require amdeu/typo3-label-editor
🛠️ Usage
Access the Module
Navigate to Site Management → Label Editor in the TYPO3 backend.
Add an Extension
- Find the extension you want to edit in the "Add Extension" section
- Click the "+" button to add it to management
- The extension's locallang files are now available for editing
Edit Labels
- Select an extension from the "Managed Extensions" list
- Choose the label file from the dropdown
- Select one or more languages using the checkboxes
- Edit labels in the table:
- Single language view: Shows original and custom override
- Multi-language view: Shows override for each selected language
- Click "Save" in the document header
Add Custom Labels
- Enter a label key (e.g.,
my.custom.label) in the input field - Click "+"
- The label is created across all language files
- Fill in the values and save
Search Labels
Use the search box above the table to filter labels by key or value in real-time.
Remove an Extension
- Click the trash icon next to a managed extension
- Confirm the warning dialog
- All custom label overrides for that extension will be deleted
💡 How It Works
The extension uses TYPO3's locallangXMLOverride/resourceOverrides feature:
- When you add an extension, a registry is created at
var/label_editor/registry.json - Custom labels are stored in
var/label_editor/overrides/{extension}/{file}.xlf - TYPO3 merges these override files with the original locallang files
- Original extension files remain unchanged