Multilingual

Multilingual#

Volto provides support for Plone's multilingual feature through the Plone core add-on plone.app.multilingual. It is included with Plone 5 and later. You can enable it through the Add-ons control panel in the administrative interface.

Volto configuration#

Multilingual configuration in Volto depends on its version.

Volto 19 and later#

In Volto 19 and later, both the default language and available languages are defined in the Plone site configuration. A site administrator can configure these values in the Languages control panel in Site Setup. A developer can configure them using GenericSetup.

Changed in version Volto: 19

Use multilingual configuration from the backend, instead of Volto config settings for the frontend.

Volto 18 and earlier#

Removed in version Volto: 19

The environment variable SITE_DEFAULT_LANGUAGE was removed in Volto 19.

In Volto 18 and earlier, enable the multilingual feature in Volto's configuration settings.

import config from '@plone/volto/registry'

config.settings = {
  ...config.settings,
  isMultilingual: true,
  supportedLanguages: ['en', 'de', 'ca', 'pt-br'],
  defaultLanguage: 'en'
}

Declare the language you want to support in your site in the supportedLanguages array, and which is the default language of your site.

Warning

The default language and the supported languages must match those set in the Plone backend. Those should be set either using GenericSetup using your policy package or manually via the Languages control panel. Examples include en for English, or pt-br for Portuguese (Brazil).

Features#

Volto multilingual includes the following features.

  • language detector that detects the language preference from a cookie, and redirects to the related language root folder

  • language switcher that allows the user to switch between languages

  • adds menu entries that allows to create and link a new content item with the original one in one of the supported languages set in the site

  • when users use the language switcher to change the language from a translated content, they are redirected to the linked content within the same translation group

  • manually link two objects via the Manage translations link under the More menu

  • manually delete a link (or unlink) between two objects (Manage translations link under the More menu)

Contents