Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

System languages are configured in Configuration > /server/i18n/system. Each locale has a language and country properties that define the locale when combined. This allows you to define regional variations such as zh_TW for traditional Chinese or pt_BR for Brazilian Portuguese.

Note

Please take note of the supported locales for your version of Java (JDK 8 and JRE 8 Supported Locales).

Advanced Tables - Table Plus
heading0
enableHeadingAttributesfalse
enableSortingfalse
classm5-configuration-tree
enableHighlightingfalse
Node nameValue

Mgnl f
i18n


 

Mgnl n
system


Mgnl n
languages


Mgnl n
zh_TW


Mgnl p
country      

TW

Mgnl p
enabled

true

Mgnl p
language

zh

Mgnl n
pt_BR


Mgnl n
de


Mgnl n
fr


Mgnl p
fallbackLanguage

en

...

locales

required

<locale>

required

Locale name constructed from the language and country such as zh_TW for traditional Chinese or pt_BR for Brazilian Portuguese.

enabled

optional , default is false

Enables the locale.

language

required

Language code such as pt for Portuguese. See Java locale notation .

country

optional

Country code such as BR for Brazil. See Java locale notation.

class

required

Class that implements

Javadoc
0info.magnolia.cms.i18n.I18nContentSupport
rangeHigherVersion5.5
classNameinfo.magnolia.cms.i18n.I18nContentSupport
renderTypeasynchronous
such as:

  • info.magnolia.cms.i18n.DefaultI18nContentSupport which supports a language prefix such as /en/* in the URL and stores localized content in a node using the naming pattern <name>_<locale>, for example subtitle_en.
    Use this implementation if your site is organized into a single tree, in which the locale prefix usually points to the root of a site.

  • info.magnolia.cms.i18n.HierarchyBasedI18nContentSupport which stores and serves localized content in a hierarchical structure.
    Use this implementation if your site is organized into multiple trees, in which site roots are usually named after the locales.

  • info.magnolia.cms.i18n.RequestLocaleAwareI18nContentSupport which reads the locale from the request. This implementation does not render language specific URLs.

enabled

optional , default is false

Enables support for localized content. Used to rewrite URIs and getting nodes based on the current language.

fallbackLocale

optional , default is en

Content is served for the fallback locale if content is not available for the current locale.

...

enabled

required , default is true

Enables multilanguage content storage and delivery.

class

required

A class that implements

Javadoc
0info.magnolia.cms.i18n.I18nContentSupport
rangeHigherVersion5.5
classNameinfo.magnolia.cms.i18n.I18nContentSupport
renderTypeasynchronous
such as:

  • info.magnolia.cms.i18n.DefaultI18nContentSupport supports multilanguage content for one site.
  • info.magnolia.multisite.i18n.MultiSiteI18nContentSupport supports multilanguage content for many sites (EE Pro). This class reads the available locales (languages) from the site definitions. So you need to define them for each site.

...