Template:Album ratings/doc

'Only add a rating if you cite it with a reference. For further information on sources, see WikiProject Albums.'

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 a phrase like "unfavorable". If an article is lacking a reception section in prose, but the information is presented in table format, the Arprose maintenance template can be used to tag the section for expansion.

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, will render:. Numerical ratings, letter grades and other non-symbol ratings should be shown using plain text in parentheses, like (3.5/10), (B) or (90%).

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

For reviews by Robert Christgau you may use the Christgau rating template. For example, entering  will render:. If no rating is given in the review you should use one of the words (favorable) or (unfavorable) to describe the review, possibly allowing for (ambivalent), (mixed), (extremely favorable) and more, but keep it short and simple. If you cannot summarize the review, don't include it in the template.

After the rating should be the citation of the source of the review. Per 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



will render

and generate the following footnotes with the sources:

Syntax
Required fields:


 * rev#
 * the name of the reviewer, goes from rev1 to rev12
 * rev#Score
 * the rating given by the reviewer, goes from rev1Score to rev12Score

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.
 * state
 *   –  the table will be collapsed (hidden) by default. This is useful for very long tables.
 *   –  the table will start out collapsed if there are two or more tables on the same page that use other collapsible tables. Otherwise, the table will be expanded. For the technically minded, see MediaWiki:Common.js.
 *   –  the table will always be expanded and the [hide]/[show] link on the right will not be displayed.
 * If set to blank, the table will always start out in an expanded state.
 * width
 * sets the width of the table; default is 23em.
 * MC
 * Metacritic score

Usage
en:Template:Album ratings es:Plantilla:Calificaciones profesionales pt:Predefinição:Críticas profissionais ru:Шаблон:Рейтинги альбома