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

%VOTE{id="FavoritMeal" style="bar" select1="Drink" options1="Beer,Wine,Milk,Water" select2="Food" options2="Steak,Bread,Pasta,Pizza"}%

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 Settings

• Set SHORTDESCRIPTION = Simple way to count votes

Plugin Installation Instructions

• Download the ZIP file from the Plugin web (see below)
• Unzip VotePlugin.zip in your twiki installation directory. Content:

  File:	Description:
  bin/vote	Plugin cgi script
  data/TWiki/VotePlugin.txt	Plugin topic
  lib/TWiki/Plugins/VotePlugin.pm	Plugin Perl module

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

Plugin Info

Plugin Author:	TWiki:Main/MichaelDaum
Plugin Version:	v1.21 (2005-10-09)
Change History:
2005-10-09	fixed invocation of normalizeFileName
2005-10-08	added added a little more style flexibility
2005-10-07	storing votes into _Vote*.txt now (was Vote*.txt before) ; fixed error messaging on empty argument lists
2005-09-14	fixes for dakar
2005-03-14	incorporated getLocaldate() function
2005-03-16	use Cache API only if its there; delayed use <package>
2005-03-07	Initial version
TWiki Dependency:	$TWiki::Plugins::VERSION 1.024
CPAN Dependencies:	none
Other Dependencies:	security patches from TWiki:Codev/UncoordinatedSecurityAlert23Feb2005
Perl Version:	>=5.6.1
License:	GPL (GNU General Public License)
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 - 9 Oct 2005

This topic: TWiki > VotePlugin
Topic revision: 17 Oct 2012, UnknownUser

---