README.rst

Django Translatable Fields

Translatable model fields for Django with admin integration. Uses PostgreSQL JSONField.

Installation

• Add application in settings.py

INSTALLED_APPS = (
    ...
    'translatable_fields',
    ...
)

• Specify languages in settings.py

# Internationalization

LANGUAGE_CODE = 'en'
LANGUAGES = (
    ('en', 'English'),
    ('ru', 'Русский')
)

• Add TranslatableField model fields

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

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

from django.contrib import admin

from careers.forms.admin.position import PositionAdminForm


class PositionAdmin(admin.ModelAdmin):
    form = PositionAdminForm