Rating System: Difference between revisions
m (8 revision(s)) |
mNo edit summary |
||
Line 3: | Line 3: | ||
==Description== |
==Description== |
||
Rating is a new feature which has been introduced with the |
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. |
||
'' |
''Display of ratings can be disabled in User Preferences for those who don't care about ratings''. |
||
==Meaning of the Colors== |
|||
==Colors meaning== |
|||
{| |
|||
{| 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 |
==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: |
Either by the new /rating resource for submitting/retriving one specific rating: |
||
<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> |
|||
</pre> |
|||
or by using the new inc parameters <code |
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
Unrated | ||
Hover | ||
User rating | ||
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.