Skip to main content

Translation plugin for Wagtail CMS

Project description

Wagtail localize

Supported versions:

Python: 3.7 and 3.8 Django: 2.2, 3.0 and 3.1 Wagtail: 2.11

Installation and setup

Install with pip:

pip install wagtail-localize

Settings modifications

Add wagtail_localize and wagtail_localize.locales to INSTALLED_APPS in settings/base.py:

INSTALLED_APPS = [
    ...
    "wagtail_localize",
    "wagtail_localize.locales",  # Note: This replaces "wagtail.locales"
    ...
]

Add the following to MIDDLEWARE:

"django.middleware.locale.LocaleMiddleware",

Ensure your settings file has:

LANGUAGE_CODE = "en-gb"  # Or your preferred default language
USE_I18N = True

Add to following to your settings specifying any languages you would like to translate:

LANGUAGES = [
    ("en", "English"),
    ("fr", "French"),
]

To enable DeepL as a machine translator, add the following to your settings:

WAGTAILLOCALIZE_MACHINE_TRANSLATOR = {
    'CLASS': 'wagtail_localize.machine_translators.deepl.DeepLTranslator',
    'OPTIONS': {
        'AUTH_KEY': '<Your DeepL key here>',
    }
}

URL configuration

The following additions need to be made to ./yoursite/urls.py

from django.conf.urls.i18n import i18n_patterns
...

urlpatterns += i18n_patterns(
    url(r"^search/$", search_views.search, name="search"),
    url(r"", include(wagtail_urls)),
)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wagtail-localize-0.9.4.tar.gz (162.0 kB view hashes)

Uploaded Source

Built Distribution

wagtail_localize-0.9.4-py3-none-any.whl (248.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page