r0 - 08 Feb 2006 - 04:18:44 - TWikiContributorYou are here: TWiki >  TWiki Web > VotePlugin

VotePlugin

This plugin might be used to establish an online-voting system. Votes are collected in a separate file ... basically inspired by the TWiki:Plugins/PollPlugin.

Example

Drink   
Food   
Drink
Beer
leftbarmainbarrightbar50% (1)
Milk
leftbarmainbarrightbar50% (1)
Food
Pizza
leftbarmainbarrightbar100% (1)

Syntax Rules

The %VOTE{ ... }% macro defines a poll using the following options:

name description example
id The identifier of a poll. This must be unique per topic. You can thus have multiple independent votes on the same topic page. FaroritMeal
style Possible values are a combination of bar, perc, total and sum to specify the display style of the poll results (default bar,perc,total). bar
select<n> As you can see in the above example multiple decisions can be made within the same poll. This identifier must be unique within a poll. You can have up to 5 selects per vote (sorry hardcoded;)) Drinks
options<n> Each select<n> corresponds to set of options that you must specify. Beer,Wine,Milk

select and option might use the pseudo variables $percnt, $dollar, $quote and $doublequote to render the respective characters in the vote output otherwise not allowed in an argument to a TWiki tag.

The %VOTE{ ... }% will generate the selection box(es) and the poll results. The plugin will count only you latest vote. You might only vote once a day.

Plugin Installation Instructions

  • Download the ZIP file
  • Unzip it in your twiki installation directory. Content:
    File: Description:
    bin/vote  
    data/TWiki/VotePlugin.txt  
    lib/TWiki/Plugins/VotePlugin/Core.pm  
    lib/TWiki/Plugins/VotePlugin.pm  
    pub/TWiki/VotePlugin/leftbar.gif  
    pub/TWiki/VotePlugin/mainbar.gif  
    pub/TWiki/VotePlugin/rightbar.gif  

  • (Dakar) Visit configure in your TWiki installation, and enable the plugin in the {Plugins} section.

Plugin Info

Plugin Author: TWiki:Main/MichaelDaum
Copyright ©: 2005-2006, Michael Daum
License: GPL (GNU General Public License)
Plugin Version: v1.32
Change History:  
31 Aug 2006: added NO_PREFS_IN_TOPIC
15 Aug 2006: added "use strict" and fixed revealing errors
27 Apr 2006: added lazy compilation
7 Dec 2005: added gif bar; removed debug flag
9 Oct 2005: fixed invocation of normalizeFileName
8 Oct 2005: added added a little more style flexibility
7 Oct 2005: storing votes into _Vote*.txt now (was Vote*.txt before) ; fixed error messaging on empty argument lists
14 Sep 2005: fixes for dakar
14 Apr 2005: incorporated getLocaldate() function
16 Mar 2005: use Cache API only if its there; delayed use <package>
7 Mar 2005: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.024
CPAN Dependencies: none
Other Dependencies: none
Perl Version: >=5.6.1
TWiki:Plugins/Benchmark: TWiki:TWiki/GoodStyle nn%, TWiki:TWiki/FormattedSearch nn%, VotePlugin nn%
Plugin Home: TWiki:Plugins/VotePlugin
Feedback: TWiki:Plugins/VotePluginDev
Appraisal: TWiki:Plugins/VotePluginAppraisal

-- TWiki:Main.MichaelDaum - 31 Aug 2006

Edit | Attach | Printable | Raw View | Backlinks: Web, All Webs | History:  | More topic actions
 
Powered by TWiki
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.VotePlugin