mirror of
https://github.com/Hopiu/wagtail-modeltranslation.git
synced 2026-05-11 08:43:11 +00:00
100 lines
2.9 KiB
ReStructuredText
Executable file
100 lines
2.9 KiB
ReStructuredText
Executable file
================
|
|
Wagtail Modeltranslation
|
|
================
|
|
|
|
This app is based on django-modeltranslation: https://github.com/deschler/django-modeltranslation
|
|
|
|
It's an alternative approach for i18n support on Wagtail CMS websites.
|
|
|
|
The modeltranslation application is used to translate dynamic content of
|
|
existing Wagtail models to an arbitrary number of languages, without having to
|
|
change the original model classes. It uses a registration approach (comparable
|
|
to Django's admin app) to add translations to existing or new projects and is
|
|
fully integrated into the Wagtail admin UI.
|
|
|
|
The advantage of a registration approach is the ability to add translations to
|
|
models on a per-app basis. You can use the same app in different projects,
|
|
whether or not they use translations, and without touching the original
|
|
model class.
|
|
|
|
|
|
.. image:: https://github.com/infoportugal/wagtail-modeltranslation/blob/master/screenshot.png?raw=true
|
|
:target: https://github.com/infoportugal/wagtail-modeltranslation/blob/master/screenshot.png?raw=true
|
|
|
|
|
|
Features
|
|
========
|
|
|
|
- Add translations without changing existing models or views
|
|
- Translation fields are stored in the same table (no expensive joins)
|
|
- Supports inherited models (abstract and multi-table inheritance)
|
|
- Handle more than just text fields
|
|
- Wagtail admin integration
|
|
- Flexible fallbacks, auto-population and more!
|
|
- Default Page model fields has translatable fields by default
|
|
- StreamFields are now supported!
|
|
|
|
|
|
Quick start
|
|
-----------
|
|
|
|
1. Install :code:`wagtail-modeltranslation`::
|
|
|
|
pip install wagtail-modeltranslation
|
|
|
|
2. Add "wagtail_modeltranslation" to your INSTALLED_APPS setting like this (before all apps that you want to translate)::
|
|
|
|
INSTALLED_APPS = (
|
|
...
|
|
'wagtail_modeltranslation',
|
|
)
|
|
|
|
3. Add "django.middleware.locale.LocaleMiddleware" to MIDDLEWARE_CLASSES on your settings.py::
|
|
|
|
MIDDLEWARE_CLASSES = (
|
|
...
|
|
'django.middleware.locale.LocaleMiddleware',
|
|
)
|
|
|
|
4. Enable i18n on settings.py::
|
|
|
|
USE_I18N = True
|
|
|
|
5. Define available languages on settings.py::
|
|
|
|
LANGUAGES = (
|
|
('pt', u'Português'),
|
|
('es', u'Espanhol'),
|
|
('fr', u'Francês'),
|
|
)
|
|
|
|
6. Create translation.py inside the root folder of the app where the model you want to translate exists::
|
|
|
|
from .models import Foo
|
|
from wagtail_modeltranslation.translator import TranslationOptions
|
|
from wagtail_modeltranslation.decorators import register
|
|
|
|
|
|
@register(Foo)
|
|
class FooTR(TranslationOptions):
|
|
fields = (
|
|
'body',
|
|
)
|
|
|
|
7. Add :code:`TranslationMixin` to your translatable model::
|
|
|
|
from wagtail_modeltranslation.models import TranslationMixin
|
|
|
|
class FooModel(TranslationMixin, Page):
|
|
body = StreamField(...)
|
|
|
|
8. Run :code:`python manage.py makemigrations` followed by :code:`python manage.py migrate`
|
|
|
|
|
|
Project Home
|
|
------------
|
|
https://github.com/infoportugal/wagtail-modeltranslation
|
|
|
|
Documentation
|
|
-------------
|
|
Coming soon
|