Translations
Forms for creating, modifying and configuring machine translations
Translations Management Form
- class integreat_cms.cms.forms.translations.translations_management_form.CustomCheckboxSelectMultiple(attrs=None, choices=())[source]
Bases:
CheckboxSelectMultiple
Custom CheckboxSelectMultiple child class which appends a machine translation provider to option labels or disables them if no provider is available
- id_for_label(id_, index=None)[source]
Don’t include for=”field_0” in <label> to improve accessibility when using a screen reader, in addition clicking such a label would toggle the first input.
- subwidgets(name, value, attrs=None)[source]
Yield all “subwidgets” of this widget. Used to enable iterating options from a BoundField for choice widgets.
- template_name: str = 'translations/languages_input.html'[source]
The template to use when rendering this widget
- class integreat_cms.cms.forms.translations.translations_management_form.TranslationLanguageOptions(language_tree_node: LanguageTreeNode)[source]
Bases:
object
Helper class to easily provide the translation providers for a language for form fields.
- Parameters:
language_tree_node (LanguageTreeNode)
- __init__(language_tree_node: LanguageTreeNode) None [source]
- Parameters:
language_tree_node (LanguageTreeNode)
- Return type:
None
- property choices: list[tuple[str, str]][source]
mt_providers
as list of tuples fordjango.forms.ChoiceField.choices
- language_tree_node: LanguageTreeNode[source]
- property providers: dict[str, MachineTranslationProviderType][source]
mt_providers
as a dict, indexed byname
- class integreat_cms.cms.forms.translations.translations_management_form.TranslationsManagementForm(*args: Any, **kwargs: Any)[source]
Bases:
CustomModelForm
Form for modifying machine translation settings of a region
Form fields:
machine_translate_pages
: Pages (TypedChoiceField
)machine_translate_events
: Events (TypedChoiceField
)machine_translate_pois
: Locations (TypedChoiceField
)
- Parameters:
args (Any)
kwargs (Any)
- __init__(*args: Any, **kwargs: Any) None [source]
Initialize translations management form
- Parameters:
*args (Any) – The supplied arguments
**kwargs (Any) – The supplied keyword arguments
- Return type:
None
- add_error(field, error)[source]
Update the content of self._errors.
The field argument is the name of the field to which the errors should be added. If it’s None, treat the errors as NON_FIELD_ERRORS.
The error argument can be a single error, a list of errors, or a dictionary that maps field names to lists of errors. An “error” can be either a simple string or an instance of ValidationError with its message attribute set and a “list or dictionary” can be an actual list or dict or an instance of ValidationError with its error_list or error_dict attribute set.
If error is a dictionary, the field argument must be None and errors will be added to the fields that correspond to the keys of the dictionary.
- add_error_messages(request: HttpRequest) None [source]
This function accepts the current request and adds the form’s error messages to the message queue of
django.contrib.messages
.- Parameters:
request (HttpRequest) – The current request submitting the form
- Return type:
None
- add_initial_prefix(field_name)[source]
Add an ‘initial’ prefix for checking dynamic initial values.
- add_prefix(field_name)[source]
Return the field name with a prefix appended, if this Form has a prefix set.
Subclasses may wish to override.
- clean() dict[str, Any] [source]
This method extends the default
clean()
-method of the baseModelForm
to provide debug logging- Returns:
The cleaned data (see Overriding the clean() method)
- Return type:
- get_error_messages() list[dict[str, str]] [source]
Return all error messages of this form and append labels to field-errors
- get_initial_for_field(field, field_name)[source]
Return initial data for field on form. Use initial data from the form or the field, in that order. Evaluate callable values.
- get_language_fields() Iterator[forms.ChoiceField] [source]
Generator for a
django.forms.ChoiceField
for each language with the available translation providers- Return type:
Iterator[forms.ChoiceField]
Return a list of all the BoundField objects that are hidden fields. Useful for manual form layout in templates.
- is_multipart()[source]
Return True if the form needs to be multipart-encoded, i.e. it has FileInput, or False otherwise.
- non_field_errors()[source]
Return an ErrorList of errors that aren’t associated with a particular field – i.e., from Form.clean(). Return an empty ErrorList if there are none.
- order_fields(field_order)[source]
Rearrange the fields according to field_order.
field_order is a list of field names specifying the order. Append fields not included in the list in the default order for backward compatibility with subclasses not overriding field_order. If field_order is None, keep all fields in the order defined in the class. Ignore unknown fields in field_order to allow disabling fields in form subclasses without redefining ordering.
- save(commit: bool = True) Region [source]
This method extends the default
save()
-method of the baseModelForm
to set attributes which are not directly determined by input fields.
The languages that cannot be selected at the moment