Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

UNKNOWN

Project description

A TiddlyWeb plugin that provides the ability for users to score tiddlers.
Can use for rating a tiddler (1-5 or +1/-1)

##########
##usage###
##########
/tiddlyvoting?title=<title>&bag=<bag>&value=<value>
on the tiddler with title <title> in bag <bag> the field tiddlyvotes.total will be incremented by <value> and the field tiddlyvotes.mode will be updated with a number representing the most commonly used value and tiddlyvotes.average will be the average of all values applied to that tiddler

to work, the user must have read access to the bag <bag>

###########
##data accuracy####
###########
Obviously if someone has write access to a bag they can manually alter the rating on the given tiddler.
To prevent this a tiddler validator is installed. It will detect any changes to tiddlyvoting and make sure the result has not been tampered with.
Just make sure the bag you are allowing voting on is setup to use validators (make sure ACCEPT in the policy is ['NONE'])
As a result you cannot use the tiddlyvoting.total,tiddlyvoting.mode or tiddlyvoting.average fields on any tiddler for another purpose.

###########
##config####
###########
You can define more complex behaviours by using tiddler slices in the text of a tiddler called config::<bagname> in the tiddlyvoting bag.
So far the behaviours you can define are...
increment.range::0,10
increment.limit:2

increment.range sets the values which can be used for voting. In the above example any votes of value greater than 10 or less than 0 do not count.
increment.limit limits the votes a single user can cast on any tiddler. So if a user tries to vote a 3rd time in the above example the vote will be rejected

###########
##license####
###########
This package is licensed under the same terms as TiddlyWeb itself.

Project details


Release history Release notifications

This version
History Node

0.441

History Node

0.251

History Node

0.44

History Node

0.41

History Node

0.25

History Node

0.4

History Node

0.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
tiddlywebplugins.voting-0.441.tar.gz (12.9 kB) Copy SHA256 hash SHA256 Source None Aug 8, 2010

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page