translate

Translate a key from locallang. The files are loaded from the folder “Resources/Private/Language/”.

Examples

Translate key:

<f:translate key="key1" />

Output:

value of key "key1" in the current website language

Keep HTML tags:

<f:format.raw><f:translate key="htmlKey" /></f:format.raw>

Output:

value of key "htmlKey" in the current website language, no htmlspecialchars applied

Translate key from custom locallang file:

<f:translate key="LLL:EXT:myext/Resources/Private/Language/locallang.xlf:key1" />

Output:

value of key "key1" in the current website language

Inline notation with arguments and default value:

{f:translate(key: 'argumentsKey', arguments: {0: 'dog', 1: 'fox'}, default: 'default value')}

Output:

value of key "argumentsKey" in the current website language

with “%1” and “%2” are replaced by “dog” and “fox” (printf) if the key is not found, the output is “default value”

Inline notation with extension name:

{f:translate(key: 'someKey', extensionName: 'SomeExtensionName')}

Output:

value of key "someKey" in the current website language

the locallang file of extension “some_extension_name” will be used

Translate id as in TYPO3 Flow:

<f:translate id="key1" />

Output:

value of id "key1" in the current website language

Arguments

key

DataType
string
Required
true
Description
Translation Key

id

DataType
string
Required
true
Description
Translation Key compatible to TYPO3 Flow

default

DataType
string
Required
true
Description
If the given locallang key could not be found, this value is used. If this argument is not set, child nodes will be used to render the default

htmlEscape

DataType
mixed
Required
true
Description
TRUE if the result should be htmlescaped. This won’t have an effect for the default value

arguments

DataType
mixed
Required
true
Description
Arguments to be replaced in the resulting string

extensionName

DataType
string
Required
true
Description
UpperCamelCased extension key (for example BlogExample)