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 wallpaper

  • Name 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 under PICTURE_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 the PICTURE_FOLDER, together with the infos.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.