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

...

enabled

required , default is true

Enables multilanguage content entry.

class

required

A class that implements

Javadoc
0info.magnolia.ui.api.i18n.I18NAuthoringSupport
rangeHigherVersion5.5
classNameinfo.magnolia.ui.api.i18n.I18NAuthoringSupport
renderTypeasynchronous
such as:

  • info.magnolia.ui.framework.i18n.DefaultI18NAuthoringSupport supports multilanguage content entry for one site.
  • info.magnolia.multisite.i18n.MultiSiteI18nAuthoringSupport supports multilanguage content entry 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.

...

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.

...