Administrate¶
Account Types¶
Nuancier has two types of accounts:
- administrators
- users
Administrators¶
Administrators are people with an account on the Fedora Account System (FAS) who belong to one of the administrator groups as set in the Configuration.
Administrators are the only people allowed to create an election, open or close it for votes, open or close the results and generate the cache (thumbnails).
Users¶
Users are people with an account on the
Fedora Account System (FAS) who
belong to the fedora_cla
group as well as one additional group. All
contributing users should be part of the fedora_cla
group once they
have signed it.
Upload new pictures for an election¶
All users can contribute candidates to an election by clicking on the
contribute
tab. On that page you can find a list of the rules,
allowable subject matter, composition, and technical requirements regarding
the submitted images. At the bottom of you page you can see elections that are
currently accepting submissions.
When submitting an image you will need to provide the following:
- Title
- Author
- URL of the original work
- File location
- License type
Note: Files are limited to a max size of 16 MB.
Administration panel¶
After logging in, if you are in the administrator group, you will see an
Admin
entry in the menu.
If you click on this Admin
link you will arrive to the index page of the
administration panel.
This page shows you all elections registered with their information and for each if they are open for vote or not and if their results are public or not. It offers the possibility to (re-)generate the cache for an election and once the election is closed, a link to some statistics about it.
Create elections¶
Click on the link Create a new election
from the administration panel.
The form to will ask for:
election name
: the name of the election, this will be used as link throughout the application. Example name might be : Fedora 20 wallpaperName of the folder containing the pictures
: this specifies the name of the folder containing the pictures for that election that has been placed in the folder specified underPICTURE_FOLDER
in Configuration.Note
It is a good idea to keep this name simple, unique, ascii and without spaces.
Year
: the year the election is taking place, this is purely for information.Open
: This is a checkbox to specify whether this election is already open for votes or not.URL to claim a badge for voting
: This allows to specify a link where people will be able to go to collect a badge announcing that they participated in this election. You should coordinate with the people of the badge project to get this link.Number of votes a user can make
: This specifies the number of choices a user can make for this election. For example, if a user is allowed to select only 16 wallpapers, then this field should be 16.Generate cache
: This is a checkbox offering to generate the cache assuming the pictures have already been placed on thePICTURE_FOLDER
, together with theinfos.txt
file.
Open/Close election for votes¶
Once an election is opened for vote or has ended, the administrator can
simply log into nuancier, go to the administration panel, find the
correct election and on the Open column click on the toggle
link.
If fedmsg is installed on the server, fedmsg messages are published for these events.
Publish results of an election¶
Once an election has ended the results will be published automatically. If fedmsg is installed on the server, fedmsg messages are published for these events.
Generate cache¶
In order to reduce the size(and hence the loading time) of the page where all the candidates of an election are shown, nuancier generates thumbnails.
To generate the cache of an election, the administrator needs to log in
nuancier, go to the administration panel, find the correct election
and click on the (Re-)generate cache
.