Rating System: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
mNo edit summary
(preference to hide ratings currently doesn't exist (https://tickets.metabrainz.org/browse/MBS-4089))
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=MusicBrainz Rating System=

==Description==
==Description==


The rating system allows users to rate MusicBrainz entities (artists, labels, releases and tracks).
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==
==Details==


Each user rating is a number between 1 and 5. Then the system aggregate users ratings to compute the average community rating.
User may assign a value between 1 and 5 to various entities as a rating, these values are then aggregated by the server to compute an average community rating for that same entity.

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


The community rating is shown by default for each entity, however, once a user submits their own rating that value will be shown instead.
''Display of ratings can be disabled in User Preferences for those who don't care about ratings''.


==Color Definitions==
==Meaning of the Colors==


{|
{|
Line 30: Line 24:
==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]] has been updated in order to allow to retrieve or update ratings via WS in a similar way to how [[Folksonomy Tagging|folksonomy tagging]] works.


The two methods of submission/retrieval are:
Either by the new /rating resource for submitting/retriving one specific rating:
# Using the new /rating resource for submitting/retrieving 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>
#: <code>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</code>
# Using the two new inc parameters with the artist, label, release or tracks resources as described in [[XML Web Service]].
#: <code>ratings</code> and <code>user-ratings</code>


[[Category:Documentation]] [[Category:To Be Reviewed]]
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]]

Revision as of 00:22, 3 February 2020

Description

The rating system allows users to rate MusicBrainz entities (artists, labels, releases and tracks).

Details

User may assign a value between 1 and 5 to various entities as a rating, these values are then aggregated by the server to compute an average community rating for that same entity.

The community rating is shown by default for each entity, however, once a user submits their own rating that value will be shown instead.

Color Definitions

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 XML Web Service has been updated in order to allow to retrieve or update ratings via WS in a similar way to how folksonomy tagging works.

The two methods of submission/retrieval are:

  1. Using the new /rating resource for submitting/retrieving one specific rating.
    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
  2. Using the two new inc parameters with the artist, label, release or tracks resources as described in XML Web Service.
    ratings and user-ratings