Template:Film and game ratings/doc

From blackwiki
Jump to navigation Jump to search

Usage

Professional ratings
Review scores
SourceRating
RogerEbert.comTemplate:Rating[1]
The Hollywood Reporter9/10[2]

{{Film ratings|, {{Game ratings|, and {{Video game ratings| will also invoke this template.

Only add a rating if you cite it with a reference

Instructions

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. The template should not be used in place of a reception section.

The reviews should be listed alphabetically in the Reviews field. The information in the reviewer field should be the name of the source. 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: Template:Rating.

For reviews at Rotten Tomatoes it is convenient to use "RT=" in the template.

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

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.

Usage

{{Film and game ratings
| title =
| subtitle =
<!-- Aggregate scores -->
| MC = 
| RT =
| aggregate1 = 
| aggregate1score = 
| aggregate2 = 
| aggregate2score = 
| aggregate3 = 
| aggregate3score = 
<!-- ... -->
<!-- Reviewers -->
| rev1 =
| rev1score =
| rev2 =
| rev2score =
| rev3 =
| rev3score =
<!-- ... -->
<!-- Article needs reviews expanded into prose -->
| noprose = <!--yes-->
}}

Parameters

Required fields:

rev#
The name of the reviewer. Too many is not advised, except in appropriate circumstances. For instance, a particularly popular or long-running series, which has several prominent reviews over decades' time.
rev#score
The rating given by the reviewer.

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.
MC
Metacritic score.
aggregate#
Name of a review aggregator.
aggregate#score
The rating given by the review aggregator.
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 media ratings that need to be turned into prose.
RT
Rotten Tomatoes score.

Example

For example, entering

{{Film and game ratings
| MC = 78/100<ref name="Meta">{{cite web|url=https://www.metacritic.com/movie/1917|title=1917|publisher=Metacritic|accessdate=6 March 2020}}</ref>
| RT = 89%<ref name="RT">{{cite web|url=https://www.rottentomatoes.com/m/1917_2019|title=1917 (2020)|publisher=Rotten Tomatoes|accessdate=6 March 2020}}</ref>
| rev1 = ''[[Empire (film magazine)|Empire]]''
| rev1score = {{Rating|4|5}}<ref name="Empire">{{cite web|url=https://www.empireonline.com/movies/reviews/1917-movie-2/|title=1917 Review|publisher=Empire|last=Godfrey|first=Alex|accessdate=6 March 2020}}</ref>
| rev2 = ''[[The Guardian]]''
| rev2score = {{rating|4|5}}<ref name="Guardian">{{cite web|url=https://www.theguardian.com/film/2020/jan/12/1917-review-sam-mendes-first-world-war-ww1-unblinking-vision-one-shot|title=1917 review – Sam Mendes’s unblinking vision of the hell of war|publisher=The Guardian|last=Kermode|first=Mark|author-link=Mark Kermode|accessdate=6 March 2020}}</ref>
}}

will render

Professional ratings
Aggregate scores
SourceRating
Metacritic78/100[1]
Rotten Tomatoes89%[2]
Review scores
SourceRating
EmpireTemplate:Rating[3]
The GuardianTemplate:Rating[4]

and generate the following footnotes with the sources:

  1. "1917". Metacritic. Retrieved 6 March 2020.
  2. "1917 (2020)". Rotten Tomatoes. Retrieved 6 March 2020.
  3. Godfrey, Alex. "1917 Review". Empire. Retrieved 6 March 2020.
  4. Kermode, Mark. "1917 review – Sam Mendes's unblinking vision of the hell of war". The Guardian. Retrieved 6 March 2020.

Template data

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Film and game ratings

This template creates a table with reviews for television. 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

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
First reviewerrev1

The name of the first reviewer.

Stringrequired
First reviewer's ratingrev1score

The rating given by the first reviewer.

Stringrequired
Second reviewerrev2

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 more can be added in exceptional circumstances.

Stringoptional
Second reviewer's ratingrev2score

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 more can be added in exceptional circumstances.

Stringoptional
Table titletitle

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

Stringoptional
Table subtitlesubtitle

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.

Stringoptional
Table widthwidth

The width of the table.

Stringoptional
Metacritic scoreMC

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

Stringoptional
Article lacks prose sectionnoprose

Set this to "yes" to flag articles that have a ratings table without a prose reviews section.

Stringoptional
Rotten Tomatoes scoreRT

The Rotten Tomatoes score. Appears under the "Aggregate scores" header.

Stringoptional
First review aggregatoraggregate1

The name of the first review aggregator.

Stringoptional
First review aggregator's ratingaggregate1score

The rating given by the first review aggregator.

Stringoptional
Second review aggregatoraggregate2

The name of the second review aggregator.

Stringoptional
Second review aggregator's ratingaggregate2score

The rating given by the second review aggregator.

Stringoptional

See also