• General settings
  • Generalities
  • Permissions : Users and Groups
    • Users
    • Groups
    • App access by group
    • Publish a map for non-authenticated users, or a dedicated user group
  • Configure a WMS base-map layer
    • Name
    • Display name
    • Layers
    • Crs
    • Style
    • Service
  • Override message records
  • WFS 2
  • Configure base layers for a quick switch (in view and compose)

General settings

Generalities

cartostation’s backend is built with Django.

The admin part is located at /admin, and you must be a registered user with staff permissions to access it.

Permissions : Users and Groups

Can be set up in /admin/auth/

Users

Users can have 4 permission status

• Active
• Staff
• SuperUser
• Group(s)

Active : will activate or de-activate the user account. If unchecked, it doesn’t delete it.
Staff : if checked, it will allow this user to log in the administration page. By default the user won’t be able to do anything. He will need to be part a group with permissions set up to be able to use part of the administration.
Superuser : grant all the permissions to this user.
Group(s) : see below

Groups

You can define groups with specific permissions. The permissions defined in the group page are about functionalities in the administration part.

If a user is part of several groups, it will be granted with the union of the privileges of the groups.

Some specific functionalities can be related to group per apps.

App access by group

CLIENTS configuration accept a “groups” key that takes a list of group names, thus limiting access to these apps to users belonging to these groups.

Publish a map for non-authenticated users, or a dedicated user group

By default, maps created in the studio are either private/draft or published. When a map is set as published it is published only for authenticated users. To publish a map for non-authenticated users, an administrator has to set up a specific permission group in the section admin/api/permissiongroup/.

Configure a WMS base-map layer

In the section admin/webservice/wmslayer/ you can configure WMS layers.

Name

Name is the identifier of this layer, so it’s a good practice to keep it simple and accurate.

Display name

The (multi-lingual) name that might be shown to the users in the client applications.

Layers

Layers is multilingual, which means you can use a different layer per language.
It is also possible to stack layers together.

Crs

Configure the CRS of the WMS.
For now, only EPSG:31370 is supported.

Style

No style yet. But an empty string is needed.

Service

The service you want to connect to.

While you can do it on the fly, you might want to configure a service first :

Override message records

In the section /api/editedrecord/ it is possible to override the default message records used in cartostation.

The key should be structured this way : app_prefix/messageRecord

In any application, by adding ?debug=1 at the end of the url, you enter debug mode, which replace each editable content in the interface by its identifier, so it’s easier to find a specific identifier right from were it is used.

To quit debug mode, simply reload the page.

All the original key:value are stored in the /locale directory of the client applications.

WFS 2

A read-only WFS 2.0 with authentication is accessible on cartostation.

url : [HOST-NAME]/basic-wfs/

TIP : If needed a QGIS plugin is available to connect on a WFS 2.0 : http://plugins.qgis.org/plugins/wfsclient/

Configure base layers for a quick switch (in view and compose)

To get a “quick swich” between two base layers on the map, the chosen base layers have to be define in the admin. To do this, exactly two “highlighted base layers” have to be created in the section admin/api/highlightedbaselayer/. If you create only one, it will not appear. For the moment, the application does not support more than two layers either. This will be done in future developments