Attention
TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.
Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v11 here: TYPO3 ELTS.
Language
Contains Language resources.
See also
- Read more about localizing extensions: Localization
- Read more about the XLIFF format in the following chapter: XLIFF Format.
- Read more about applying localised labels in the following chapter: Working with XLIFF files.
In the folder EXT: language
files are stored in format .xlf.
This folder contains all language labels supplied by the extension in the default language English.
If the extension should provide additional translations into
custom languages, they can be stored in language files of the same name with a
language prefix. The German translation of the file locallang.
must be stored in the same folder in a file called de.,
the French translation in fr.. If the translations are
stored in a different file name they will not be found.
Any arbitrary file name with ending .xlf can be used.
The following file names are commonly used:
locallang.xlf
This file commonly contains translated labels to be used in the frontend.
In the templates of Extbase plugins all labels in the file
EXT: can
be accessed without using the complete path:
<f:translate key="key1" extensionName="MyExtension"/>From other template contexts the labels can be used by using the complete
LLL: path:
<f:translate key="LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:key1" />The documentation for the ViewHelper can be found at Translate ViewHelper <f:translate>.
Language labels to be used in PHP, TypoScript etc must also be prefixed with the complete path.
locallang_db.xlf
By convention, the file
EXT: should contain
all localized labels used for the TCA labels, descriptions etc.
These labels need to be always accessed by their complete path in the TCA configuration:
return [
'ctrl' => [
'title' => 'LLL:EXT:examples/Resources/Private/Language/locallang_db.xlf:tx_examples_dummy',
// ...
],
// ...
];