POI Categories

This package contains page-related data models:

• POICategory and POICategoryTranslation

POI Category

class integreat_cms.cms.models.poi_categories.poi_category.POICategory(*args, **kwargs)

Bases: AbstractBaseModel

Data model representing a POI category.

Parameters:

• id (BigAutoField) – Primary key: ID

• icon (CharField) – Icon. Select an icon for this category

• color (CharField) – Color. Select a color for map pins with this category

Reverse relationships:

Parameters:

• pois (Reverse ForeignKey from POI) – All pois of this location category (related name of category)

• translations (Reverse ForeignKey from POICategoryTranslation) – All translations of this location category (related name of category)

exception DoesNotExist

Bases: ObjectDoesNotExist

__init__(*args, **kwargs)

add_note()

Exception.add_note(note) – add a note to the exception

args

silent_variable_failure = True

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception MultipleObjectsReturned

Bases: MultipleObjectsReturned

__init__(*args, **kwargs)

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

__init__(*args, **kwargs)

async adelete(using=None, keep_parents=False)

async arefresh_from_db(using=None, fields=None)

async asave(force_insert=False, force_update=False, using=None, update_fields=None)

backend_translation

This function returns the translation of this content object in the current backend language.

Returns:

The backend translation of a content object

best_translation

This function returns the translation of this category in the current backend language and if it doesn’t exist, it provides a fallback to the first translation.

Returns:

The “best” translation of this category for displaying in the backend

classmethod check(**kwargs)

clean()

Hook for doing any extra model-wide validation after clean() has been called on every field by self.clean_fields. Any ValidationError raised by this method will not be associated with a particular field; it will have a special-case association with the field defined by NON_FIELD_ERRORS.

clean_fields(exclude=None)

Clean all fields and raise a ValidationError containing a dict of all validation errors if any occur.

color

Type: CharField

Color. Select a color for map pins with this category

Choices:

• #3700D2

• #2E98FB

• #1DC6C6

• #3F8F01

• #07DC03

• #F2DA04

• #C38E03

• #FF7C32

• #FF3333

• #EE36DC

• and 2 more

date_error_message(lookup_type, field_name, unique_for)

delete(using=None, keep_parents=False)

classmethod from_db(db, field_names, values)

full_clean(exclude=None, validate_unique=True, validate_constraints=True)

Call clean_fields(), clean(), validate_unique(), and validate_constraints() on the model. Raise a ValidationError for any errors that occur.

get_color_display(*, field=<django.db.models.CharField: color>)

Shows the label of the color. See get_FOO_display() for more information.

get_constraints()

get_deferred_fields()

Return a set containing names of deferred fields for this instance.

get_icon_display(*, field=<django.db.models.CharField: icon>)

Shows the label of the icon. See get_FOO_display() for more information.

classmethod get_model_name_plural() → str

Get the plural representation of this model name

Returns:

The plural model name

Return type:

str

get_repr() → str

This overwrites the default Django __repr__() method which would return <POI Category: POICategory object (id, category name)>. It is used for logging.

Returns:

The canonical string representation of the category

Return type:

str

get_translation(language_slug: str) → POICategoryTranslation | None

Get the translation of this category in a given language

Parameters:

language_slug (str) – language in which the poi category is to be shown

Returns:

translation of the poi category in the language if no translation is saved for the language, the category name of the POICategory

Return type:

POICategoryTranslation | None

icon

Type: CharField

Icon. Select an icon for this category

Choices:

• advice

• culture

• daily_routine

• education

• finance

• gastronomy

• health

• house

• leisure

• media

• and 11 more

id

Type: BigAutoField

Primary key: ID

name

This function returns the name of the category in the “best” translation

Returns:

The name of the category

objects = <django.db.models.Manager object>

property pk

pois

Type: Reverse ForeignKey from POI

All pois of this location category (related name of category)

prefetched_translations_by_language_slug

This method returns a mapping from language slugs to their public translations of this object

Returns:

The object translation in the requested Language or None if no translation exists

prepare_database_save(field)

refresh_from_db(using=None, fields=None)

Reload field values from the database.

By default, the reloading happens from the database this instance was loaded from, or by the read router if this instance wasn’t loaded from any database. The using parameter will override the default.

Fields can be used to specify which fields to reload. The fields should be an iterable of field attnames. If fields is None, then all non-deferred fields are reloaded.

When accessing deferred fields of an instance, the deferred loading of the field will call this method.

save(force_insert=False, force_update=False, using=None, update_fields=None)

Save the current instance. Override this in a subclass if you want to control the saving process.

The ‘force_insert’ and ‘force_update’ parameters can be used to insist that the “save” must be an SQL insert or update (or equivalent for non-SQL backends), respectively. Normally, they should not be set.

save_base(raw=False, force_insert=False, force_update=False, using=None, update_fields=None)

Handle the parts of saving which should be done only once per save, yet need to be done in raw saves, too. This includes some sanity checks and signal sending.

The ‘raw’ argument is telling save_base not to save any parent models and not to do any changes to the values before save. This is used by fixture loading.

serializable_value(field_name)

Return the value of the field name for this instance. If the field is a foreign key, return the id value instead of the object. If there’s no Field object with this name on the model, return the model attribute’s value.

Used to serialize a field’s value (in the serializer, or form output, for example). Normally, you would just access the attribute directly and not use this method.

translations

Type: Reverse ForeignKey from POICategoryTranslation

All translations of this location category (related name of category)

unique_error_message(model_class, unique_check)

validate_constraints(exclude=None)

validate_unique(exclude=None)

Check unique constraints on the model and raise ValidationError if any failed.

POI Category Translation

class integreat_cms.cms.models.poi_categories.poi_category_translation.POICategoryTranslation(*args, **kwargs)

Bases: AbstractBaseModel

Data model representing a POI category translation.

Parameters:

• id (BigAutoField) – Primary key: ID

• name (CharField) – Category name. The name of the POI category.

Relationship fields:

Parameters:

• category (ForeignKey to POICategory) – Category (related name: translations)

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

exception DoesNotExist

Bases: ObjectDoesNotExist

__init__(*args, **kwargs)

add_note()

Exception.add_note(note) – add a note to the exception

args

silent_variable_failure = True

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception MultipleObjectsReturned

Bases: MultipleObjectsReturned

__init__(*args, **kwargs)

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

__init__(*args, **kwargs)

async adelete(using=None, keep_parents=False)

async arefresh_from_db(using=None, fields=None)

async asave(force_insert=False, force_update=False, using=None, update_fields=None)

category

Type: ForeignKey to POICategory

Category (related name: translations)

category_id

Internal field, use category instead.

classmethod check(**kwargs)

clean()

Hook for doing any extra model-wide validation after clean() has been called on every field by self.clean_fields. Any ValidationError raised by this method will not be associated with a particular field; it will have a special-case association with the field defined by NON_FIELD_ERRORS.

clean_fields(exclude=None)

Clean all fields and raise a ValidationError containing a dict of all validation errors if any occur.

date_error_message(lookup_type, field_name, unique_for)

delete(using=None, keep_parents=False)

classmethod from_db(db, field_names, values)

full_clean(exclude=None, validate_unique=True, validate_constraints=True)

Call clean_fields(), clean(), validate_unique(), and validate_constraints() on the model. Raise a ValidationError for any errors that occur.

get_constraints()

get_deferred_fields()

Return a set containing names of deferred fields for this instance.

classmethod get_model_name_plural() → str

Get the plural representation of this model name

Returns:

The plural model name

Return type:

str

get_repr() → str

This overwrites the default Django __repr__() method which would return <POI CategoryTranslation: POICategoryTranslation object (id, category name)>. It is used for logging.

Returns:

The canonical string representation of the category translation

Return type:

str

id

Type: BigAutoField

Primary key: ID

language

Type: ForeignKey to Language

Language (related name: poi_category_translations)

language_id

Internal field, use language instead.

name

Type: CharField

Category name. The name of the POI category.

objects = <django.db.models.Manager object>

property pk

prepare_database_save(field)

refresh_from_db(using=None, fields=None)

Reload field values from the database.

By default, the reloading happens from the database this instance was loaded from, or by the read router if this instance wasn’t loaded from any database. The using parameter will override the default.

Fields can be used to specify which fields to reload. The fields should be an iterable of field attnames. If fields is None, then all non-deferred fields are reloaded.

When accessing deferred fields of an instance, the deferred loading of the field will call this method.

save(force_insert=False, force_update=False, using=None, update_fields=None)

Save the current instance. Override this in a subclass if you want to control the saving process.

The ‘force_insert’ and ‘force_update’ parameters can be used to insist that the “save” must be an SQL insert or update (or equivalent for non-SQL backends), respectively. Normally, they should not be set.

save_base(raw=False, force_insert=False, force_update=False, using=None, update_fields=None)

Handle the parts of saving which should be done only once per save, yet need to be done in raw saves, too. This includes some sanity checks and signal sending.

The ‘raw’ argument is telling save_base not to save any parent models and not to do any changes to the values before save. This is used by fixture loading.

serializable_value(field_name)

Return the value of the field name for this instance. If the field is a foreign key, return the id value instead of the object. If there’s no Field object with this name on the model, return the model attribute’s value.

Used to serialize a field’s value (in the serializer, or form output, for example). Normally, you would just access the attribute directly and not use this method.

unique_error_message(model_class, unique_check)

validate_constraints(exclude=None)

validate_unique(exclude=None)

Check unique constraints on the model and raise ValidationError if any failed.