• General settings
  • Generalities
  • Permissions : Users and Groups
    • Users
    • Groups
    • App access by 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
  • Maintenance Events

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.

Transparency in Atlas

We think it’s good practice to carefully choose the transparency in the Studio so that the user will not have to deal with it in the Atlas. But the possibility exists in the administration platform to add a widget to the atlas for some chosen layers, to let change the transparency in the Atlas. You only need to check the “Opacity selector” option in the layer page (section admin/api/layerinfo/).

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. 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

Maintenance Events

To prevent the use of the platform during a maintenance period, it’s possible to define a maintenance event. Therefore, a ‘maintenance’ group has to be defined in the admin (see ‘groups’). You can add any user in this group. This group has to be mentioned in the settings under the key MAINTENANCE_GROUP_NAME.

During the maintenance period, this page will be shown for all users but the ones in the maintenance group. The event itself has to be defined in the administration platform. An announcement should be defined, that will be shown between its start date and the start of the maintenance event, under the header of the app.

It is also possible to define a specific message for a given app, that will be shown during a given period.