1.3. Reference

TypoScript Reference

Property:

Data type:

Description:

Default:

useOneTreeMethod

boolean

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.

1

multipleTreesRootPages

array of isocodes

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

}

defaultLang

string

Set this to the ISO code of your default language (L=0)

plugin.tx_rlmplanguagedetection_pi1 {
   defaultLang = de

}

Please note: This setting may lead to redirect errors in some cases. See Known Problems.

dontAddSchemeToURL

boolean

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://yourhost.com/246.0.html?L=1.

This behavior makes sense of course, but you might have a certain enviroment (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.

0

useLanguageAliases

boolean

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.

1

languageAliases

array of strings

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)

no = dk,sv

dk = no,sv

sv = no,dk

dontBreakIfLanguageIsAlreadySelected

boolean

If set, the script will still run if language is already selected. NB! May lead to infinite loop.

0

dontBreakIfLastPageWasOnSite

boolean

If set, the script will still run if the referring page was on the same site. NB! May lead to infinite loop.

0

dontBreakIfLanguageAlreadySelected

boolean

If set, the script will still run if the language detection has already been  processed before.

0

testOrder

string

Comma separated list of tests to run to find the user's language.

  1. browser: Checks the browser's language settings

  2. 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.

  3. And any hook value.

browser,ip

limitToLanguages

string

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.

excludeLanguages

string

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.

countryCodeToLanguageCode

array of strings

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

}

(see TypoScript)

useOldOneTreeConcept

boolean

Use the old One-Tree concept where the name of the Website Language records specifies the language code.

0

languageGPVar

string

The string to use for the language parameter in URL's.

L

dieAtEnd

boolean

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.

0

cookieLifetime

integer

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.

0