Added available languages for models

docs/modeltranslation/registration.rst

@@ -127,6 +127,40 @@ the translated field ``image`` to the ``NewsWithImage`` model.
     inheritance` broke the project (if you had always subclassed
     ``TranslationOptions`` only, there is no risk).
 
+.. versionadded:: 0.19.0
+
+If you need to specify the languages available for each model, you can do so using the ``languages``
+argument::
+
+    from modeltranslation.translator import translator, TranslationOptions
+    from news.models import News, NewsWithImage
+
+    class NewsTranslationOptions(TranslationOptions):
+        fields = ('title', 'text',)
+
+    class NewsWithImageTranslationOptions(TranslationOptions):
+        fields = ('image',)
+
+    translator.register(
+        News, NewsTranslationOptions,
+        languages=('en','uk')
+    )
+    translator.register(NewsWithImage, NewsWithImageTranslationOptions)
+
+
+In this case, for the ``News`` model, translations will be available in the languages with the codes
+``en`` and ``uk``.
+For the ``NewsWithImage`` model, since the ``languages`` argument was not passed, the value from
+``settings.MODELTRANSLATION_LANGUAGES`` will be used.
+
+Also, if you wish, you can pass the ``languages`` argument in the ``register`` decorator::
+
+    from modeltranslation.translator import register, TranslationOptions
+    from news.models import News
+
+    @register(News, languages=('en','uk'))
+    class NewsTranslationOptions(TranslationOptions):
+        fields = ('title', 'text',)
 
 Changes Automatically Applied to the Model Class
 ------------------------------------------------

modeltranslation/translator.py

@@ -157,7 +157,8 @@ def add_translation_fields(model, opts):
     model_empty_values = getattr(opts, 'empty_values', NONE)
     for field_name in opts.local_fields.keys():
         field_empty_value = parse_field(model_empty_values, field_name, NONE)
-        for lang in mt_settings.AVAILABLE_LANGUAGES:
+        available_languages = getattr(opts, 'languages', mt_settings.AVAILABLE_LANGUAGES)
+        for lang in available_languages:
             # Create a dynamic translation field
             translation_field = create_translation_field(
                 model=model, field_name=field_name, lang=lang, empty_value=field_empty_value
@@ -664,6 +665,5 @@ def lazy_operation(self, func: Callable, *args, **kwargs) -> None:
 # This global object represents the singleton translator object
 translator = Translator()
 
-
 # Re-export the decorator for convenience
 from modeltranslation.decorators import register  # NOQA re-export