Installation guide
Before you start, follow Wagtail's configuration guide to enable internationalisation in Wagtail and Django.
Install the Python package
Firstly install wagtial-localize
Python package.
If you are using pip
, use the following command:
pip install wagtail-localize
Add to INSTALLED_APPS
Now add wagtail_localize
to your INSTALLED_APPS
setting:
INSTALLED_APPS = [
# ...
"wagtail_localize",
# ...
]
Enabling the "Sync from" field (optional)
Wagtail Localize has a feature that allows you to automatically synchronise language trees. This means that any new pages created in a source language are automatically created as an alias in another language.
The locales that are synchronised from others can be managed through the Wagtail admin interface.
To enable this, replace the "wagtail.locales"
entry in INSTALLED_APPS
with "wagtail_localize.locales"
, this
will add a "Sync from" field to all locales that allows an administrator to choose a locale to synchronise content from.
Disabling the default translation mode
Wagtail Localize will automatically go in translation mode when creating new translations for models.
To disable this behaviour globally, set WAGTAIL_LOCALIZE_DEFAULT_TRANSLATION_MODE = "simple"
in your settings file.
If you wish to disable it per page or model type, set the localize_default_translation_mode
attribute to "simple"
on your model. The default value is synced
.
e.g.
class MyPage(Page):
localize_default_translation_mode = "simple"
# ...