aboutsummaryrefslogtreecommitdiff
path: root/doc/ikiwiki
diff options
context:
space:
mode:
authorJoey Hess <joeyh@joeyh.name>2018-11-26 13:14:21 -0400
committerJoey Hess <joeyh@joeyh.name>2018-11-26 13:14:21 -0400
commit97d921ca676d51279b9fdfbaa7501fc8ebf8a027 (patch)
treec0a822a7205bf701a71251fb39b4af2b1c91d684 /doc/ikiwiki
parent11d5b5c5ea6193e6c6f219b021883a6424b23d38 (diff)
downloadikiwiki-97d921ca676d51279b9fdfbaa7501fc8ebf8a027.tar
ikiwiki-97d921ca676d51279b9fdfbaa7501fc8ebf8a027.tar.gz
poll: Added postvote and posttrail options for better multi-page polls.
Modern web users probably expect the poll to move on automatically to the next question, and this allows for that behavior. Note that bestlink() runs at vote time, which avoids needing to make the page containing the poll depend on the page that sets up a trail, as the current trail at vote time will be used. This commit was sponsored by Eric Drechsel on Patreon.
Diffstat (limited to 'doc/ikiwiki')
-rw-r--r--doc/ikiwiki/directive/poll.mdwn7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/ikiwiki/directive/poll.mdwn b/doc/ikiwiki/directive/poll.mdwn
index 0b47a2167..7b9fdfdc5 100644
--- a/doc/ikiwiki/directive/poll.mdwn
+++ b/doc/ikiwiki/directive/poll.mdwn
@@ -23,5 +23,12 @@ Parameters:
another choice to the poll.
* `total` - Show total number of votes at bottom of poll. Default is "yes".
* `percent` - Whether to display percents. Default is "yes".
+* `postvote` - By default after voting the updated page containing the poll
+ is displayed. This parameter allows advancing onward to another page.
+ This is useful for multi-page polls.
+* `posttrail` - Similar to postvote, but allows advancing to the next page
+ on a trail after a vote. The value of the parameter is the name of the
+ page that defines the trail to follow. The trail plugin must be
+ enabled for this to work.
[[!meta robots="noindex, follow"]]