Language Tree

This package contains all views related to the language tree of a region

Language Tree Actions

This module contains view actions for the language tree. Typically, they do not render a whole page, but only parts of it or they redirect to regular views.

integreat_cms.cms.views.language_tree.language_tree_actions.delete_language_tree_node(request: HttpRequest, region_slug: str, pk: int) → HttpResponseRedirect

Deletes the language node of distinct region and all page translations for this language

Parameters:

• request (HttpRequest) – The current request

• region_slug (str) – The slug of the region which language node should be deleted

• pk (int) – The id of the language tree node which should be deleted

Returns:

A redirection to the language tree

Return type:

HttpResponseRedirect

integreat_cms.cms.views.language_tree.language_tree_actions.manually_invalidate_models(region: Region) → None

This is a helper function to iterate through all affected objects and invalidate their cache. This is necessary as the original cache invalidation of cacheops only triggers for direct foreign key relationships.

Parameters:

region (Region) – The affected region

Return type:

None

integreat_cms.cms.views.language_tree.language_tree_actions.move_language_tree_node(request: HttpRequest, region_slug: str, pk: int, target_id: int, target_position: str) → HttpResponseRedirect

This action moves the given language tree node to the given position relative to the given target.

Parameters:

• request (HttpRequest) – The current request

• region_slug (str) – The slug of the region which language tree should be modified

• pk (int) – The id of the language tree node which should be moved

• target_id (int) – The id of the target language tree node

• target_position (str) – The desired position (choices: position)

Returns:

A redirection to the language tree

Return type:

HttpResponseRedirect

Language Tree Bulk Actions

class integreat_cms.cms.views.language_tree.language_tree_bulk_actions.BulkActivateView(**kwargs)

Bases: LanguageTreeBulkActionView

Bulk action for activating multiple language tree nodes at once

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

action = 'activated'

The name of the action

allow_empty = True

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

context_object_name = None

delete(request, *args, **kwargs)

dispatch(request, *args, **kwargs)

extra_context = None

field_name = 'active'

The name of the archived-field

get(request, *args, **kwargs)

get_allow_empty()

Return True if the view should display empty lists and False if a 404 should be raised instead.

get_context_data(*, object_list=None, **kwargs)

Get the context for this view.

get_context_object_name(object_list)

Get the name of the item to be used in the context.

get_extra_filters() → Q

Get extra filters for get_queryset(). Overwrite this method to specify needed filters e.g. as in ~integreat_cms.cms.views.contact.contact_bulk_actions

Returns:

Q Object to be used as filter argument

Return type:

Q

get_login_url()

Override this method to override the login_url attribute.

get_ordering()

Return the field or fields to use for ordering the queryset.

get_paginate_by(queryset)

Get the number of items to paginate by, or None for no pagination.

get_paginate_orphans()

Return the maximum number of orphans extend the last page by when paginating.

get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs)

Return an instance of the paginator for this view.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_queryset() → Any

Get the queryset of selected items for this bulk action

Raises:

Http404 – HTTP status 404 if no objects with the given ids exist

Returns:

The QuerySet of the filtered links

Return type:

Any

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_redirect_url(*args: Any, **kwargs: Any) → str

Retrieve url for redirection

Parameters:

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

url to redirect to

Return type:

str

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

head(request, *args, **kwargs)

http_method_names: list[str] = ['post']

The list of HTTP method names that this view will accept. The bulk action form uses only POST as submission method.

http_method_not_allowed(request, *args, **kwargs)

login_url = None

model

alias of LanguageTreeNode

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

ordering = None

page_kwarg = 'page'

paginate_by = None

paginate_orphans = 0

paginate_queryset(queryset, page_size)

Paginate the queryset, if needed.

paginator_class

alias of Paginator

patch(request, *args, **kwargs)

pattern_name = None

permanent = False

permission_denied_message = ''

permission_required = None

post(request: HttpRequest, *args: Any, **kwargs: Any) → HttpResponseRedirect

Execute bulk action for language tree node and flush the cache

Parameters:

• request (HttpRequest) – The current request

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

The redirect

Return type:

HttpResponseRedirect

prefetch_public_translations: bool = False

Whether the public translation objects should be prefetched

prefetch_translations: bool = False

Whether the translation objects should be prefetched

put(request, *args, **kwargs)

query_string = False

queryset = None

raise_exception = False

redirect_field_name = 'next'

require_change_permission: bool = True

Whether the view requires change permissions

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

url = None

value: bool = True

The value of the field (defaults to True)

view_is_async = False

class integreat_cms.cms.views.language_tree.language_tree_bulk_actions.BulkDisableView(**kwargs)

Bases: BulkActivateView

Bulk action for disabling multiple language tree nodes at once

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

action = 'disabled'

The name of the action

allow_empty = True

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

context_object_name = None

delete(request, *args, **kwargs)

dispatch(request, *args, **kwargs)

extra_context = None

field_name = 'active'

The name of the archived-field

get(request, *args, **kwargs)

get_allow_empty()

Return True if the view should display empty lists and False if a 404 should be raised instead.

get_context_data(*, object_list=None, **kwargs)

Get the context for this view.

get_context_object_name(object_list)

Get the name of the item to be used in the context.

get_extra_filters() → Q

Get extra filters for get_queryset(). Overwrite this method to specify needed filters e.g. as in ~integreat_cms.cms.views.contact.contact_bulk_actions

Returns:

Q Object to be used as filter argument

Return type:

Q

get_login_url()

Override this method to override the login_url attribute.

get_ordering()

Return the field or fields to use for ordering the queryset.

get_paginate_by(queryset)

Get the number of items to paginate by, or None for no pagination.

get_paginate_orphans()

Return the maximum number of orphans extend the last page by when paginating.

get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs)

Return an instance of the paginator for this view.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_queryset() → Any

Get the queryset of selected items for this bulk action

Raises:

Http404 – HTTP status 404 if no objects with the given ids exist

Returns:

The QuerySet of the filtered links

Return type:

Any

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_redirect_url(*args: Any, **kwargs: Any) → str

Retrieve url for redirection

Parameters:

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

url to redirect to

Return type:

str

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

head(request, *args, **kwargs)

http_method_names: list[str] = ['post']

The list of HTTP method names that this view will accept. The bulk action form uses only POST as submission method.

http_method_not_allowed(request, *args, **kwargs)

login_url = None

model

alias of LanguageTreeNode

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

ordering = None

page_kwarg = 'page'

paginate_by = None

paginate_orphans = 0

paginate_queryset(queryset, page_size)

Paginate the queryset, if needed.

paginator_class

alias of Paginator

patch(request, *args, **kwargs)

pattern_name = None

permanent = False

permission_denied_message = ''

permission_required = None

post(request: HttpRequest, *args: Any, **kwargs: Any) → HttpResponseRedirect

Execute bulk action for language tree node and flush the cache

Parameters:

• request (HttpRequest) – The current request

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

The redirect

Return type:

HttpResponseRedirect

prefetch_public_translations: bool = False

Whether the public translation objects should be prefetched

prefetch_translations: bool = False

Whether the translation objects should be prefetched

put(request, *args, **kwargs)

query_string = False

queryset = None

raise_exception = False

redirect_field_name = 'next'

require_change_permission: bool = True

Whether the view requires change permissions

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

url = None

value: bool = False

The value of the field

view_is_async = False

class integreat_cms.cms.views.language_tree.language_tree_bulk_actions.BulkHideView(**kwargs)

Bases: BulkMakeVisibleView

Bulk action for hiding multiple language tree nodes at once

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

action = 'hidden'

The name of the action

allow_empty = True

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

context_object_name = None

delete(request, *args, **kwargs)

dispatch(request, *args, **kwargs)

extra_context = None

field_name = 'visible'

The name of the archived-field

get(request, *args, **kwargs)

get_allow_empty()

Return True if the view should display empty lists and False if a 404 should be raised instead.

get_context_data(*, object_list=None, **kwargs)

Get the context for this view.

get_context_object_name(object_list)

Get the name of the item to be used in the context.

get_extra_filters() → Q

Get extra filters for get_queryset(). Overwrite this method to specify needed filters e.g. as in ~integreat_cms.cms.views.contact.contact_bulk_actions

Returns:

Q Object to be used as filter argument

Return type:

Q

get_login_url()

Override this method to override the login_url attribute.

get_ordering()

Return the field or fields to use for ordering the queryset.

get_paginate_by(queryset)

Get the number of items to paginate by, or None for no pagination.

get_paginate_orphans()

Return the maximum number of orphans extend the last page by when paginating.

get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs)

Return an instance of the paginator for this view.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_queryset() → Any

Get the queryset of selected items for this bulk action

Raises:

Http404 – HTTP status 404 if no objects with the given ids exist

Returns:

The QuerySet of the filtered links

Return type:

Any

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_redirect_url(*args: Any, **kwargs: Any) → str

Retrieve url for redirection

Parameters:

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

url to redirect to

Return type:

str

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

head(request, *args, **kwargs)

http_method_names: list[str] = ['post']

The list of HTTP method names that this view will accept. The bulk action form uses only POST as submission method.

http_method_not_allowed(request, *args, **kwargs)

login_url = None

model

alias of LanguageTreeNode

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

ordering = None

page_kwarg = 'page'

paginate_by = None

paginate_orphans = 0

paginate_queryset(queryset, page_size)

Paginate the queryset, if needed.

paginator_class

alias of Paginator

patch(request, *args, **kwargs)

pattern_name = None

permanent = False

permission_denied_message = ''

permission_required = None

post(request: HttpRequest, *args: Any, **kwargs: Any) → HttpResponseRedirect

Execute bulk action for language tree node and flush the cache

Parameters:

• request (HttpRequest) – The current request

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

The redirect

Return type:

HttpResponseRedirect

prefetch_public_translations: bool = False

Whether the public translation objects should be prefetched

prefetch_translations: bool = False

Whether the translation objects should be prefetched

put(request, *args, **kwargs)

query_string = False

queryset = None

raise_exception = False

redirect_field_name = 'next'

require_change_permission: bool = True

Whether the view requires change permissions

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

url = None

value: bool = False

The value of the field

view_is_async = False

class integreat_cms.cms.views.language_tree.language_tree_bulk_actions.BulkMakeVisibleView(**kwargs)

Bases: LanguageTreeBulkActionView

Bulk action for making multiple language tree nodes visible at once

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

action = 'made visible'

The name of the action

allow_empty = True

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

context_object_name = None

delete(request, *args, **kwargs)

dispatch(request, *args, **kwargs)

extra_context = None

field_name = 'visible'

The name of the archived-field

get(request, *args, **kwargs)

get_allow_empty()

Return True if the view should display empty lists and False if a 404 should be raised instead.

get_context_data(*, object_list=None, **kwargs)

Get the context for this view.

get_context_object_name(object_list)

Get the name of the item to be used in the context.

get_extra_filters() → Q

Get extra filters for get_queryset(). Overwrite this method to specify needed filters e.g. as in ~integreat_cms.cms.views.contact.contact_bulk_actions

Returns:

Q Object to be used as filter argument

Return type:

Q

get_login_url()

Override this method to override the login_url attribute.

get_ordering()

Return the field or fields to use for ordering the queryset.

get_paginate_by(queryset)

Get the number of items to paginate by, or None for no pagination.

get_paginate_orphans()

Return the maximum number of orphans extend the last page by when paginating.

get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs)

Return an instance of the paginator for this view.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_queryset() → Any

Get the queryset of selected items for this bulk action

Raises:

Http404 – HTTP status 404 if no objects with the given ids exist

Returns:

The QuerySet of the filtered links

Return type:

Any

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_redirect_url(*args: Any, **kwargs: Any) → str

Retrieve url for redirection

Parameters:

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

url to redirect to

Return type:

str

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

head(request, *args, **kwargs)

http_method_names: list[str] = ['post']

The list of HTTP method names that this view will accept. The bulk action form uses only POST as submission method.

http_method_not_allowed(request, *args, **kwargs)

login_url = None

model

alias of LanguageTreeNode

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

ordering = None

page_kwarg = 'page'

paginate_by = None

paginate_orphans = 0

paginate_queryset(queryset, page_size)

Paginate the queryset, if needed.

paginator_class

alias of Paginator

patch(request, *args, **kwargs)

pattern_name = None

permanent = False

permission_denied_message = ''

permission_required = None

post(request: HttpRequest, *args: Any, **kwargs: Any) → HttpResponseRedirect

Execute bulk action for language tree node and flush the cache

Parameters:

• request (HttpRequest) – The current request

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

The redirect

Return type:

HttpResponseRedirect

prefetch_public_translations: bool = False

Whether the public translation objects should be prefetched

prefetch_translations: bool = False

Whether the translation objects should be prefetched

put(request, *args, **kwargs)

query_string = False

queryset = None

raise_exception = False

redirect_field_name = 'next'

require_change_permission: bool = True

Whether the view requires change permissions

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

url = None

value: bool = True

The value of the field (defaults to True)

view_is_async = False

class integreat_cms.cms.views.language_tree.language_tree_bulk_actions.LanguageTreeBulkActionView(**kwargs)

Bases: BulkUpdateBooleanFieldView

Bulk action view for language tree nodes which flushes the cache for all content models after each operation

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

property action: str

Called when the bulk action is performed and the action attribute was not overwritten

Raises:

NotImplementedError – If the action attribute is not implemented in the subclass

allow_empty = True

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

context_object_name = None

delete(request, *args, **kwargs)

dispatch(request, *args, **kwargs)

extra_context = None

property field_name: str

Called when the bulk action is performed and the field_name attribute was not overwritten

Raises:

NotImplementedError – If the field_name attribute is not implemented in the subclass

get(request, *args, **kwargs)

get_allow_empty()

Return True if the view should display empty lists and False if a 404 should be raised instead.

get_context_data(*, object_list=None, **kwargs)

Get the context for this view.

get_context_object_name(object_list)

Get the name of the item to be used in the context.

get_extra_filters() → Q

Get extra filters for get_queryset(). Overwrite this method to specify needed filters e.g. as in ~integreat_cms.cms.views.contact.contact_bulk_actions

Returns:

Q Object to be used as filter argument

Return type:

Q

get_login_url()

Override this method to override the login_url attribute.

get_ordering()

Return the field or fields to use for ordering the queryset.

get_paginate_by(queryset)

Get the number of items to paginate by, or None for no pagination.

get_paginate_orphans()

Return the maximum number of orphans extend the last page by when paginating.

get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs)

Return an instance of the paginator for this view.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_queryset() → Any

Get the queryset of selected items for this bulk action

Raises:

Http404 – HTTP status 404 if no objects with the given ids exist

Returns:

The QuerySet of the filtered links

Return type:

Any

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_redirect_url(*args: Any, **kwargs: Any) → str

Retrieve url for redirection

Parameters:

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

url to redirect to

Return type:

str

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

head(request, *args, **kwargs)

http_method_names: list[str] = ['post']

The list of HTTP method names that this view will accept. The bulk action form uses only POST as submission method.

http_method_not_allowed(request, *args, **kwargs)

login_url = None

model

The model of this BulkActionView

Parameters:

• id (BigAutoField) – Primary key: ID

• lft (PositiveIntegerField) – Lft

• rgt (PositiveIntegerField) – Rgt

• tree_id (PositiveIntegerField) – Tree id

• depth (PositiveIntegerField) – Depth

• visible (BooleanField) – Visible. Defines whether the language is displayed to the users of the app

• active (BooleanField) – Active. Defined if content in this language can be created or edited

• created_date (DateTimeField) – Creation date

• last_updated (DateTimeField) – Modification date

• machine_translation_enabled (BooleanField) – Machine translatable. Enable or disable machine translations into this language

• preferred_mt_provider (CharField) – Machine translation provider. Preferred provider for translations into this language

Relationship fields:

Parameters:

• parent (ForeignKey to LanguageTreeNode) – Source language (related name: children)

• region (ForeignKey to Region) – Region (related name: language_tree_nodes)

• language (ForeignKey to Language) – Language (related name: language_tree_nodes)

Reverse relationships:

Parameters:

children (Reverse ForeignKey from LanguageTreeNode) – All children of this language tree node (related name of parent)

alias of LanguageTreeNode

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

ordering = None

page_kwarg = 'page'

paginate_by = None

paginate_orphans = 0

paginate_queryset(queryset, page_size)

Paginate the queryset, if needed.

paginator_class

alias of Paginator

patch(request, *args, **kwargs)

pattern_name = None

permanent = False

permission_denied_message = ''

permission_required = None

post(request: HttpRequest, *args: Any, **kwargs: Any) → HttpResponseRedirect

Execute bulk action for language tree node and flush the cache

Parameters:

• request (HttpRequest) – The current request

• *args (Any) – The supplied arguments

• **kwargs (Any) – The supplied keyword arguments

Returns:

The redirect

Return type:

HttpResponseRedirect

prefetch_public_translations: bool = False

Whether the public translation objects should be prefetched

prefetch_translations: bool = False

Whether the translation objects should be prefetched

put(request, *args, **kwargs)

query_string = False

queryset = None

raise_exception = False

redirect_field_name = 'next'

require_change_permission: bool = True

Whether the view requires change permissions

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

url = None

value: bool = True

The value of the field (defaults to True)

view_is_async = False

Language Tree Context Mixin

class integreat_cms.cms.views.language_tree.language_tree_context_mixin.LanguageTreeContextMixin

Bases: ContextMixin

This mixin provides extra context for language tree views

__init__()

extra_context = None

get_context_data(**kwargs: Any) → dict[str, Any]

Returns a dictionary representing the template context (see get_context_data()).

Parameters:

**kwargs (Any) – The given keyword arguments

Returns:

The template context

Return type:

dict[str, Any]

Language Tree Node Form View

class integreat_cms.cms.views.language_tree.language_tree_node_form_view.LanguageTreeNodeCreateView(**kwargs)

Bases: CustomCreateView

Class that handles creating language tree nodes. This view is available within regions.

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

content_type = None

context_object_name = None

dispatch(request, *args, **kwargs)

extra_context = None

fields = None

form_class

The form class of this form view

Form fields:

• language: Language (ModelChoiceField)

• visible: Visible (BooleanField)

• active: Active (BooleanField)

• parent: Source language (ModelChoiceField)

• machine_translation_enabled: Machine translatable (BooleanField)

• _position: Position (ChoiceField)

• _ref_node_id: Relative to (ChoiceField)

alias of LanguageTreeNodeForm

form_invalid(form: CustomModelForm) → HttpResponse

Renders a response, providing the invalid form as context.

Parameters:

form (CustomModelForm) – The invalid form instance

Returns:

The rendered invalid form

Return type:

HttpResponse

form_valid(form: CustomModelForm) → HttpResponseRedirect

Saves the form instance, sets the current object for the view, and redirects to get_success_url().

Parameters:

form (CustomModelForm) – The valid form instance

Returns:

A redirection to the success url

Return type:

HttpResponseRedirect

get(request, *args, **kwargs)

Handle GET requests: instantiate a blank version of the form.

get_context_data(**kwargs: Any) → dict[str, Any]

Returns a dictionary representing the template context (see get_context_data()).

Parameters:

**kwargs (Any) – The given keyword arguments

Returns:

The template context

Return type:

dict[str, Any]

get_context_object_name(obj)

Get the name to use for the object.

get_form(form_class=None)

Return an instance of the form to be used in this view.

get_form_class()

Return the form class to use in this view.

get_form_kwargs() → dict[str, Any]

Return the keyword arguments for instantiating the form

Returns:

The form kwargs

Return type:

dict[str, Any]

get_initial()

Return the initial data to use for forms on this view.

get_login_url()

Override this method to override the login_url attribute.

get_object(queryset=None)

Return the object the view is displaying.

Require self.queryset and a pk or slug argument in the URLconf. Subclasses can override this to return any object.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_prefix()

Return the prefix to use for forms.

get_queryset()

Return the QuerySet that will be used to look up the object.

This method is called by the default implementation of get_object() and may not be called if get_object() is overridden.

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_slug_field()

Get the name of a slug field to be used to look up by slug.

get_success_url() → str

Determine the URL to redirect to when the form is successfully validated

Returns:

The url to redirect on success

Return type:

str

get_template_names()

Return a list of template names to be used for the request. Must return a list. May not be called if render_to_response() is overridden.

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

http_method_names = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']

http_method_not_allowed(request, *args, **kwargs)

initial = {}

login_url = None

property model: ModelBase

Return the model class of this form mixin

Returns:

The corresponding Django model

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

permission_denied_message = ''

permission_required = None

pk_url_kwarg = 'pk'

post(request, *args, **kwargs)

Handle POST requests: instantiate a form instance with the passed POST variables and then check if it’s valid.

prefix = None

put(*args, **kwargs)

query_pk_and_slug = False

queryset = None

raise_exception = False

redirect_field_name = 'next'

render_to_response(context, **response_kwargs)

Return a response, using the response_class for this view, with a template rendered with the given context.

Pass response_kwargs to the constructor of the response class.

response_class

alias of TemplateResponse

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

slug_field = 'slug'

slug_url_kwarg = 'slug'

success_url = None

template_engine = None

property template_name: str

Return the template name to be used for the request.

Returns:

The template to be rendered

template_name_suffix: str = '_form'

The suffix to append to the auto-generated candidate template name.

view_is_async = False

class integreat_cms.cms.views.language_tree.language_tree_node_form_view.LanguageTreeNodeUpdateView(**kwargs)

Bases: CustomUpdateView

Class that handles activating/deactivating of a language tree node

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

content_type = None

context_object_name = None

dispatch(request, *args, **kwargs)

extra_context = None

fields = None

form_class = None

form_invalid(form: CustomModelForm) → HttpResponse

Renders a response, providing the invalid form as context.

Parameters:

form (CustomModelForm) – The invalid form instance

Returns:

The rendered invalid form

Return type:

HttpResponse

form_valid(form: LanguageTreeNodeForm) → HttpResponseRedirect

Saves the form instance, sets the current object for the view, and redirects to get_success_url().

Parameters:

form (LanguageTreeNodeForm) – The valid form instance

Returns:

A redirection to the success url

Return type:

HttpResponseRedirect

get(request, *args, **kwargs)

Handle GET requests: instantiate a blank version of the form.

get_context_data(**kwargs: Any) → dict[str, Any]

Returns a dictionary representing the template context (see get_context_data()).

Parameters:

**kwargs (Any) – The given keyword arguments

Returns:

The template context

Return type:

dict[str, Any]

get_context_object_name(obj)

Get the name to use for the object.

get_form(form_class=None)

Return an instance of the form to be used in this view.

get_form_class()

Return the form class to use in this view.

get_form_kwargs() → dict[str, Any]

Return the keyword arguments for instantiating the form

Returns:

The form kwargs

Return type:

dict[str, Any]

get_initial()

Return the initial data to use for forms on this view.

get_login_url()

Override this method to override the login_url attribute.

get_object(queryset=None)

Return the object the view is displaying.

Require self.queryset and a pk or slug argument in the URLconf. Subclasses can override this to return any object.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_prefix()

Return the prefix to use for forms.

get_queryset()

Return the QuerySet that will be used to look up the object.

This method is called by the default implementation of get_object() and may not be called if get_object() is overridden.

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_slug_field()

Get the name of a slug field to be used to look up by slug.

get_success_url() → str

Determine the URL to redirect to when the form is successfully validated

Returns:

The url to redirect on success

Return type:

str

get_template_names()

Return a list of template names to be used for the request. Must return a list. May not be called if render_to_response() is overridden.

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

http_method_names = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']

http_method_not_allowed(request, *args, **kwargs)

initial = {}

login_url = None

property model: ModelBase

Return the model class of this form mixin

Returns:

The corresponding Django model

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

permission_denied_message = ''

permission_required = None

pk_url_kwarg = 'pk'

post(request, *args, **kwargs)

Handle POST requests: instantiate a form instance with the passed POST variables and then check if it’s valid.

prefix = None

put(*args, **kwargs)

query_pk_and_slug = False

queryset = None

raise_exception = False

redirect_field_name = 'next'

render_to_response(context, **response_kwargs)

Return a response, using the response_class for this view, with a template rendered with the given context.

Pass response_kwargs to the constructor of the response class.

response_class

alias of TemplateResponse

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

slug_field = 'slug'

slug_url_kwarg = 'slug'

success_url = None

template_engine = None

property template_name: str

Return the template name to be used for the request.

Returns:

The template to be rendered

template_name_suffix: str = '_form'

The suffix to append to the auto-generated candidate template name.

view_is_async = False

Language Tree View

class integreat_cms.cms.views.language_tree.language_tree_view.LanguageTreeView(**kwargs)

Bases: LanguageTreeContextMixin, ModelListView

View for rendering the language tree view. This view is available in regions.

__init__(**kwargs)

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

allow_empty = True

classmethod as_view(**initkwargs)

Main entry point for a request-response process.

content_type = None

property context_object_name: str

Designates the name of the variable to use in the context (see MultipleObjectMixin).

Returns:

The name of the objects in this list view

dispatch(request, *args, **kwargs)

extra_context = None

get(request, *args, **kwargs)

get_allow_empty()

Return True if the view should display empty lists and False if a 404 should be raised instead.

get_context_data(**kwargs: Any) → dict[str, Any]

Returns a dictionary representing the template context (see get_context_data()).

Parameters:

**kwargs (Any) – The given keyword arguments

Returns:

The template context

Return type:

dict[str, Any]

get_context_object_name(object_list)

Get the name of the item to be used in the context.

get_login_url()

Override this method to override the login_url attribute.

get_ordering()

Return the field or fields to use for ordering the queryset.

get_paginate_by(queryset)

Get the number of items to paginate by, or None for no pagination.

get_paginate_orphans()

Return the maximum number of orphans extend the last page by when paginating.

get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs)

Return an instance of the paginator for this view.

get_permission_denied_message()

Override this method to override the permission_denied_message attribute.

get_permission_required() → tuple[str]

Override this method to override the permission_required attribute.

Returns:

The permissions that are required for views inheriting from this Mixin

Return type:

tuple[str]

get_queryset() → list[LanguageTreeNode]

Get language tree queryset

Returns:

The language tree of the current region

Return type:

list[LanguageTreeNode]

get_redirect_field_name()

Override this method to override the redirect_field_name attribute.

get_template_names()

Return a list of template names to be used for the request. Must return a list. May not be called if render_to_response is overridden.

handle_no_permission()

has_permission()

Override this method to customize the way permissions are checked.

http_method_names = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']

http_method_not_allowed(request, *args, **kwargs)

login_url = None

model

The model of this list view

Parameters:

• id (BigAutoField) – Primary key: ID

• lft (PositiveIntegerField) – Lft

• rgt (PositiveIntegerField) – Rgt

• tree_id (PositiveIntegerField) – Tree id

• depth (PositiveIntegerField) – Depth

• visible (BooleanField) – Visible. Defines whether the language is displayed to the users of the app

• active (BooleanField) – Active. Defined if content in this language can be created or edited

• created_date (DateTimeField) – Creation date

• last_updated (DateTimeField) – Modification date

• machine_translation_enabled (BooleanField) – Machine translatable. Enable or disable machine translations into this language

• preferred_mt_provider (CharField) – Machine translation provider. Preferred provider for translations into this language

Relationship fields:

Parameters:

• parent (ForeignKey to LanguageTreeNode) – Source language (related name: children)

• region (ForeignKey to Region) – Region (related name: language_tree_nodes)

• language (ForeignKey to Language) – Language (related name: language_tree_nodes)

Reverse relationships:

Parameters:

children (Reverse ForeignKey from LanguageTreeNode) – All children of this language tree node (related name of parent)

alias of LanguageTreeNode

options(request, *args, **kwargs)

Handle responding to requests for the OPTIONS HTTP verb.

ordering = None

page_kwarg = 'page'

paginate_by: int | None = None

Disable pagination for language tree

paginate_orphans = 0

paginate_queryset(queryset, page_size)

Paginate the queryset, if needed.

paginator_class

alias of Paginator

permission_denied_message = ''

permission_required = None

queryset = None

raise_exception = False

redirect_field_name = 'next'

render_to_response(context, **response_kwargs)

Return a response, using the response_class for this view, with a template rendered with the given context.

Pass response_kwargs to the constructor of the response class.

response_class

alias of TemplateResponse

setup(request, *args, **kwargs)

Initialize attributes shared by all view methods.

template_engine = None

property template_name: str

Return the template name to be used for the request.

Returns:

The template to be rendered

template_name_suffix = '_list'

view_is_async = False