sitegeist / translatelabels
This extension extends the TYPO3 translation handling by translation records that can be edited by backend users. In this way backend users are able to translate labels without having access to the language files.
Installs: 28 462
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 5
Forks: 8
Open Issues: 12
Type:typo3-cms-extension
Requires
- typo3/cms-adminpanel: ^11.5 || ^10.4
- typo3/cms-core: ^11.5 || ^10.4
Requires (Dev)
- typo3/testing-framework: ^6.10
Replaces
- typo3-ter/translatelabels: 2.3.9
- dev-master
- 2.3.9
- 2.3.8
- 2.3.7
- 2.3.6
- 2.3.5
- 2.3.4
- 2.3.3
- 2.3.2
- 2.3.1
- 2.3.0
- 2.2.1
- 2.2.0
- 2.1.0
- 2.0.14
- 2.0.13
- 2.0.12
- 2.0.11
- 2.0.10
- 2.0.9
- 2.0.8
- 2.0.7
- 2.0.6
- 2.0.5
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.1.6
- 1.1.5
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.1
- 1.0.0
- 1.0.0-beta
- dev-bugfix/86353/fixItemsTranslations
- dev-feature/00000/fixExtTables
- dev-upgradePhp8
- dev-dependabot/composer/typo3/cms-core-10.4.36
- dev-dependabot/composer/typo3/html-sanitizer-2.1.1
- dev-dependabot/composer/guzzlehttp/guzzle-7.5.0
- dev-release/2.1.0
- dev-bugfix/2.0.13/versionConstraints
- dev-task/24/addExtensionKey
- dev-release/2.0.12
- dev-release/2.0.11
- dev-release/2.0.10
- dev-release/1.1.6
- dev-release/2.0.9
- dev-bugfix/newlines
- dev-feature/v10/formOptions
- dev-release/1.1.5
- dev-release/1.1.4
- dev-release/2.0.6
- dev-release/1.1.3
- dev-release/1.1.2
- dev-release/2.0.4
- dev-release/1.1.1
- dev-typo3-10.1
- dev-release/1.1.0
- dev-release/1.0.0
This package is auto-updated.
Last update: 2024-10-07 16:53:57 UTC
README
Purpose
This extension extends the TYPO3 translation handling by translation records that can be edited by backend users. In this way backend users are able to translate labels without having access to the language files.
This extension can also be used to translate forms created with the Form Editor.
In the frontend the labels appear underlined with a red line. A tooltip with its name appears on mouseover. A click on the label name opens the new translate module in the admin panel to edit the translation for the label inline.
Additionally you find a second tab in the new module in the admin panel that shows all labels found on the current page listing the corresponding language files and eventually existing overrides or translation records.
This view is especially interesting for developers.
Authors & Sponsors
- Alexander Bohndorf - bohndorf@sitegeist.de
The development and the public-releases of this package is generously sponsored by my employer https://www.sitegeist.de.
Screenshots
Frontend view
Translation module in admin panel with inline editing
Translation module in admin panel with label inheritance view
Supported TYPO3 Versions
- Version 1.x of this extension supports TYPO3 9.5.
- Version 2.0 of this extension supports TYPO3 10
- Version 2.1 of this extension supports TYPO3 11.
How to install
-
Install the extension and activate it in Extension Manager or via composer:
- For TYPO3 9.5:
composer require sitegeist/translatelabels:^1
- Starting from TYPO3 10.0:
composer require sitegeist/translatelabels
- For TYPO3 9.5:
-
Then go to the backend extension manager and load the extension in "Installed Extensions".
-
Update your database with BE module "Maintenance/Analyze Database Structure".
-
Create a sysfolder in TYPO3 backend to store the translated labels.
-
Create a localization of this sysfolder for each website language of your website.
-
Include the extension template
translate_labels
into your root TYPOSCRIPT template.
How to configure
Add the following TYPOSCRIPT to your template:
plugin.tx_translatelabels.settings.storagePid = 4711
Replace 4711
with the uid of the sysfolder you just created for
your translated labels.
Be aware that this setting has to be defined for all pages using this extension and also for all sysfolders containing the translation records.
TYPO3 patch needed for TYPO3 version 9.5 and 10.1 (bug #87038)
Due to the not yet fixed bug https://forge.typo3.org/issues/87038 in TYPO3 9.5.9 and TYPO3 10.1 you have to apply a patch to your TYPO3 sources at present.
Use the latest patch set for your TYPO3 version attached to the issue.
Alternatively you can use a patch included in this extension for convenience.
Quick guide to apply the patch
Instructions for applying a patch to the TYPO3 sources (german)
Without this patch TYPO3 is not able to create translations of label records having the same key as their related record in the default language.
Change Log
How to activate for BE users
- Enable admin panel for BE users.
1.1 Set
admPanel.enable.all = 1
in User TSconfig oradmPanel.enable.translatelabels = 1
1.2 Setconfig.admPanel = 1
in TypoScript Template - Login into BE and open FE afterward.
- Click on Settings in the bottom right of admin panel.
- Activate "Show translation labels" in settings and click on "Update settings".
- After that you will see all labels in FE underlined with a red dashed line having a tool tip with the link to the language file and its key.
- Furthermore, you will see a list of all used labels of the current page in Admin Panel in tab "Translate Labels".
Access rights to translate labels
Backend users who are allowed to create and edit translations need to have ...
- access rights to read and write records in the sysfolder for the
translations (set them in BE module
Access
) - BE user or group rights to list and modify records of table
Translation
(set them in BE moduleBackend-User
) - access to default language and to all languages
in which they are to translate labels. (set them in BE module
Backend-User
)
Internals
The extension overloads the f:translate fluid view helper and
renders a tag LLL:("<translation>","<key>")
for each label (only,
if you are logged in as BE user, otherwise the labels are rendered
as usual).
After all processing of frontend rendering the LLL: tags are transformed into HTML markup to display a dashed red line below each label with a tooltip showing the language file and the labels key. This also occurs only while being logged in as BE user.
Form Framework
This extension can be used to translate forms created with form editor including validation messages, labels, placeholders, descriptions etc. Therefore this extension overrides the following two view helpers of form framework:
- formvh:translateElementProperty
- formvh:translateElementError
Form framework uses special chaining of translations for elements. For further information have a look at: https://docs.typo3.org/c/typo3/cms-form/9.5/en-us/Concepts/FrontendRendering/Index.html#translation
This extension implements a simplified approach to override these translations:
You can only override the most specific translation of an element using
the path <formDefinitionIdentifier>.element.<elementIdentifier>.properties.<propertyName>
.
Examples:
- Translation of a label of a form field
registerForm.element.first-name.properties.label
- Translation of a description of a form field
registerForm.element.first-name.properties.description
- Translation of an option with value
value1
of a radio buttonregisterForm.element.radiobutton-1.properties.options.value1
- Translation of an option for a multi select checkbox with value
Second
register.element.multicheckbox-1.properties.options.Second
- Translation of the placeholder attribute
registerForm.element.text-1.properties.fluidAdditionalAttributes.placeholder
If a translation is defined for an element in the database then this will always take precedence over others defined in language files regardless of priority in the chain defined by form framework.
This behaviour is subject of change in the future.
Validation messages in Form Framework
If custom error messages are defined in form editor then only these messages are used for all languages and no translation chain takes place. This is default behaviour in form framework.
With this extension you can override these static values.
Example:
registerForm.validation.error.text-2.1428504122
Caching
The extension is completely compatible with TYPO3 caching mechanisms.
Caching is disabled if translation labels are activated in admin panel. This is because otherwise the markup showing the translation labels would be cached and delivered as content also for frontend users not being also logged in as backend users.
Old pi_base plugins
Due to API restrictions it is not possible to extend the old language
handling of plugins based on AbstractPlugin (a.k.a. pi_base plugins).
Instead each inherited class has to be extended directly via xclass.
This extension has an example for this for the plugin fe_login in
Classes/Plugin/FrontendLoginController.php
.
You can overload other pi_base plugins using the following code in your ext_localconf.php:
$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects']['TYPO3\\CMS\\Felogin\\Controller\\FrontendLoginController'] = array( 'className' => 'Sitegeist\\Translatelabels\\Plugin\\FrontendLoginController' );
Example for overriding language files
ext_localconf.php
// Examples for overriding language files $overrideLanguageFiles = [ 'default' => [ 'EXT:felogin/Resources/Private/Language/locallang.xlf' => 'felogin/felogin.xlf' ], 'de' => [ 'EXT:felogin/Resources/Private/Language/locallang.xlf' => 'felogin/de.felogin.xlf' ] ]; foreach ($overrideLanguageFiles as $language => $languageFiles) { foreach ($languageFiles as $originalLanguageFile => $overrideLanguageFile) { $GLOBALS['TYPO3_CONF_VARS']['SYS']['locallangXMLOverride'][$language][$originalLanguageFile][] = 'EXT:my_extension/Resources/Private/Language/Overrides/' . $overrideLanguageFile; } }
Note that my_extension
should be replaced with your extension key.
Run unit tests
$ cd typo3conf/ext/translatelabels
$ composer install
$ vendor/bin/phpunit -c vendor/typo3/testing-framework/Resources/Core/Build/UnitTests.xml Tests/Unit/Renderer/FrontendRendererTest.php