DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
TypoScript Reference¶
Property
useOneTreeMethod
Data type
boolean
Description
If true, the One-Tree-Method will be used, otherwise the Multiple- Trees concept is chosen.
See the manual for more information about these two concepts.
Default
1
Property
multipleTreesRootPages
Data type
array of isocodes
Description
When using the Multiple-Trees-Method, you have to define the different languages which are available throughout your website. You do that by using ISO codes for the languages and pointing them to the appropriate page id.
Example:
multipleTreesRootPages {
de = 216
en = 120
es = 482
}
Default
(see TypoScript file)
Property
defaultLang
Data type
string
Description
Set this to the ISO code of your default language (L=0)
plugin.tx_rlmplanguagedetection_pi1 {
defaultLang = de
}
Default
(empty)
Property
dontAddSchemeToURL
Data type
boolean
Description
When the URI is built for redirecting to a different page, the URL is parsed through a function which adds the correct scheme. I.e. 246.0.html?L=1 will be transformed to http://example.com/246.0.html?L=1
This behavior makes sense of course, but you might have a certain environment (some testing setup) where you want to disable this feature. In that case, set dontAddSchemeToURL to 1.
For most people it’s safe to leave setting as is.
Default
0
Property
useLanguageAliases
Data type
boolean
Description
Enables selecting preferred language from a list. E.g.: If user’s preference of Swedish language is not available, the script will test for languages from a customizable list of relatives.
Default
1
Property
languageAliases
Data type
array of strings
Description
Preferred language alternatives (iso 2 char codes). Feel free to suggest language preferences which can be included in future versions of this extension.
Example:
...
languageAliases {
no = dk,sv
dk = no,sv
sv = no,dk
}
To make this setting work also after the first page, remember to set this TypoScript:
config.sys\_language\_mode= content\_fallback; *{list}*
Where {list} is a comma separated list of the order in which you want languages to be tested, e.g.: 1,0 (tests for content translations in language UID 1 before 0)
Default
Property
dontBreakIfLanguageIsAlreadySelected
Data type
boolean
Description
If set, the script will still run if language is already selected. NB! May lead to infinite loop.
Default
0
Property
dontBreakIfLastPageWasOnSite
Data type
boolean
Description
If set, the script will still run if the referring page was on the same site. NB! May lead to infinite loop.
Default
0
Property
dontBreakIfLanguageAlreadySelected
Data type
boolean
Description
If set, the script will still run if the language detection has already been processed before.
Default
0
Property
testOrder
Data type
string
Description
Comma separated list of tests to run to find the user’s language.
- browser: Checks the browser’s language settings
- ip: Finds the language of the country of the IP address. First checks TypoScript countryCodeToLanguageCode, then static_info_tables’ lg_collate_language for a country code.
- And any hook value.
Default
browser,ip
Property
limitToLanguages
Data type
string
Description
Comma separated list of ISO 2 char language codes (e.g.: “en” or “en-us”) that are the only ones which should be considered. If left empty, this setting is ignored. This setting can be overruled by excludeLanguages.
Default
(empty)
Property
excludeLanguages
Data type
string
Description
Comma separated list of ISO 2 char language codes (e.g.: “en” or “en-us”) that should be excluded from being considered. If left empty, this setting is ignored. This setting has priority over limitToLanguages.
Default
(empty)
Property
allowedParams
Data type
string
Description
Comma separated list of allowed params to pass to the redirect. The parameters “id”, “MP”, and “type” are passed anyway.
Default
(empty)
Property
countryCodeToLanguageCode
Data type
array of strings
Description
Used by the IP country check. This list converts a country code into the preferred language code for users from that country.
Example:
...
countryCodeToLanguageCode {
us = en
gb = en
nz = en
}
Default
(see TypoScript)
Property
useOldOneTreeConcept
Data type
boolean
Description
Use the old One-Tree concept where the name of the Website Language records specifies the language code. Also should be used for TYPO3 version below 7.
Default
0
Property
languageGPVar
Data type
string
Description
The string to use for the language parameter in URLs.
Default
L
Property
dieAtEnd
Data type
boolean
Description
If redirection is required it is not performed, processing just stops (user will see empty screen instead of a page). If no redirection is required (e.g. language is explicitly specified in URL) all works as usual. This option can be used for debug purposes, never use it in production environment.
Default
0
Property
cookieLifetime
Data type
integer
Description
Lifetime (in seconds) of a cookie that stores selected language. If set to zero, TYPO3 session will be used as a storage. If set to something below zero, nothing will be stored and language will be detected each time user access the site.
Default
0
Property
pathToDatabaseForGeoIPData
Data type
string
Description
Path to the GeoIP database file, which must be stored locally. One free GeoIP database file can be found on the website of Maxmind. For more details look to the NetGeoIP.
Default
(empty)