====== Stars2 Plugin ======

---- plugin ----
description: The Stars2 plugin let you add Rating, Difficulty, etc. stars
author     : Zahno Silvan
email      : zaswiki@gmail.com
type       : syntax
lastupdate : 2020-07-07
compatible : Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
depends    : 
conflicts  : 
similar    : 
tags       : rating, difficulty, toolbar

screenshot_img: https://raw.githubusercontent.com/tschinz/dokuwiki_stars_plugin/master/logo.png
downloadurl:    https://github.com/tschinz/dokuwiki_stars_plugin/zipball/master
bugtracker:     https://github.com/tschinz/dokuwiki_stars_plugin/issues
sourcerepo :    https://github.com/tschinz/dokuwiki_stars_plugin
donationurl:    https://www.paypal.com/ch/cgi-bin/webscr?cmd=_flow&SESSION=-NSXfGE9ibV605du5x-XY0T3UrOotHWgwxkRHN2lQ8d9u-HIOxhoEvM0Rg0&dispatch=5885d80a13c0db1f8e263663d3faee8d0b7e678a25d883d0fa72c947f193f8fd
----

This Plugin was inspired by the original stars plugin. The improvements contain a better compatibility, nicer graphics, a toolbar integration and more syntax options.

{{https://raw.github.com/tschinz/dokuwiki_stars_plugin/master/images/fullstar.png?recache}}{{https://raw.github.com/tschinz/dokuwiki_stars_plugin/master/images/halfstar.png?recache}}{{https://raw.github.com/tschinz/dokuwiki_stars_plugin/master/images/emptystar.png?recache}}

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. 

Or refer to [[:Plugins]] on how to install plugins manually:

  * Download "Stars2 plugin" and unzip file locally
  * Transfer to server holding Dokuwiki
    * Copy subfolder "stars" to: ..your..dokuwiki.../lib/plugins

===== Syntax/Usage =====

Stars can be created with two methods:
  - With the Toolbarbutton Stars 1-5
  - With **Syntax code as shown below**

<code>
{{stars>num}}
{{stars>}}
{{stars>-1/5}}
{{stars>-5/5}}
{{stars>1/5}}
{{stars>2/5}}
{{stars>3/5}}
{{stars>4/5}}
{{stars>5/5}}
{{stars>5.5/7}}
{{stars>700/1000}}
</code>

===== Possible Problems =====

=== No Toolbar button ===

Did you install another Toolbar plugin? It only works with the original toolbar

===== Change Log =====

  * **2011-03-18**
    * Initial release
  * **2012-01-10**
    * Added negative rating to get ? stars, as "Not Yet Rated" option
  * **2012-09-25**
    * DarkGlass Icons
    * Fixed Toobar bug with Angua
      * Thanks to  [[fabrice@chtiland.com|Fabrice]]
  * **2012-10-22**
    * Moved repo to github
  * **2014-10-02**
    * Changed internal plugin name to stars2 (for autoupdate)
    * Added support for the [[odt|ODT export plugin]] thanks to LarsDW223
    * Added feature for resizing the images over a config panel setting
  * **2016-01-21**
    * Added better compatibility to other plugins by kernam
  * **2016-09-02**
    * Bugfix for Height adjustment by @borco
    * Bugfix for php 7.0 compatibility by @LarsGit223
  * **2018-04-01**
    * Bugfix for register and handle method thanks to @sag1
    * Bugfix for php 7.0 compatibility by @LarsGit223
  * **2020-07-07**
    * Bugfix for register and handle method thanks to @leperm

===== Known Bugs and Issues =====

Let me know

===== ToDo/Wish List/Discussions/Issues =====

Issue Tracker on github -> [[https://github.com/tschinz/dokuwiki_stars_plugin/issues|here]]


===== Thanks =====

  * Dark Glass - http://kde-look.org/usermanager/search.php?username=mentalrey