translate

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

Examples

Translate key:

<f:translate key="key1" />

value of key “key1” in the current website language

Keep HTML tags:

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

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" />

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')}

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')}

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" />

value of id “key1” in the current website language

Arguments

key (string)

Translation Key

id (string)

Translation Key compatible to TYPO3 Flow

default (string)

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

arguments (anySimpleType)

Arguments to be replaced in the resulting string

extensionName (string)

UpperCamelCased extension key (for example BlogExample)

languageKey (string)

Language key (&quot;dk&quot; for example) or &quot;default&quot; to use for this translation. If this argument is empty, we use the current language

alternativeLanguageKeys (anySimpleType)

Alternative language keys if no translation does exist