History: Poll Admin

Source of version: 10 (current)

!Polls Admin

-=Settings Documentation=-

{picture file=img/icons/admin_polls.png}
Clicking the __Polls__ icon on the __Admin Panel__ (see ((Tiki Config)) ) takes you to the Polls settings.
!Configure Polls

You can set up polls using this panel.

::{picture file=img/wiki_up/PollSettings.png}::

You can create/display and use as many polls as you want, to admin polls use the polls link from the admin section in the application menu. (tiki-admin_polls.php)

!Creating/editing polls 

{img src="img/wiki_up/poll1.jpg" }

In this screen you can edit/create new polls and remove existing polls, to create a poll you have to indicate the title the type of polls and the publishDate, the type can be:
* Active: The poll can be voted The form to vote can be displayed in a user module using ~np~{poll id=n}~/np~
* Current: The poll can be voted and can be selected to be shown in a module using ~np~{poll}~/np~ without indicating an id. It can also be displayed using ~np~{poll id=n}~/np~
* Closed: The poll is closed it won t be displayed and the users can t vote this poll any more. Results can be seen.
* object: ?
* templates: The poll can be used in a wiki rating. If used, a new poll will be created with the name given in the wiki rating setting

The publishDate is used to control when the poll will be enabled, you can program polls for the future if you want. A poll can t be viewed/voted/anything until the current date is greater on equal than then poll publishingDate.

Some special links are also provided:
* ''Close all polls but last''  will close all polls except the last one.
* ''Set last poll as current''  will set the last poll as the current poll
* ''Activate all polls''  will make all polls active

If you click  activate all polls  and  set last poll as current  you will have all polls active and the last one being the current poll. If you click  close all polls but last  and  set last poll as current  you will have all polls closed and the last one being the current one (only the current poll can be voted in this scheme) 

To edit the options in a poll clikc in the  options  link from the poll listing: 

__''insert graphic''__

In this screen you will see a preview of the poll, a form to edit/add an option to a poll and the list of options, you can edit options, remove options and add options to a poll as you want.

!Using polls 
!!user modules
Once created the form to vote a poll can be displayed using user modules, the syntax to include a poll can be: 

~np~{poll}~/np~ 

This will display a random poll from the list of polls with type =  current  and that have been published. 

~np~{poll id=n}~/np~ 

This can be used to dsiplay any active or current poll indicating the id of the poll to displayed.
!!in wiki pages
You can also activate Rating in the wiki admin panel and choose a poll at edit time.

Note: for version 2.2 (and possibly others) a poll template selected in the Wiki edit screen will only be saved to the database if the Categories feature is enabled.

__This page needs:__

Description of whether it's possible to see which user voted for what option.  Had a user sign up multiple accounts to cheat on a poll, and would like to remove his votes from the results.