Interface¶
Info
For a complete list of available parameters, refer to the default values in geotrek/settings/base.py.
Configure columns displayed in lists views and exports¶
You can customize the columns displayed in list views and data exports for each module.
To configure which columns appear in the main table view for a specific module, use the following syntax:
COLUMNS_LISTS['<module>_view'] = ['list', 'of', 'columns']
COLUMNS_LISTS['trek_view'] = [
'structure',
'departure',
'arrival',
'duration',
'description_teaser',
'description',
'gear',
'route',
'difficulty',
'ambiance',
'access',
'themes',
'practice']
To define which columns should be included when exporting data to CSV or SHP formats, use the syntax below:
COLUMNS_LISTS['<module>_export'] = ['list', 'of', 'columns']
COLUMNS_LISTS['outdoor_site_export'] = [
'structure',
'name',
'practice',
'description',
'description_teaser',
'ambiance',
'advice',
'accessibility',
'period',
'labels',
'themes',
'portal',
'source',
'information_desks',
'orientation',
'wind'
]
Enable jobs cost detailed export¶
By default, job cost details are not included in intervention exports. You can enable a more detailed export by setting the following parameter:
ENABLE_JOBS_COSTS_DETAILED_EXPORT = False
ENABLE_JOBS_COSTS_DETAILED_EXPORT = True
When enabled, a new column will be added to intervention exports, displaying the total cost for each job.
Custom columns available¶
A complete list of attributes that can be used for displaying or exporting columns is available. You can customize these based on your requirements.
List of available attributes for displaying
COLUMNS_LISTS["path_view"] = [
"length_2d",
"valid",
"structure",
"visible",
"min_elevation",
"max_elevation",
"date_update",
"date_insert",
"stake",
"networks",
"comments",
"departure",
"arrival",
"comfort",
"source",
"usages",
"draft",
"trails",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["trail_view"] = [
"departure",
"arrival",
"category",
"length",
"structure",
"min_elevation",
"max_elevation",
"date_update",
"length_2d",
"date_insert",
"comments",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["landedge_view"] = [
"eid",
"min_elevation",
"max_elevation",
"date_update",
"length_2d",
"date_insert",
"owner",
"agreement",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["circulationedge_view"] = [
"eid",
"min_elevation",
"max_elevation",
"date_update",
"length_2d",
"date_insert",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["physicaledge_view"] = [
"eid",
"date_insert",
"date_update",
"length",
"length_2d",
"min_elevation",
"max_elevation",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["competenceedge_view"] = [
"eid",
"date_insert",
"date_update",
"length",
"length_2d",
"min_elevation",
"max_elevation",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["infrastructure_view"] = [
"condition",
"cities",
"structure",
"type",
"description",
"accessibility",
"date_update",
"date_insert",
"implantation_year",
"usage_difficulty",
"maintenance_difficulty",
"published",
"uuid",
"eid",
"provider",
"access",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["signage_view"] = [
"code",
"type",
"condition",
"structure",
"description",
"date_update",
"date_insert",
"implantation_year",
"printed_elevation",
"coordinates",
"sealing",
"access",
"manager",
"published",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["intervention_view"] = [
"begin_date",
"end_date",
"type",
"target",
"status",
"stake",
"structure",
"subcontracting",
"status",
"disorders",
"length",
"material_cost",
"min_elevation",
"max_elevation",
"heliport_cost",
"contractor_cost",
"date_update",
"date_insert",
"description",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["project_view"] = [
"structure",
"begin_year",
"end_year",
"constraint",
"global_cost",
"type",
"date_update",
"domain",
"contractors",
"project_owner",
"project_manager",
"founders",
"date_insert",
"comments",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["trek_view"] = [
"structure",
"departure",
"arrival",
"duration",
"description_teaser",
"description",
"gear",
"route",
"difficulty",
"ambiance",
"access",
"accessibility_infrastructure",
"advised_parking",
"parking_location",
"public_transport",
"themes",
"practice",
"min_elevation",
"max_elevation",
"length_2d",
"date_update",
"date_insert",
"accessibilities",
"accessibility_advice",
"accessibility_covering",
"accessibility_exposure",
"accessibility_level",
"accessibility_signage",
"accessibility_slope",
"accessibility_width",
"ratings_description",
"ratings",
"points_reference",
"source",
"reservation_system",
"reservation_id",
"portal",
"uuid",
"eid",
"eid2",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["poi_view"] = [
"structure",
"description",
"type",
"min_elevation",
"date_update",
"date_insert",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["service_view"] = [
"structure",
"min_elevation",
"type",
"length_2d",
"date_update",
"date_insert",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["touristic_content_view"] = [
"structure",
"description_teaser",
"description",
"category",
"contact",
"email",
"website",
"practical_info",
"accessibility",
"label_accessibility",
"type1",
"type2",
"source",
"reservation_system",
"reservation_id",
"date_update",
"date_insert",
"uuid",
"eid",
"provider"
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["touristic_event_view"] = [
"structure",
"themes",
"description_teaser",
"description",
"meeting_point",
"start_time",
"end_time",
"duration",
"begin_date",
"contact",
"email",
"website",
"end_date",
"organizers",
"speaker",
"type",
"accessibility",
"capacity",
"portal",
"source",
"practical_info",
"target_audience",
"booking",
"date_update",
"date_insert",
"uuid",
"eid",
"provider",
"bookable",
"cancelled",
"cancellation_reason"
"place",
'preparation_duration',
'intervention_duration',
'price',
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["feedback_view"] = [
"email",
"comment",
"activity",
"category",
"problem_magnitude",
"status",
"related_trek",
"uuid",
"eid",
"external_eid",
"locked",
"origin"
"date_update",
"date_insert",
"created_in_suricate",
"last_updated_in_suricate",
"current_user",
"uses_timers",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["sensitivity_view"] = [
"structure",
"species",
"published",
"publication_date",
"contact",
"pretty_period",
"category",
"pretty_practices",
"description",
"date_update",
"date_insert",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["outdoor_site_view"] = [
"structure",
"name",
"practice",
"description",
"description_teaser",
"ambiance",
"advice",
"accessibility",
"period",
"labels",
"themes",
"portal",
"source",
"information_desks",
"web_links",
"eid",
"orientation",
"wind",
"ratings",
"managers",
"type",
"description",
"description_teaser",
"ambiance",
"period",
"orientation",
"wind",
"labels",
"themes",
"portal",
"source",
"managers",
"min_elevation",
"date_insert",
"date_update",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["outdoor_course_view"] = [
"structure",
"name",
"parent_sites",
"description",
"advice",
"equipment",
"accessibility",
"eid",
"height",
"ratings",
"gear",
"duration"
"ratings_description",
"type",
"points_reference",
"uuid",
"last_author",
"creator",
"authors",
]
List of available attributes for exporting
COLUMNS_LISTS["path_export"] = [
"structure",
"valid",
"visible",
"name",
"comments",
"departure",
"arrival",
"comfort",
"source",
"stake",
"usages",
"networks",
"date_insert",
"date_update",
"length_2d",
"length",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["trail_export"] = [
"structure",
"name",
"comments",
"departure",
"arrival",
"category",
"certifications",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["signagemanagementedge_export"] = [
"eid",
"date_insert",
"date_update",
"length",
"length_2d",
"min_elevation",
"max_elevation",
"uuid",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["workmanagementedge_export"] = [
"eid",
"date_insert",
"date_update",
"length",
"length_2d",
"min_elevation",
"max_elevation",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["landedge_export"] = [
"eid",
"land_type",
"owner",
"agreement",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"length_2d",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["circulationedge_export"] = [
"eid",
"circulation_type",
"authorization_type",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"length_2d",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["physicaledge_export"] = [
"eid",
"physical_type",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"length_2d",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["competenceedge_export"] = [
"eid",
"organization",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"length_2d",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["signagemanagementedge_export"] = [
"eid",
"organization",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"length_2d",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["workmanagementedge_export"] = [
"eid",
"organization",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"length_2d",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["infrastructure_export"] = [
"name",
"type",
"condition",
"access",
"description",
"accessibility",
"implantation_year",
"published",
"publication_date",
"structure",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"usage_difficulty",
"maintenance_difficulty"
"uuid",
"eid",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["signage_export"] = [
"structure",
"name",
"code",
"type",
"condition",
"description",
"implantation_year",
"published",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"lat_value",
"lng_value",
"printed_elevation",
"sealing",
"access",
"manager",
"length",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"uuid",
"eid",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["intervention_export"] = [
"name",
"begin_date",
"end_date",
"type",
"target",
"status",
"stake",
"disorders",
"total_manday",
"project",
"subcontracting",
"width",
"height",
"length",
"area",
"structure",
"description",
"date_insert",
"date_update",
"material_cost",
"heliport_cost",
"contractor_cost",
"total_cost_mandays",
"total_cost",
"cities",
"districts",
"areas",
"length",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["project_export"] = [
"structure",
"name",
"period",
"type",
"domain",
"constraint",
"global_cost",
"interventions",
"interventions_total_cost",
"comments",
"contractors",
"project_owner",
"project_manager",
"founders",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["trek_export"] = [
"eid",
"eid2",
"structure",
"name",
"departure",
"arrival",
"duration",
"duration_pretty",
"description",
"description_teaser",
"gear",
"networks",
"advice",
"ambiance",
"difficulty",
"information_desks",
"themes",
"practice",
"accessibilities",
"accessibility_advice",
"accessibility_covering",
"accessibility_exposure",
"accessibility_level",
"accessibility_signage",
"accessibility_slope",
"accessibility_width",
"ratings_description",
"ratings",
"access",
"route",
"public_transport",
"advised_parking",
"web_links",
"labels",
"accessibility_infrastructure",
"parking_location",
"points_reference",
"children",
"parents",
"pois",
"review",
"published",
"publication_date",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"source",
"portal",
"length_2d",
"length",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["poi_export"] = [
"structure",
"eid",
"name",
"type",
"description",
"treks",
"review",
"published",
"publication_date",
"structure",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"length",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["service_export"] = [
"eid",
"type",
"length",
"ascent",
"descent",
"min_elevation",
"max_elevation",
"slope",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["dive_export"] = [
"eid",
"structure",
"name",
"departure",
"description",
"description_teaser",
"advice",
"difficulty",
"levels",
"themes",
"practice",
"disabled_sport",
"published",
"publication_date",
"date_insert",
"date_update",
"areas",
"source",
"portal",
"review",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["touristic_content_export"] = [
"structure",
"eid",
"name",
"category",
"type1",
"type2",
"description_teaser",
"description",
"themes",
"contact",
"email",
"website",
"practical_info",
"accessibility",
"label_accessibility",
"review",
"published",
"publication_date",
"source",
"portal",
"date_insert",
"date_update",
"cities",
"districts",
"areas",
"approved",
"uuid",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["touristic_event_export"] = [
"structure",
"eid",
"name",
"type",
"description_teaser",
"description",
"themes",
"begin_date",
"end_date",
"duration",
"meeting_point",
"start_time",
"end_time",
"contact",
"email",
"website",
"organizers",
"speaker",
"accessibility",
"capacity",
"booking",
"target_audience",
"practical_info",
"date_insert",
"date_update",
"source",
"portal",
"review",
"published",
"publication_date",
"cities",
"districts",
"areas",
"approved",
"uuid",
"provider",
"bookable",
"cancelled",
"cancellation_reason"
"place",
'preparation_duration',
'intervention_duration',
'price',
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["feedback_export"] = [
"comment",
"activity",
"category",
"problem_magnitude",
"status",
"related_trek",
"uuid",
"eid",
"external_eid",
"locked",
"origin"
"date_update",
"date_insert",
"created_in_suricate",
"last_updated_in_suricate",
"current_user",
"assigned_handler",
"uses_timers",
"provider",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["sensitivity_export"] = [
"species",
"published",
"description",
"contact",
"pretty_period",
"pretty_practices",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["outdoor_site_export"] = [
"structure",
"name",
"practice",
"description",
"description_teaser",
"ambiance",
"advice",
"accessibility",
"period",
"information_desks",
"web_links",
"eid",
"ratings",
"type",
"description",
"description_teaser",
"ambiance",
"period",
"orientation",
"wind",
"labels",
"themes",
"portal",
"source",
"managers",
"min_elevation",
"date_insert",
"date_update",
"uuid",
"last_author",
"creator",
"authors",
]
COLUMNS_LISTS["outdoor_course_export"] = [
"structure",
"name",
"parent_sites",
"description",
"advice",
"equipment",
"accessibility",
"eid",
"height",
"ratings",
"gear",
"duration"
"ratings_description",
"type",
"points_reference",
"uuid",
"last_author",
"creator",
"authors",
]
Note
You can find all mandatory, default, and searchable columns for each module directly in the Geotrek-admin source code. For example, these are the properties for outdoor_site_view :
mandatory_columns = ["id", "name"] default_extra_columns = ["super_practices", "date_update"] searchable_columns = ["id", "name"]mandatory_columnsdefines the list of columns required for displaying and exporting the view’s list.default_extra_columnsdefines the list of columns included in the default exportsearchable_columnsdefines the columns on which it will be possible to perform a search in the view’s list. For example, for outdoor sites, it is possible to search bynameorid, but not bypractice.
Configure form fields in creation views¶
Hidden form fields¶
For each module, use the following syntax to configure fields to hide in the creation form.
Hideable form fields¶
A field can be hidden only if it meets all the following conditions:
It is included in the form’s
fieldslistIt is not required
It is not in the form’s
not_hideable_fieldslist
Avertissement
There are exceptions, for example if a Suricate workflow is enabled.
Be careful with the recommended fields required to publish an object
(COMPLETENESS_FIELDS and COMPLETENESS_LEVEL settings).
They will indeed be hidden, but this can raise an error or a warning when saving.
Exhaustive list of form fields hideable in each module
HIDDEN_FORM_FIELDS["path"] = [
"name",
"stake",
"comfort",
"departure",
"arrival",
"comments",
"source",
"networks",
"usages",
"valid",
"draft",
"reverse_geom",
]
HIDDEN_FORM_FIELDS["trek"] = [
"labels",
"duration",
"difficulty",
"route",
"points_reference",
"parking_location",
"themes",
"networks",
"practice",
"accessibilities",
"accessibility_level",
"information_desks",
"source",
"portal",
"children_trek",
"eid",
"eid2",
"reservation_system",
"reservation_id",
"pois_excluded",
"hidden_ordered_children",
"accessibility_width",
"departure",
"ambiance",
"accessibility_covering",
"accessibility_infrastructure",
"advised_parking",
"published",
"accessibility_slope",
"advice",
"arrival",
"ratings_description",
"access",
"public_transport",
"description_teaser",
"accessibility_exposure",
"description",
"accessibility_signage",
"gear",
"accessibility_advice",
]
HIDDEN_FORM_FIELDS["trail"] = [
"category",
"departure",
"arrival",
"comments",
]
HIDDEN_FORM_FIELDS["landedge"] = [
"owner",
"agreement",
]
HIDDEN_FORM_FIELDS["infrastructure"] = [
"access",
"implantation_year",
"maintenance_difficulty",
"usage_difficulty",
"conditions",
"published",
"description",
"accessibility",
]
HIDDEN_FORM_FIELDS["signage"] = [
"access",
"implantation_year",
"code",
"conditions",
"printed_elevation",
"manager",
"sealing",
"published",
"description",
]
HIDDEN_FORM_FIELDS["blade"] = [
"conditions",
"color",
]
HIDDEN_FORM_FIELDS["intervention"] = [
"end_date",
"disorders",
"type",
"description",
"subcontracting",
"length",
"width",
"height",
"stake",
"project",
"contractors",
"access",
"material_cost",
"heliport_cost",
"contractor_cost",
]
HIDDEN_FORM_FIELDS["project"] = [
"type",
"domain",
"end_year",
"constraint",
"global_cost",
"comments",
"project_owner",
"project_manager",
"contractors",
]
HIDDEN_FORM_FIELDS["site"] = [
"practice",
"labels",
"themes",
"portal",
"source",
"information_desks",
"web_links",
"type",
"parent",
"eid",
"orientation",
"wind",
"managers",
"pois_excluded",
"ambiance",
"published",
"accessibility",
"period",
"description",
"description_teaser",
"advice",
]
HIDDEN_FORM_FIELDS["course"] = [
"type",
"duration",
"pois_excluded",
"points_reference",
"height",
"eid",
"children_course",
"hidden_ordered_children",
"gear",
"published",
"accessibility",
"description",
"advice",
"ratings_description",
"equipment",
]
HIDDEN_FORM_FIELDS["poi"] = [
"eid",
"published",
"description",
]
HIDDEN_FORM_FIELDS["service"] = [
"eid",
]
HIDDEN_FORM_FIELDS["touristic_event"] = [
"place",
"themes",
"end_date",
"duration",
"start_time",
"end_time",
"contact",
"email",
"website",
"organizers",
"speaker",
"type",
"capacity",
"approved",
"source",
"portal",
"eid",
"bookable",
"cancelled",
"cancellation_reason",
"preparation_duration",
"intervention_duration",
"price",
"practical_info",
"published",
"meeting_point",
"target_audience",
"accessibility",
"description",
"description_teaser",
"booking",
]
HIDDEN_FORM_FIELDS["touristic_content"] = [
"type1",
"type2",
"themes",
"contact",
"email",
"website",
"label_accessibility",
"approved",
"source",
"portal",
"eid",
"reservation_system",
"reservation_id",
"practical_info",
"published",
"accessibility",
"description",
"description_teaser",
]
HIDDEN_FORM_FIELDS["report"] = [
"email",
"comment",
"activity",
"category",
"problem_magnitude",
"related_trek",
"status",
"current_user",
"uses_timers",
]
HIDDEN_FORM_FIELDS["sensitivity_species"] = [
"published",
"contact",
"description",
]
HIDDEN_FORM_FIELDS["sensitivity_regulatory"] = [
"elevation",
"published",
"contact",
"pictogram",
"rules",
"period01",
"period02",
"period03",
"period04",
"period05",
"period06",
"period07",
"period08",
"period09",
"period10",
"period11",
"period12",
"url",
"description",
]
Note
By default, the current_user field is hidden in HIDDEN_FORM_FIELDS['report']. To make it visible, set:
HIDDEN_FORM_FIELDS['report'] = []
Configure form fields required or needed for review or publication¶
Completeness level¶
Controls the strictness of completeness checks:
COMPLETENESS_LEVEL = 'warning'
COMPLETENESS_LEVEL = 'error_on_publication'
Info
Set error_on_publication to avoid publication without completeness fields and error_on_review if you want this fields to be required before sending to review.
Completeness fields¶
Define which fields are mandatory before review or publication:
COMPLETENESS_FIELDS = {
'trek': ['practice', 'departure', 'duration', 'difficulty', 'description_teaser'],
'dive': ['practice', 'difficulty', 'description_teaser'],
}
COMPLETENESS_FIELDS = {
'trek': ['practice', 'departure', 'duration', 'difficulty', 'description_teaser'],
'signage': ['code', 'type', 'condition','description','sealing'],
'intervention': ['begin_date', 'end_date', 'status','material_cost','description'],
}