summaryrefslogtreecommitdiff
path: root/docs/_build/html/administration.html
blob: b4c3bb127798057640f824b587c61fc7d85a5f75 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Administration &mdash; Chimère v2.0 documentation</title>
    <link rel="stylesheet" href="_static/default.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '',
        VERSION:     '2.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="top" title="Chimère v2.0 documentation" href="index.html" />
    <link rel="next" title="Import/export" href="import_export.html" />
    <link rel="prev" title="Configuration" href="configuration.html" /> 
  </head>
  <body>
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="import_export.html" title="Import/export"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="configuration.html" title="Configuration"
             accesskey="P">previous</a> |</li>
        <li><a href="index.html">Chimère v2.0 documentation</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="administration">
<span id="id1"></span><h1>Administration<a class="headerlink" href="#administration" title="Permalink to this headline">¶</a></h1>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field"><th class="field-name">Author:</th><td class="field-body">Étienne Loks</td>
</tr>
<tr class="field"><th class="field-name">date:</th><td class="field-body">2012-11-28</td>
</tr>
<tr class="field"><th class="field-name">Copyright:</th><td class="field-body">CC-BY 3.0</td>
</tr>
</tbody>
</table>
<p>This document presents the administration of Chimère.
It has has been updated for version 2.0.0.</p>
<div class="section" id="administration-pages-presentation">
<h2>Administration pages presentation<a class="headerlink" href="#administration-pages-presentation" title="Permalink to this headline">¶</a></h2>
<p>Administration pages are accessible at: <a class="reference external" href="http://where_is_your_chimere/admin/">http://where_is_your_chimere/admin/</a></p>
<p>Don&#8217;t forget the ending slash in the URL.</p>
<div class="section" id="identification">
<h3>Identification<a class="headerlink" href="#identification" title="Permalink to this headline">¶</a></h3>
<p>First of all, you&#8217;ll have to identify yourself with the login and password
provided.</p>
<img alt="_images/chimere_admin_00.png" src="_images/chimere_admin_00.png" />
</div>
<div class="section" id="main-page">
<h3>Main page<a class="headerlink" href="#main-page" title="Permalink to this headline">¶</a></h3>
<p>Once authentified you&#8217;ll have access to the main admin page.</p>
<p>This looks like this:</p>
<img alt="_images/chimere_admin_01.png" src="_images/chimere_admin_01.png" />
<ol class="arabic simple">
<li>links to this <strong>Documentation</strong>, to the <strong>Change password</strong> form and to
<strong>Log out</strong></li>
<li>a list of recent actions made with this account</li>
<li>an application title, most of your action will be in the <strong>Chimere</strong>
application</li>
<li>an item inside the application. From these page you can <strong>Add</strong> a new item or
consult/<strong>Change</strong> items. The <strong>Add</strong> link lead to the new <a class="reference internal" href="#item-form">Item form</a>. The
<strong>Change</strong> link lead to the <a class="reference internal" href="#item-list">Item list</a>. The <a class="reference internal" href="#item-list">Item list</a> is also available
by clicking on the item label.</li>
</ol>
</div>
<div class="section" id="item-list">
<h3>Item list<a class="headerlink" href="#item-list" title="Permalink to this headline">¶</a></h3>
<img alt="_images/chimere_admin_02.png" src="_images/chimere_admin_02.png" />
<ol class="arabic simple">
<li>path in the admin site. This is a convenient shortcut to come back to the
main page.</li>
<li>link to create a new item from the item list</li>
<li>search items by word (not available for all type of items)</li>
<li>this filter box permit to filter current entries with some criteria (not
available for all type of items)</li>
<li>the header of the table is cliquable. Click on an header sort the items by
this header (ascending or descending). Multiple header sort is possible (the
number on the right of the header explain the order of sorting).</li>
<li>each item can be checked (for applying an action) or selected (by clicking on
the first column) to see the detail and possibly edit, delete it.</li>
</ol>
</div>
<div class="section" id="item-form">
<h3>Item form<a class="headerlink" href="#item-form" title="Permalink to this headline">¶</a></h3>
<img alt="_images/chimere_admin_03.png" src="_images/chimere_admin_03.png" />
<ol class="arabic simple">
<li>fields for the selected item (or blank if it is a new item) are displayed in
this form. A few of the fields concerning an item are read-only and a few of
them are hidden. Mandatory fields have their label in bold. Changes on theses
fields are only effective once the form is submitted.</li>
<li>for some items there are associated sub-items. Theses associated items can be
modified in this form. If there are many sub-items associated for the current
item, they can be ordered by drag and drop.</li>
<li>the form has to be validated by one of theses actions buttons. They are
self-explanatory.</li>
</ol>
</div>
<div class="section" id="status">
<h3>Status<a class="headerlink" href="#status" title="Permalink to this headline">¶</a></h3>
<p><em>Status</em> is a property attached to each geographic item in Chimère. To
administrate efficiently Chimère you need to understand the mean of each status.</p>
<ul class="simple">
<li><strong>Submited</strong>: Status of a new item freshly proposed by an end user. This item
is not visible on the map.</li>
<li><strong>Available</strong>: Status of an item visible on the map.</li>
<li><strong>Disabled</strong>: Status of a discarded item.</li>
<li><strong>Modified</strong>: Status of an amendment proposed by an end-user.</li>
<li><strong>Imported</strong>: Status of a newly imported item. Import and export operations
need that all items with <em>imported</em> status are treated (validated, disabled
or deleted).</li>
</ul>
</div>
</div>
<div class="section" id="managing-news">
<h2>Managing news<a class="headerlink" href="#managing-news" title="Permalink to this headline">¶</a></h2>
<p>A news system is available.
All you have to to do is to click on the <strong>Add</strong> button near News.
For each news you have to provided a name and a content. The content can contain
HTML tags.
The availability is set with a checkbox.</p>
</div>
<div class="section" id="creating-categories-subcategories">
<h2>Creating categories/subcategories<a class="headerlink" href="#creating-categories-subcategories" title="Permalink to this headline">¶</a></h2>
<p>Before adding categories you have to set some icons. Theses icons appears on the
map and in the categories&#8217; box on the main map.
Be careful to resize correctly your icons. Indeed the icon will be presented at
their real size on the map.
To add icons: the <strong>Add</strong> button near Icons.</p>
<p>Categories are in fact only containers for subcategories. You&#8217;ll have to provide
only a name and an order.
To add categories: the <strong>Add</strong> button near categories (quite clear now, isn&#8217;t
it?)</p>
<p>Fields of subcategories are: an associated category, a name, an icon, an order,
a color and an element type.
Theses fields are mainly quite self- explanatory.
The color is used to draw routes (if this subcategory contains routes). If it a
basic color it can be set with the English name (for instance: <em>red</em>, <em>blue</em>,
<em>yellow</em> or <em>purple</em>) otherwise you can put the HTML RVB code (for instance
<em>#9227c9</em>).
The element type is the type of element the subcategory can contain: POI, route
or both.</p>
</div>
<div class="section" id="edition-moderation-of-items">
<span id="geographic-items-management"></span><h2>Edition/moderation of items<a class="headerlink" href="#edition-moderation-of-items" title="Permalink to this headline">¶</a></h2>
<p>The moderation step is quite simple. It works the same with POIs and routes.
The moderator can access to all POIs (or routes) by clicking on them on the
list.</p>
<p>A search field is available to search by name but the more interesting is to
filter POIs (or route) by state and by subcategory.</p>
<p>There is a some actions available in the action list.</p>
<ul class="simple">
<li><strong>Delete</strong> to delete selected items. A confirmation step is displayed.</li>
<li><strong>Validate</strong> to set the status <em>Available</em> to selected items.</li>
<li><strong>Disable</strong> to set teh status <em>Disabled</em> to selected items. This is useful to
keep items you don&#8217;t want to be exposed on the map.</li>
<li><strong>Managed modified items</strong> to manage the amendment made by end users on the
main site cf. to <a class="reference internal" href="#managing-modified"><em>Managing end user amendment</em></a>. Modified item has to be treated
one by one.</li>
<li><strong>Export to...</strong> to export selected item to the selected format.</li>
</ul>
<p>To modify an item, classically you have to click on his name.
Then you access to a form to freely modify the item.
In this form there is all data available to the end user form plus some extra
fields.
- The <em>Import fields</em> only make sense with data imported from an external
source or for data to be exported to OSM cf. to the <a class="reference internal" href="import_export.html#importing"><em>import section</em></a> of this documentation.
- <em>Associated items fields</em> are read only fields that list items associated to
the current one (reference item of an amendment, associated file of a route).</p>
<p>Associated multimedia items are at the bottom of the form. You can freely add,
change items and change their order with drag and drop.</p>
<p>Don&#8217;t forget to validate your change with one of the <strong>Save</strong> buttons at the
bottom of the form (it is easily forgot when you change multimedia items).</p>
<p>If an item is not relevant the <strong>Delete</strong> button permit to remove it.</p>
</div>
<div class="section" id="managing-end-user-amendment">
<span id="managing-modified"></span><h2>Managing end user amendment<a class="headerlink" href="#managing-end-user-amendment" title="Permalink to this headline">¶</a></h2>
<p>Amendment can be proposed on the main site by end-users.
In Chimère an amendment is a new item with the status <em>Modified</em> and with a link
to the reference item modified.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">If you are logged as an administrator and make changes on the map with the
end user form there will be directly validated.</p>
</div>
<p>A special form has been developed to facilitate the processing of theses
modified items.</p>
<p>You can access to this special form with the action <em>Managed modified items</em>.</p>
<img alt="_images/chimere_admin_modified_management.png" src="_images/chimere_admin_modified_management.png" />
<p>This form is a table with three columns.</p>
<ol class="arabic simple">
<li>The first column display the information for the reference item.</li>
<li>The second column display the information proposed by the submitter.</li>
<li>The third column is a list of checkboxes. For each row checked, after the
validation, the value of the modified item will replace the value of the
reference item.</li>
</ol>
<p>To reject all modification validate the form with no checkbox checked.</p>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar">
        <div class="sphinxsidebarwrapper">
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">Administration</a><ul>
<li><a class="reference internal" href="#administration-pages-presentation">Administration pages presentation</a><ul>
<li><a class="reference internal" href="#identification">Identification</a></li>
<li><a class="reference internal" href="#main-page">Main page</a></li>
<li><a class="reference internal" href="#item-list">Item list</a></li>
<li><a class="reference internal" href="#item-form">Item form</a></li>
<li><a class="reference internal" href="#status">Status</a></li>
</ul>
</li>
<li><a class="reference internal" href="#managing-news">Managing news</a></li>
<li><a class="reference internal" href="#creating-categories-subcategories">Creating categories/subcategories</a></li>
<li><a class="reference internal" href="#edition-moderation-of-items">Edition/moderation of items</a></li>
<li><a class="reference internal" href="#managing-end-user-amendment">Managing end user amendment</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="configuration.html"
                        title="previous chapter">Configuration</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="import_export.html"
                        title="next chapter">Import/export</a></p>
  <h3>This Page</h3>
  <ul class="this-page-menu">
    <li><a href="_sources/administration.txt"
           rel="nofollow">Show Source</a></li>
  </ul>
<div id="searchbox" style="display: none">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="import_export.html" title="Import/export"
             >next</a> |</li>
        <li class="right" >
          <a href="configuration.html" title="Configuration"
             >previous</a> |</li>
        <li><a href="index.html">Chimère v2.0 documentation</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer">
        &copy; Copyright 2012, Étienne Loks.
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.
    </div>
  </body>
</html>