Template:Album ratings

From Wikipedia, the free encyclopedia
Jump to: navigation, search
 Professional ratings
Source Rating
Documentation icon Template documentation[view] [edit] [history] [purge]
 Professional ratings
Source Rating
AllMusic 4/5 starsStar full.svgStar full.svgStar full.svgStar empty.svg[1]
IGN 9/10[3]
Jesus Freak Hideout 4.5/5 starsStar full.svgStar full.svgStar full.svgStar half.svg[2]

Only add a rating if you cite it with a reference. For further information on sources, see Wikipedia:WikiProject Albums. For the guide on transitioning from Infoboxes->AlbumRatings, see Wikipedia:WikiProject Albums/Moving infobox reviews into article space

The template is not to be a substitute for a section in paragraph form, since a review can not be accurately boiled down to a simple rating out of five stars or other numeric score. If an article is lacking a reception section in prose, but the information is presented in table format, the |noprose=yes parameter can be used to tag the article as needing a reception section in prose.

This template is generally the first element after the heading for the section on Reception, Critical reception, Reviews, or something similar. If one of those sections is not present, the template should be placed immediately after the infobox, and can then be moved once a Reception section is present.

The reviews should be listed alphabetically in the Reviews field. The information in the reviewer field should be the name of the source (most commonly an online music service like AllMusic, or a music magazine like Rolling Stone—note that magazines are italicized). Don't forget to wikilink to the relevant article.

The information in the score field should be the rating given in the review (e.g. 4/5). The rating should use the same format as in the review, to accurately portray the score of the review. For star ratings you should use the star rating template; for example, entering {{Rating|4.5|5}}, will render: 4.5/5 starsStar full.svgStar full.svgStar full.svgStar half.svg.

For reviews at AllMusic it is convenient to use the {{Allmusic}} template.

For reviews at Metacritic it is convenient to use "MC=" in the template.

For reviews from Robert Christgau's Consumer Guide you may use the Christgau rating template. For example, entering {{Rating-Christgau|dud}} will render: (dud).

Please note that the minus sign character () is not the same thing as a hyphen (-).

After the rating should be the citation of the source of the review. Per Wikipedia:Citing sources do not add reviews without a citation. This means a properly formatted footnote, in most cases providing the author, date, and source, along with an external link if available. Do not use an embedded link with no information (e.g. link) as this promotes link rot and is inconsistent with Wikipedia's policy on embedded links. If you must use an embedded link, be sure to manually provide a full citation in the article's References section per Wikipedia:Citing sources.

For example, entering

{{Album ratings
| MC = 69/100<ref name="Meta">{{cite web|url=http://www.metacritic.com/music/black-gives-way-to-blue/alice-in-chains|title=Black Gives Way To Blue|publisher=Metacritic|accessdate=2012-09-02}}</ref>
| rev1 = [[AllMusic]]
| rev1Score = {{Rating|4.5|5}}<ref name="AM">{{Allmusic |class=album |id=r70661 |tab=review |label=Alice in Chains: ''Dirt'' > Review |first=Steve |last=Huey |accessdate=31 January 2010}}</ref>
| rev2 = [[Robert Christgau]]
| rev2Score = B<ref name="RC">{{cite web |first=Robert |last=Christgau |title=Review: ''Dirt'' |url=http://www.robertchristgau.com/get_artist.php?name=Alice+in+Chains |publisher=[[Robert Christgau]] |accessdate=31 January 2010}}</ref>
| rev3 = ''[[Q (magazine)|Q]]''
| rev3Score = {{Rating|4|5}}<ref name="Q">{{cite journal |last=Doe |first=Jane |title=Review: ''Dirt'' |journal=[[Q (magazine)|Q]] |issue=65 |date=February 2002 |page=120}}</ref>
}}

will render

 Professional ratings
Source Rating
AllMusic 4.5/5 starsStar full.svgStar full.svgStar full.svgStar half.svg[1]
Robert Christgau B[2]
Q 4/5 starsStar full.svgStar full.svgStar full.svgStar empty.svg[3]


and generate the following footnotes with the sources:

  1. Alice in Chains: Dirt > Review at Allmusic. Retrieved 31 January 2010
  2. Christgau, Robert. "Review: Dirt". Robert Christgau. http://www.robertchristgau.com/get_artist.php?name=Alice+in+Chains. Retrieved 31 January 2010.
  3. Doe, Jane (February 2002). "Review: Dirt". Q (65): 120.

Syntax[change source]

Required fields:

rev#
the name of the reviewer, goes from rev1 to rev20. It is recommended to include no more than 10 reviews, but the template can support up to 20 for exceptional circumstances. For instance, a particularly popular album which has been re-released and has several prominent reviews over decades' time.
rev#Score
the rating given by the reviewer, goes from rev1Score to rev20Score.

All of the following fields are optional:

title
can be used to provide a custom title for the table, otherwise, it will default to "Professional ratings".
subtitle
used to add additional text before the collapsible section. This is necessary to add if want a longer title, as long titles via the "title" parameter will not center correctly.
width
sets the width of the table; default is 24.2em, to match the width of the album infobox in most browsers and skins.
MC
Metacritic score
noprose
Should only be used for articles that do not have a Reception section summarizing the reviews. If set to yes, will categorize articles into Category:Articles with album ratings that need to be turned into prose.

Usage[change source]

{{Album ratings
| title =
| subtitle =
<!-- Aggregate scores -->
| MC = 
<!-- Reviewers -->
| rev1 =
| rev1Score =
| rev2 =
| rev2Score =
| rev3 =
| rev3Score =
| rev4 =
| rev4Score =
| rev5 =
| rev5Score =
| rev6 =
| rev6Score =
| rev7 =
| rev7Score =
| rev8 =
| rev8Score =
| rev9 =
| rev9Score =
| rev10 =
| rev10Score =
| rev11 =
| rev11Score =
| rev12 =
| rev12Score =
| rev13 =
| rev13Score =
| rev14 =
| rev14Score =
| rev15 =
| rev15Score =
| rev16 =
| rev16Score =
| rev17 =
| rev17Score =
| rev18 =
| rev18Score =
| rev19 =
| rev19Score =
| rev20 =
| rev20Score =
<!-- Article needs reviews expanded into prose -->
| noprose = <!--yes-->
}}

Template data[change source]

This is the TemplateData documentation for the template used by the new VisualEditor.

Album ratings

This template creates a table with reviews for albums. Only add a rating if you cite it with a reference. The template is not to be a substitute for a section in paragraph form.

Template parameters

Parameter Description Type Status
First reviewer rev1

The name of the first reviewer.

Default
empty
Example
empty
Auto value
empty
String required
First reviewer's rating rev1score

The rating given by the first reviewer.

Default
empty
Example
empty
Auto value
empty
String required
Second reviewer rev2

The name of the second reviewer. More reviewers can be added with parameters in the format rev[#] (the next one would be rev3). It is recommended to include no more than 10 reviews, but the template can support up to 20 for exceptional circumstances.

Default
empty
Example
empty
Auto value
empty
String optional
Second reviewer's rating rev2score

The rating given by the second reviewer. More ratings can be added with parameters in the format rev[#]score (the next one would be rev3score). It is recommended to include no more than 10 reviews, but the template can support up to 20 for exceptional circumstances.

Default
empty
Example
empty
Auto value
empty
String optional
Table title title

A custom title for the table, replacing "professional ratings".

Default
empty
Example
empty
Auto value
empty
String optional
Table subtitle subtitle

Additional text before the collapsible section. This is necessary to add if you want a longer title, as long titles in the "title" parameter will not work right.

Default
empty
Example
empty
Auto value
empty
String optional
Table width width

The width of the table.

Default
empty
Example
empty
Auto value
empty
String optional
Metacritic score MC

The Metacritic score. Appears under the "Aggregate scores" header.

Default
empty
Example
empty
Auto value
empty
String optional
Article lacks prose section noprose

If set to "yes", marks the article as lacking a prose reviews section, just the table.

Default
empty
Example
empty
Auto value
empty
String optional