Skip to content

wagtail-translation adds translation capabilities to Wagtail CMS by using django-modeltranslation.

License

Notifications You must be signed in to change notification settings

statesofpop/wagtail-translation

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wagtail-translation

wagtail-translation adds translation capabilities to Wagtail CMS by using django-modeltranslation. The aim is to have a very clean implementation of single-tree Wagtail translations. This project was inspired by wagtail-modeltranslation because it is unnecessarily messy and not very maintainable.

Installation

  1. Add wagtail_translation and modeltranslation to INSTALLED_APPS in your settings. wagtail_translation must appear before any apps with subclassed Page models in the list.

  2. Define languages used for translations (see modeltranslation docs).

  3. Define and register TranslationOptions classes for every Page model. If said models don't have any additional fields to be translated, they still have to be registered with empty TranslationOptions.

  4. Run ./manage.py migrate.

    TBD: additional actions to install in preexisting projects (which had migrations run before)

    TBD: additional actions when translation languages are changed after running wagtail-translation migration

  5. If you have custom managers on your Page submodels, make sure that such managers inherit from wagtail_translation.manager.MultilingualPageManager.

Dependencies and versions

Dependency Versions
wagtail >=1.8,<1.12
django-modeltranslation >=0.12
django >=1.8,<2.0

Configuration

  1. Include wagtail urls with i18n_patterns
  2. Add LocaleMiddleware to middleware list in your settings.

About

wagtail-translation adds translation capabilities to Wagtail CMS by using django-modeltranslation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 94.9%
  • HTML 3.3%
  • JavaScript 1.8%