create_translations_model(model, related_name, meta, **fields)¶
A model factory used to create the Translations Model. Makes sure that the unique_together option on the options (meta) contain
('language_code', 'master')as they always have to be unique together. Sets the
masterforeign key to model onto the Translations Model as well as the
language_codefield, which is a database indexed char field with a maximum of 15 characters.
Returns the new model.
A wrapper for the translated fields which is set onto
TranslatableModelsubclasses to define what fields are translated.
Internally this is just used because Django calls the
contribute_to_class()method on all attributes of a model, if such a method is available.
A model which has translated fields on it. Must define one and exactly one attribute which is an instance of
TranslatedFields. This model is abstract.
If initalized with data, it splits the shared and translated fields and prepopulates both the Shared Model and the Translations Model. If no language_code is given,
get_language()is used to get the language for the Translations Model instance that gets initialized.
When initializing a
TranslatableModel, positional arguments are only supported for the shared fields.
A list of field on the Shared Model.
save_translations(cls, instance, **kwargs)¶
This classmethod is connected to the model’s post save signal from
prepare_translatable_model()and saves the cached translation if it’s available.
Initializes a new instance of the Translations Model (does not check the database if one for the language given already exists) and sets it as cached translation. Used by end users to translate instances of a model.
safe_translation_getter(self, name, default=None)¶
Helper method to safely get a field from the Translations Model.
lazy_translation_getter(self, name, default=None)¶
Helper method to get the cached translation, and in the case the cache for some reason doesnt exist, it gets it from the database.
Returns a list of language codes in which this instance is available.