TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,42 @@
+.. include:: /Includes.rst.txt
+
+.. _feature-82354:
+
+=======================================================================
+Feature: #82354 - Add possibility to get a label in a specific language
+=======================================================================
+
+See :issue:`82354`
+
+Description
+===========
+
+The extbase related LocalizationUtility now supports retrieving the localization
+of a key in a different language than the initialized language of the given user.
+This allows for instance rendering a text in french while the users language is
+german. This feature works in the frontend and backend of TYPO3 and supports
+to retrieve the labels via an extension name or an explicit specified
+`LLL:path/locallang.xlf:label` key.
+
+The ViewHelper :html:`<f:translate />` and the utility :php:`LocalizationUtility::translate()`
+do support now two new optional Parameters `languageKey` and `alternativeLanguageKeys`
+to control the output language.
+
+Hint: The `alternativeLanguageKeys` will be used "reversed" (this behaviour was not changed here but could be confusing).
+So if the `alternativeLanguageKeys` is defined with "fr,de", then "de" will used before "fr".
+
+
+Basic Usage
+===========
+
+.. code-block:: php
+
+    \TYPO3\CMS\Extbase\Utility\LocalizationUtility::translate('someKey', 'extensionName', [], 'da');
+
+
+.. code-block:: html
+
+   <f:translate key="someKey" languageKey="da" />
+
+
+.. index:: Fluid, PHP-API