.. -*- coding: utf-8 -*-

=============
Configuration
=============

:Author: Étienne Loks
:date: 2012-10-08
:Copyright: CC-BY 3.0

This documents presents the first steps to configure your Chimère.

The version has been updated for version 2.0.0.

If an usage to the CLI is required, your session has to be initialised with
theses environment variables::

    CHIMERE_PATH=/srv/chimere # change with your installation path
    CHIMERE_LOCALNAME=mychimere # change with your local project name
    CHIMERE_APP_PATH=$CHIMERE_PATH/$CHIMERE_LOCALNAME


When you have installed the application there is a few simple steps to follow to
configure *your* Chimère.

Most of theses steps are done in the web administration pages.

If you are not familiar with *Django-like* administration pages you can look
at the first paragraph of :ref:`administration` where it is presented.

To access theses pages you have to identify you with an account with *staff* and
*superuser* status.

A *superuser* account is created at the initialization of the database. You can
create a new *superuser* account in the web interface (see the account
management section) or with the CLI::

    ./manage.py createsuperuser


Creating areas
--------------

You probably want to define at least one default area. The configuration of
this area allow you to define the default zoom, welcome message, etc. of your
Chimère.

Creating users
--------------

If you are not the only administrator of this Chimère installation you have to create account for the other users.
Currently the process has to be done manualy.

Simply click on the Add button near Users. Give a name and a default password (the user can change it on in own later).
Then complete the other pieces of information.
Check the case: Member of the staff (or this user will not be able to log to this administration site).
To simply give this user correct rights don't add permission manualy but make this user member of a group.
Two default group are proposed: application administrator and moderator.

Detail of rights for default user/groups:

+-----------------------------------------+-------------------+---------------------------+-----------+
|                  Task                   | Application owner | Application administrator | Moderator |
+=========================================+===================+===========================+===========+
| User add/modify/delete                  |        yes        |            no             |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Group add/modify/delete                 |        yes        |            no             |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Property model add/modify/delete        |        yes        |            no             |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Import add/modify/delete                |        yes        |            no             |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Layer add/modify/delete                 |        yes        |            no             |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| News add/modify/delete                  |        yes        |            yes            |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Area add/modify/delete                  |        yes        |            yes            |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Icon add/modify/delete                  |        yes        |            yes            |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Color/Color theme add/modify/delete     |        yes        |            yes            |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Category/Subcategory add/modify/delete  |        yes        |            yes            |    no     |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Point Of Interest add/modify/delete     |        yes        |            yes            |    yes    |
+-----------------------------------------+-------------------+---------------------------+-----------+
| Route add/modify/delete                 |        yes        |            yes            |    yes    |
+-----------------------------------------+-------------------+---------------------------+-----------+


Creating property models
------------------------

A basic installation of Chimère only permit to associate a name, a category, a
description and (for the point of interest) multimedia files for each point of
interest and each route. You may want to add more fields like phone number or
opening hours. For that all you have to do is to add a new property model.
The administration ask you for name, order (to order between other properties),
availability for the user and type (only text field and long text field are
available for the moment).
Then to make this property available it is necessary to restart your
application (and then probably to reload Apache).
All forms are then automatically updated with this new field.