Rating System: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(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