.. _localization: ============ Localization ============ Language files ============== The main language file is :file:`Resources/Private/Language/locallang.xlf`. See `Translation files (XLIFF format) `_ . Use the TYPO3 back end to install the available translations. Activate languages ------------------ You must activate your languages for TYPO3. See `languages `_ . Adapting labels --------------- You can adapt the labels in the extension file :file:`Resources/Private/Language/locallang.xlf` to to your needs and languages. Any label may be overridden by inserting the appropriate assignment in your TS template setup: :typoscript:`plugin.tx_agency._LOCAL_LANG.languageCode.labelName = overridingValue` You can find the name of the label (languageCode) you want to modify (or translate) by inspecting this file. Overriding labels specified in TCA ----------------------------------- You may also override by the same method labels from other files when they are referenced by the TCA definition of a field (see the tutorial section on adding fields to the registration form). This is done as follows: :typoscript:`plugin.tx_agency._LOCAL_LANG.languageCode.tableName.fieldName = overridingValue` Switching salutation mode ------------------------- You may also switch the salutation mode used in these labels when this is relevant for the language being used and when the labels are either available in the file :file:`Resources/Private/Language/locallang.xlf` or provided by TypoScript setup. See the TypoScript Reference section. :php:`v_dear_male` or :php:`v_dear_female` markers will be used instead of :php:`v_dear` if a gender has been entered by the user. Localization of user group title -------------------------------- This extension adds the table :php:`fe_groups_language_overlay` in order to allow localization of the user group title. en_US localization ------------------ If the language is set to :php:`en_US` in the site configuration for languages, labels localized to US English will be used in the front end. If not available, default (en_GB) labels will be used. Labels with variables --------------------- Some labels in :file:`Resources/Private/Language/locallang.xlf` have names starting with :php:`v_`. In those labels, the following variables may be used: * :php:`%1$s` : the title of the pid containing the front end user records created by the extension; * :php:`%2$s` : the user name of the front end user; * :php:`%3$s` : the name of the front end user; * :php:`%4$s` : the email address of the front end user. * :php:`%5$s` : the password of the front end user. Special functions can be inserted. They will be replaced by the result of the function. * :php:`{data:}`: value of this field of the FE user record * :php:`{tca:}`: value of the marker :php:`###TCA_INPUT_field'###` * :php:`{meta:}`: extra stuff functions: :php:`title: page title` Adding extra labels --------------------- Property :typoscript:`extraLabels` in TS setup may specify a list of extra labels that may be used in the HTML template. The values of these labels are specified in TS setup with the same type of assignment as when overriding localized labels: :typoscript:`plugin.tx_agency._LOCAL_LANG.languageCode.extraLabelName = extraLabelValue`