==========================
Django Translatable Fields
==========================
Translatable model fields for Django with admin integration. Uses PostgreSQL JSONField.
Installation
============
* Add application in `settings.py`
.. code:: python
INSTALLED_APPS = (
...
'translatable_fields',
...
)
* Specify languages in `settings.py`
.. code:: python
# Internationalization
LANGUAGE_CODE = 'en'
LANGUAGES = (
('en', 'English'),
('ru', 'Русский')
)
* Add `TranslatableField` model fields
.. code:: python
from django.db import models
from django.utils.translation import ugettext_lazy as _
from translatable_fields.models import TranslatableField
class Position(models.Model):
...
title = TranslatableField(
verbose_name=_('title')
)
description = TranslatableField(
verbose_name=_('description')
)
...
* Create custom model admin form
.. code:: python
from django import forms
from django.contrib.postgres.forms import JSONField
from ckeditor_uploader.widgets import CKEditorUploadingWidget
from careers.models.position import Position
from translatable_fields.widgets import TranslatableWidget
class PositionAdminForm(forms.ModelForm):
title = JSONField(widget=TranslatableWidget(widget=forms.TextInput))
description = JSONField(widget=TranslatableWidget(widget=CKEditorUploadingWidget))
class Meta:
model = Position
fields = (
...
'title',
'description',
...
)
* Create custom model admin with custom form
.. code:: python
from django.contrib import admin
from careers.forms.admin.position import PositionAdminForm
class PositionAdmin(admin.ModelAdmin):
form = PositionAdminForm
