clear sandbox/test commit
[ikiwiki.git] / doc / ikiwiki / directive / poll.mdwn
blob6aa3d2ceacf967c6441013765956fa2987451360
1 The `poll` directive is supplied by the [[!iki plugins/poll desc=poll]] plugin.
3 This directive allows you to create online polls in the wiki. Here's an
4 example use:
6         \[[!poll 0 "red" 0 "green" 0 "blue"]]
8 The numbers indicate how many users voted for that choice. When a user
9 votes for a choice in the poll, the page is modified and the number
10 incremented.
12 While some basic precautions are taken to prevent users from accidentially
13 voting twice, this sort of poll should not be counted on to be very
14 accurate; all the usual concerns about web based polling apply. Unless the
15 page that the poll is in is locked, users can even edit the page and change
16 the numbers!
18 Parameters: 
20 * `open` - Whether voting is still open. Set to "no" to close the poll to
21   voting.
22 * `total` - Show total number of votes at bottom of poll. Default is "yes".
23 * `percent` - Whether to display percents. Default is "yes".
25 [[!meta robots="noindex, follow"]]