[Sommaire] [Imprimer]

   1  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2  <html>
   3  <head>
   4    <title>Geeklog Documentation - Polls Plugin</title>
   5    <link rel="stylesheet" type="text/css" href="docstyle.css" title="Dev Stylesheet">
   6  </head>
   7  
   8  <body>
   9  <table>
  10  <tr>
  11    <td><a href="index.html" style="background:transparent"><img src="images/newlogo.gif" alt="Geeklog Documentation" width="243" height="90" border="0"></a></td>
  12  </tr>
  13  <tr>
  14    <td class="menu"><a href="index.html">Geeklog Documentation</a> - Polls Plugin</td>
  15  </tr>
  16  </table>
  17  
  18  <h1>Polls Plugin</h1>
  19  
  20  <p>Polls used to be an integral part of the Geeklog core code, but have been
  21  moved to a plugin as of Geeklog 1.4.0.</p>
  22  
  23  <h2><a name="config.php">Configuration File</a></h2>
  24  
  25  <p>The polls plugin has its own configuration file, located at <tt>/path/to/geeklog/plugins/polls/config.php</tt>. There you will find the following options:</p>
  26  
  27  <table>
  28  <tr><th width="25%">Variable</th>
  29      <th width="25%">Default Value</th>
  30      <th width="50%">Description</th>
  31  </tr>
  32  <tr>
  33    <td><a name="desc_pollsloginrequired">pollsloginrequired</a></td>
  34    <td>0</td>
  35    <td>When set to 1, only registered users can access the list of recent
  36      polls.<br>
  37      Please note that <code>$_CONF['<a
  38      href="config.html#desc_loginrequired">loginrequired</a>']</code> in
  39      <tt>config.php</tt> takes precedence over this setting. So when
  40      <code>'loginrequired'</code> is set to 1, anonymous users can not access
  41      the recent polls even when <code>'pollsloginrequired'</code> is set
  42      to 0.</td>
  43  </tr>
  44  <tr class="r2">
  45    <td><a name="desc_hidepollsmenu">hidepollsmenu</a></td>
  46    <td>0</td>
  47    <td>Whether to hide the "Polls" entry from Geeklog's menu bar (when set to 1)
  48      or to show it (when set to 0).</td>
  49  </tr>
  50  <tr>
  51    <td><a name="desc_maxanswers">maxanswers</a></td>
  52    <td>10</td>
  53    <td>Maximum number of possible answers for the poll editor.</td>
  54  </tr>
  55  <tr class="r2">
  56    <td><a name="desc_answerorder">answerorder</a></td>
  57    <td>submitorder</td>
  58    <td>Sort answers by the number of results ('voteorder') or keep the order 
  59      in which they were entered ('submitorder').</td>
  60  </tr>
  61  <tr>
  62    <td><a name="desc_pollcookietime">pollcookietime</a></td>
  63    <td>86400</td>
  64    <td>Number of seconds to set a poll answer cookie to time out on.</td>
  65  </tr>
  66  <tr class="r2">
  67    <td><a name="desc_polladdresstime">polladdresstime</a></td>
  68    <td>604800</td>
  69    <td>Number of seconds to set a poll answer IP address to time out on.</td>
  70  </tr>
  71  <tr>
  72    <td><a name="desc_delete_polls">delete_polls</a></td>
  73    <td>0</td>
  74    <td>Defines what to do when a user is deleted that is the owner of a poll.
  75      When set to 0, all polls owned by the deleted user will be assigned to a
  76      user of the "Root" group (e.g. the site admin). When set to 1, the polls
  77      are deleted, including all the comments posted on that poll.</td>
  78  </tr>
  79  </table>
  80  
  81  <h2>How do the polls work?</h2>
  82  
  83  <p><small>(Taken from the <a href="http://www.geeklog.net/faqman/">Geeklog
  84  FAQ</a>)</small></p>
  85  
  86  <p>In order to prevent manipulation of polls (or at least make it harder),
  87  Geeklog does two things when you vote:</p>
  88  
  89  <ol>
  90    <li>It stores a cookie</li>
  91    <li>It stores your IP address</li>
  92  </ol>
  93  
  94  <p>Both the cookie and the IP are valid for a certain amount of time (see below)
  95  and during that time, you can't vote again on the same poll.</p>
  96  
  97  <p>The amount of time your cookie and IP are stored can be changed in the polls
  98  plugin's <tt>config.php</tt>:</p>
  99  
 100  <pre>$_PO_CONF['pollcookietime']    = 86400;
 101  $_PO_CONF['polladdresstime']   = 604800;</pre>
 102  
 103  <p>Both times are in seconds, i.e. the cookie is valid for 24 hours and the IP
 104  is stored for a week.</p>
 105  
 106  <p>In setups where more than one person uses the same computer or the same IP
 107  address, you can set one (or both) of them to 1.</p>
 108  
 109  <p>Please keep in mind that <strong>any</strong> poll can be manipulated, so
 110  you shouldn't take the results too seriously.</p>
 111  
 112  
 113  <table class="footer">
 114  <tr>
 115    <td colspan="2"><a href="http://wiki.geeklog.net/">The Geeklog Documentation Project</a><br>
 116      All trademarks and copyrights on this page are owned by their respective owners. GeekLog is copyleft.</td>
 117  </tr>
 118  </table>
 119  
 120  </body>
 121  </html>