Versions Compared

Old Version 2

changes.mady.by.user Martin Drápela

Saved on

compared with

New Version Current

changes.mady.by.user Richard Gange

Saved on

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.

...

When you select a language from the dropdown, dialogs show a language identifier such as fr next to field labels. This makes it clear what language editors should be entering.(warning) The

Info
The language identifier is not displayed for the fallback locale, unless the i18n property is set to true in the definition of the given dialog. For example, if your fallback locale is English you won't see (en) next to the field label.

Info

Displaying the locale dropdown and a locale identifier in the dialog is Magnolia's default way to let editors choose a language. You can implement your own alternative such as separate tabs for each language. If the number of supported languages is not very large (3-4) tabs work well. The default approach works with any number of languages while keeping UI changes minimal.

...

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.

...