History of StarsPackage

Differences from version 3 to 9



@@ -1,18 +1,17 @@

+{r2}
 {maketoc}
 Stars is a simple rating package that allows you to rate content.
 
 ! What can it do?
-The package is still very young and undergoing some major development. Currently it allows you to rate content that fully support LibertyServices. most packages in the development branch support services fully. i have just made ajax optional and text-browsers will automagically see the non-ajax version. if someone knows of an easy and decent way of checking if javascript is enabled, i will use this to use html rather than javascript for ratings in such browsers.
-
-Stars is the first service that allows content based use. By this i mean that you can specify what content types can be rated and which ones can't.
+StarsPackage allows you registered users to rate the content on your homepage. Rating can be controlled on a per content type basis. This means that you can allow users to rate only specific content types. e.g.: wiki pages and articles but nothing else or only images in fisheye and comments or ...
 
 ! Possible settings
-Several settings are already available in the Stars package which include:
+Several settings are available in the Stars package which include:
 * Specify the number of stars that you want to use for ratings. can be as many as 100 if you wish to do so.
 * Specify number of ratings required before the results are shown.
 * You need to be logged in to be able to rate. This is needed to keep a log of all the ratings in the past (see below).
-* optionally use ajax to update stars after rating.
-* Icon dimensions can be set, making it ridiculously easy to use your own icon without having to adjust a singe value in the css.
+* Optionally use ajax to update stars after rating.
+* Icon dimensions can be set, making it ridiculously easy to use your own icon without having to manually adjust a singe value in the css (see below).
 * Rating calculations can be weighted according to user importance. You can specify how important the following are to you:
 ** User age: How long a user has been a member of your site - relative to the age of your site.
 ** Permission weight: This calculation takes the number of permissions a user has into account.

@@ -21,19 +20,26 @@

 
 When you change any of these settings, you have the option to recalculate all the ratings on your site to make the changes ''fair''.
 
-all values are normalised to 100 regardless of your settings. this means that all of the above calculations can be done on the fly using the history and returning an accurate value.
+All values are normalised to 100 regardless of your settings. This means that all of the above calculations can be done on the fly using the history and returning an accurate value. This also means that someone might want to develop a package that ties in with StarsPackage and uses the ratings to trigger something.
 
-! ToDo
+!! Changing Stars Icon
+It is easy to use your own icon for stars. Here i will describe the steps needed to use your own icon without replacing the original:
+# Copy the sample icon from __stars/icons/stars_small.gif__ to __themes/force/stars/stars.gif__ (please note that the icon was renamed from stars_small.gif to stars.gif).
+# Go to the stars admin panel (/kernel/admin/index.php?page=stars) and enter the following icon sizes: __width:10__ and __height:10__.
+# You're already done!
+Placing the icon in themes/force will override all themes in bitweaver. This is recommended since the icon settings are used system wide as well. If you prefer, you can place the icon in your custom themes: themes/styles/<custom_theme>/stars/stars.gif
+
+! Future?
 After some time and testing of the weighting (karma) calculations, we can add a feature by which badly rated content can be hidden or even removed from the site. This is done quite easily using our setup, but we first need to get the package tested for a while to evaluate the weighting algorithm.
 
-the current calculation is as follows:
-{code}
+{code title="Current karma user weighting calculations"}
 round( log( $age * $permission * $activity, 2 ) )
 // where the following is true:
 $age = ( age of user ) / ( age of site ) * ( age weight preference )
 $permission = ( number of user permissions ) / ( total number of permissions ) * ( permission weight preference )
 $activity = ( number of content created by user ) / ( total content count ) * ( activity weight preference )
 {/code}
-$activity will probably be changed to take the history into account as well.
 
-perhaps add a permission for rating if wanted.
+# $activity might be changed to take the history into account as well.
+# perhaps add a permission for rating if wanted.
+
Page History
Date/CommentUserIPVersion
30 Jun 2008 (09:31 UTC)
Rollback to version 7 by laetzer
Kozuch85.207.244.1609
Current • Source
jin62.80.184.1788
View • Compare • Difference • Source
Kozuch85.207.244.1607
View • Compare • Difference • Source
Unknown82.182.15.845
View • Compare • Difference • Source
xing194.152.164.454
View • Compare • Difference • Source
xing194.152.164.453
View • Compare • Difference • Source
xing194.152.164.452
View • Compare • Difference • Source
xing194.152.164.451
View • Compare • Difference • Source