Difference between revisions of "Rating System"

From MusicBrainz Wiki
m (8 revision(s))
m
Line 3: Line 3:
 
==Description==
 
==Description==
  
Rating is a new feature which has been introduced with the Server release of November 23th, 2008.  
+
Rating is a new feature which has been introduced with the server release of November 23th, 2008.  
  
 
It allows users to rate MusicBrainz entities (artists, labels, releases and tracks).  
 
It allows users to rate MusicBrainz entities (artists, labels, releases and tracks).  
Line 13: Line 13:
 
By default community rating is shown. As soon as user rates an entity, he/she will only see its own rating.  
 
By default community rating is shown. As soon as user rates an entity, he/she will only see its own rating.  
  
''Ratings display can be disabled in User Preferences for those you don't care about ratings''.  
+
''Display of ratings can be disabled in User Preferences for those who don't care about ratings''.  
  
==Colors meaning==
+
==Meaning of the Colors==
  
{| border="1"
+
{|
 
|-
 
|-
 
|  [[Image:star_big_unrated.gif]]  ||  [[Image:star_small_unrated.gif]]  ||  Unrated  
 
|  [[Image:star_big_unrated.gif]]  ||  [[Image:star_small_unrated.gif]]  ||  Unrated  
Line 28: Line 28:
 
|}
 
|}
  
==Web service==
+
==Web Service==
  
 
The [[XML Web Service|XMLWebService]] has been updated in order to allow to retrieve or update rating via WS in a similar way to how [[Folksonomy Tagging|FolksonomyTagging]] works.  
 
The [[XML Web Service|XMLWebService]] has been updated in order to allow to retrieve or update rating via WS in a similar way to how [[Folksonomy Tagging|FolksonomyTagging]] works.  
  
Either by the new /rating resource for submitting/retriving one specific rating: <pre>wget --user=<editor name> --password=<password> --post-data=id=8f6bd1e4-fbe1-4f50-aa9b-94c450ec0f11\&entity=artist\&rating=3 http://test.musicbrainz.org/ws/1/rating
+
Either by the new /rating resource for submitting/retriving one specific rating:
</pre>
+
<code>get --user=<editor name> --password=<password> --post-data=id=8f6bd1e4-fbe1-4f50-aa9b-94c450ec0f11\&entity=artist\&rating=3 http://test.musicbrainz.org/ws/1/rating</code>
  
or by using the new inc parameters <code><nowiki>ratings, user-ratings</nowiki></code> with the artist, label, release or tracks resources as described in [[XML Web Service|XMLWebService]].  
+
or by using the new inc parameters <code>ratings, user-ratings</code> with the artist, label, release or tracks resources as described in [[XML Web Service|XMLWebService]].  
 
[[Category:To Be Reviewed]] [[Category:Documentation]]
 
[[Category:To Be Reviewed]] [[Category:Documentation]]

Revision as of 16:28, 25 March 2009

MusicBrainz Rating System

Description

Rating is a new feature which has been introduced with the server release of November 23th, 2008.

It allows users to rate MusicBrainz entities (artists, labels, releases and tracks).

Details

Each user rating is a number between 1 and 5. Then the system aggregate users ratings to compute the average community rating.

By default community rating is shown. As soon as user rates an entity, he/she will only see its own rating.

Display of ratings can be disabled in User Preferences for those who don't care about ratings.

Meaning of the Colors

star big unrated.gif star small unrated.gif Unrated
star big hover.gif star small hover.gif Hover
star big user-rated.gif star small user-rated.gif User rating
star big community-rated.gif star small community-rated.gif Community rating

Web Service

The XMLWebService has been updated in order to allow to retrieve or update rating via WS in a similar way to how FolksonomyTagging works.

Either by the new /rating resource for submitting/retriving one specific rating: get --user=<editor name> --password=<password> --post-data=id=8f6bd1e4-fbe1-4f50-aa9b-94c450ec0f11\&entity=artist\&rating=3 http://test.musicbrainz.org/ws/1/rating

or by using the new inc parameters ratings, user-ratings with the artist, label, release or tracks resources as described in XMLWebService.