Skip to main content

The glue between django-modeltranslation and wagtail

Project description

https://readthedocs.org/projects/django-modeltranslation-wagtail/badge/?version=latest https://badge.fury.io/py/django-modeltranslation-wagtail.png https://travis-ci.org/benjaoming/django-modeltranslation-wagtail.png?branch=master

The glue between django-modeltranslation and wagtail

Features

  • Field-based translation for Wagtail using django-modeltranslation

  • TODO Makes translated fields easily accessible to the Wagtail admin.

  • Sensible to the currently activated language.

When to use this

Actually, you might not want to use this! Consider carefully to use wagtail-modeltranslation as it has substantially improved by not hard-copying django-modeltranslation anymore. They are still pretty bad at responding to external contributions, though.

If you need to have 1:1 translation for Pages or Snippets in Wagtail, you could use django-modeltranslation.

Having another translation mechanism such as what wagtailtrans describes as freeform trees is not a problem.

If you ONLY plan to use one kind of translation mechanism, you should also carefully consider wagtailtrans. This project is really nice if you have already used other approaches and want to mix both what wagtailtrans calls freeform and synchronized trees.

Background

Originally, I was using wagtail-modeltranslation. The project has been sparsely maintained, but more seriously, it was monkey-patching Wagtail and using a hard-copy of the modeltranslation codebase instead of a dependency reference to django-modeltranslation. The latter has now been restored, which as lowered the motivation for this project.

This project introduces a bit of naming hell. But remember it like this: django-modeltranslation-wagtail has wagtail at the end because it depends on django-modeltranslation, which depends on django.

Using django-modeltranslation or wagtail-modeltranslation?

Switching is easy!

Since this project is directly based on django-modeltranslation, the creation of fields in the database and django migrations remains the same. In case you are switching, just revisit your translation.py files and change the imports to point to modeltranslation_wagtail.

Documentation

The full documentation is at http://modeltranslation_wagtail.rtfd.org.

History

0.2.0 (2017-12-17)

  • Do not translate URL slugs for now, it breaks and needs a more patching in order to work.

0.1.0 (2017-01-20)

  • First release on PyPI.

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

django-modeltranslation-wagtail-0.2.1.tar.gz (18.3 kB view hashes)

Uploaded Source

Built Distribution

django_modeltranslation_wagtail-0.2.1-py2.py3-none-any.whl (6.2 kB view hashes)

Uploaded Python 2 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