Why make donate

Tutorial

author : Nolwenn Rannou <rannou@codelutin.com>
revision : 2773
date : 2009-09-09 12:05:20 +0200 (mer., 09 sept. 2009)

We will see through an example, how to create a poll with Pollen. The three necessary steps are:

  • creation
  • vote
  • results visualization

Creation

The first step is filling in global information about the poll and its creator. All the fields are not mandatory. The poll type is defined by one of the following terms :

  • Free : everybody can participate
  • Restricted : only a list of voters can participate
  • Group : several lists of voters can participate

The vote counting type corresponds to one of the following :

  • Normal : select 1 or n winners amongst the choices
  • Percentage : attribute a percentage to each choice
  • Condorcet : Rank the choices by preference order (cf Condorcet )
  • Number : awarding a number to each choice
Creation : step 1

The second step allows to specify options for the poll. The questionmark shaped icons display help on the topic :

  • Anonymous poll : Voting persons and their votes are anonymous
  • Allow anonymous vote : Voting persons can be anonymous
  • Continuous results : Poll results are displayed continuously during the vote
  • Public results : Poll results are available for everybody
  • Allow adding choices : You can add choices to the poll
  • Limit the number of choices for each vote : The user can select a limited number of choices
  • Receive notifications emails : An email is sent each n votes to prevent the creator
  • Send reminder emails : An email is sent to remind persons who have not yet voted N hours before poll end
Creation : step 2

The third step is specific to group or restricted polls. If you are logged in you can use predefined list to fill in the groups (the selected poll is shown in grey). Otherwise you have to fill in their names and emails. It is also possible to give a weight to a group or a voter.

Creation : step 3

The fourth step is aimed to fill in the choices for the poll. The choices can be text, date or pictures. It is possible to fill in a description per choices.

Creation : step 4

Once the poll is created, a page indicate two links. The first one is the link to the vote page (to send to the voter, this is automatic if their email was filled in). The second one have to stay private, this is the poll modification link (allows to end the poll also).

Creation : links

Vote

The vote page contains a reminder of the poll informations and a representation of each voter's vote. The poll creator and the voter concerned can modify a vote. If the poll is public, it is possible to see the results. In addition to that, the poll's news can be followed by Atom syndication and it is possible to post comments.

Vote

Results

The results page allows to see a poll's results on a diagram. It shows the poll informations and gives the winner. Several displays are available : pie, 3D pie and ring pie.

Resultats

Other functionalities

A logged in other can access more functionalities. He can see a list of polls he created or participated in. He can create voters lists manually or from LDAP url. An administrator can manage all the polls and users.