1Stars Plugin for DokuWiki
2Use for difficulty, rating, etc
3
4@License: GPL 2 (http://www.gnu.org/licenses/gpl.html)
5@author: Collin "Keeyai" Green - http://keeyai.com
6
7Original code from the Skill plugin by iDo - http://www.dokuwiki.org/plugin:skill
8
9Modified by Keeyai to include some useful changes mentioned in the comments and other functionality
10	- star limit by anon and kenc
11	- span instead of div by anon
12	- new star image instead of transparency
13	- added classes for styling purposes ( span.starspan, img.starimage, img.halfstarimage, img.emptystarimage)
14	- show half stars  (number is floored to the nearest half)
15	- packaged to work with plugin manager
16
17
18Usage:  [stars=num] where num is a number, eg:  5, or a ratio, eg: 5/7
19				limits the number of stars to 10 -- ratios over ten, eg: 100/500,  will be reduced, eg: 2/10
20
21Examples:
22	show 2 stars:						[stars=2]
23	show 3/10 stars:				[stars=3/10]
24	show 4.5/5 stars:				[stars=4.5/5]
25
26Note:
27	to use custom images, just replace the star.png, halfstar.png, and emptystar.png files
28
29TODO:  other image options?  control panel?
30
31
32Change Log:
33
34V 1.1 - 2008-10-28
35	Added bug fixes and changes suggested by Martin Bast on Stars page,
36	including a fix for half stars, changing the pngs to gifs, and
37	an attempt at making relative paths that will work no matter how
38	deep the calling page is. Also tweaked the alt text for the span itself
39	to be more informative.