Difference between revisions of "Rating System"

From MusicBrainz Wiki
(preference to hide ratings currently doesn't exist (https://tickets.metabrainz.org/browse/MBS-4089))
(update description, remove API section: documented at MusicBrainz_API#ratings / History:Development/XML_Web_Service/Version_1#ratings_resources)
 
Line 1: Line 1:
 
==Description==
 
==Description==
  
The rating system allows users to rate MusicBrainz entities (artists, labels, releases and tracks).
+
The rating system allows users to rate MusicBrainz entities (artists, labels, release groups, recordings, events, works).
  
 
==Details==
 
==Details==
Line 21: Line 21:
 
|  [[Image:star_big_community-rated.gif]]  ||  [[Image:star_small_community-rated.gif]]  ||  Community rating  
 
|  [[Image:star_big_community-rated.gif]]  ||  [[Image: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|folksonomy tagging]] works.
 
 
The two methods of submission/retrieval are:
 
# Using the new /rating resource for submitting/retrieving one specific rating.
 
#: <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]]
 
[[Category:Documentation]] [[Category:To Be Reviewed]]

Latest revision as of 22:57, 21 January 2021

Description

The rating system allows users to rate MusicBrainz entities (artists, labels, release groups, recordings, events, works).

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