aboutsummaryrefslogtreecommitdiff
path: root/underlays/basewiki/directive/poll.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'underlays/basewiki/directive/poll.mdwn')
-rw-r--r--underlays/basewiki/directive/poll.mdwn23
1 files changed, 23 insertions, 0 deletions
diff --git a/underlays/basewiki/directive/poll.mdwn b/underlays/basewiki/directive/poll.mdwn
new file mode 100644
index 000000000..d27329c72
--- /dev/null
+++ b/underlays/basewiki/directive/poll.mdwn
@@ -0,0 +1,23 @@
+The `poll` directive is supplied by the [[!iki plugins/poll]] plugin.
+
+This directive allows you to create online polls in the wiki. Here's an
+example use:
+
+ \[[!poll 0 "red" 0 "green" 0 "blue"]]
+
+The numbers indicate how many users voted for that choice. When a user
+votes for a choice in the poll, the page is modified and the number
+incremented.
+
+While some basic precautions are taken to prevent users from accidentially
+voting twice, this sort of poll should not be counted on to be very
+accurate; all the usual concerns about web based polling apply. Unless the
+page that the poll is in is locked, users can even edit the page and change
+the numbers!
+
+Parameters:
+
+* `open` - Whether voting is still open. Set to "no" to close the poll to
+ voting.
+* `total` - Show total number of votes at bottom of poll. Default is "yes".
+* `percent` - Whether to display percents. Default is "yes".