1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <title>Geeklog Documentation - Polls Plugin</title>
5 <link rel="stylesheet" type="text/css" href="../docstyle.css" title="Dev Stylesheet">
9 <p><a href="http://www.geeklog.net/" style="background:transparent"><img src="../images/newlogo.gif" alt="Geeklog" width="243" height="90"></a></p>
10 <div class="menu"><a href="index.html">Geeklog Documentation</a> - Polls Plugin</div>
14 <p>Polls used to be an integral part of the Geeklog core code, but have been
15 moved to a plugin as of Geeklog 1.4.0.</p>
17 <h2><a name="config.php">Configuration</a></h2>
19 <p>The Polls plugin's configuration can be changed from the Configuration admin
22 <h3><a name="general">General Polls Settings</a></h3>
25 <tr><th style="width:25%">Variable</th>
26 <th style="width:25%">Default Value</th>
27 <th style="width:50%">Description</th>
30 <td><a name="desc_pollsloginrequired">pollsloginrequired</a></td>
32 <td>When set to 1, only registered users can access the list of recent
34 Please note that <code>$_CONF['<a
35 href="config.html#desc_loginrequired">loginrequired</a>']</code> in
36 Geeklog's main configuration takes precedence over this setting. So when
37 <code>'loginrequired'</code> is set to 1, anonymous users can not access
38 the recent polls even when <code>'pollsloginrequired'</code> is set
42 <td><a name="desc_hidepollsmenu">hidepollsmenu</a></td>
44 <td>Whether to hide the "Polls" entry from Geeklog's menu bar (when set to 1)
45 or to show it (when set to 0).</td>
48 <td><a name="desc_maxquestions">maxquestions</a></td>
50 <td>Maximum number of questions in a poll.</td>
53 <td><a name="desc_maxanswers">maxanswers</a></td>
55 <td>Maximum number of options per question.</td>
58 <td><a name="desc_answerorder">answerorder</a></td>
60 <td>Sort answers by the number of results ('voteorder') or keep the order
61 in which they were entered ('submitorder').</td>
64 <td><a name="desc_pollcookietime">pollcookietime</a></td>
66 <td>Number of seconds to set a poll answer cookie to time out on.</td>
69 <td><a name="desc_polladdresstime">polladdresstime</a></td>
71 <td>Number of seconds to set a poll answer IP address to time out on.</td>
74 <td><a name="desc_delete_polls">delete_polls</a></td>
76 <td>Defines what to do when a user is deleted that is the owner of a poll.
77 When set to 0, all polls owned by the deleted user will be assigned to a
78 user of the "Root" group (e.g. the site admin). When set to 1, the polls
79 are deleted, including all the comments posted on that poll.</td>
82 <td><a name="desc_aftersave">aftersave</a></td>
84 <td>Which page to go to after a poll has been saved:
86 <li>'item': display the poll</li>
87 <li>'list': show admin's list of polls (default)</li>
88 <li>'plugin': display the public list of polls</li>
89 <li>'home': display the site's homepage</li>
90 <li>'admin': go to the "Admin Home" page, i.e. Command & Control</li>
94 <td><a name="desc_meta_tags">meta_tags</a></td>
96 <td>Whether to include the meta tags of the poll when it is displayed.</td>
100 <h2>How do the polls work?</h2>
102 <p><small>(Taken from the <a href="http://www.geeklog.net/faqman/">Geeklog
105 <p>In order to prevent manipulation of polls (or at least make it harder),
106 Geeklog does two things when you vote:</p>
109 <li>It stores a cookie</li>
110 <li>It stores your IP address</li>
113 <p>Both the cookie and the IP are valid for a certain amount of time (see below)
114 and during that time, you can't vote again on the same poll.</p>
116 <p>The amount of time your cookie and IP are stored can be changed in the polls
117 plugin's configuration (see above):</p>
119 <pre>$_PO_CONF['<a href="#desc_pollcookietime">pollcookietime</a>'] = 86400;
120 $_PO_CONF['<a href="#desc_polladdresstime">polladdresstime</a>'] = 604800;</pre>
122 <p>Both times are in seconds, i.e. the cookie is valid for 24 hours and the IP
123 is stored for a week.</p>
125 <p>In setups where more than one person uses the same computer or the same IP
126 address, you can set one (or both) of them to 1.</p>
128 <p>Please keep in mind that <strong>any</strong> poll can be manipulated, so
129 you shouldn't take the results too seriously.</p>
132 <h2><a name="autotags">Autotags</a></h2>
134 <p>The Polls Plugin provides 3 <a href="http://www.geeklog.net/article.php/autolinks" title="geeklog.net: About Autolinks and Autotags">autotags</a>,
135 <code>[poll:]</code>, <code>[poll_result:]</code>, and <code>[poll_vote:]</code>.</p>
138 <li>The <code>[poll:]</code> autotag will provide a link to a poll. Simply add
139 the poll's ID after the colon. By default, the poll's title will be used as the
140 link text. You can provide your own link text after the poll ID (but before the
141 closing bracket).</li>
142 <li>The <code>[poll_result:]</code> autotag lets you embed the results from a
143 poll in a story (or anywhere else where autotags are allowed).</li>
144 <li>The <code>[poll_vote:]</code> autotag can be used to embed a poll into an
145 article (or anywhere else where autotags are allowed) so that users don't need
146 to go to the polls block to vote.</li>
151 <a href="http://wiki.geeklog.net/">The Geeklog Documentation Project</a><br>
152 All trademarks and copyrights on this page are owned by their respective owners. Geeklog is copyleft.