Дидани манбаъи Шаблон:Video game reviews/doc

{{Documentation subpage}}
<includeonly>{{high-use|5,000+}}</includeonly>
{{Lua|Module:Video game reviews}}
{{Shortcut|T:VGR}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->

{{tld|Video game reviews}} is a template which presents [[review aggregator]] and individual publication review scores in a video game article. It supports a game's reception section, which for released titles is necessary for an article to be broad in its coverage.

'''Things to remember:'''
* This template is not required.
* This template supplements the reception section; it does not replace it.
* Only include reviews if they are cited within the text.

== Guidelines ==
;{{tld|Video game reviews}} is not required
:Traditional reviews, or those that provide some type of score, may be few and far between for some games. If you only have a couple of such reviews which could be used to fill the table, consider foregoing the table and instead simply state these in the body of reception text.

;All reviews must be [[Wikipedia:Citing sources|referenced]]
:Individual reviews should cite their original publication, not the aggregator truncated summary.  See also [[Wikipedia:WikiProject Video games/Sources]].

;Every single-site review source should be used within the reception section
:The reviews table supports the text.  It is not to replicate the function of external review aggregators.

;Stay with the "usual suspects"
:Aggregators present readers with a quick gauge of the critical consensus.
:*[[Metacritic]] − Industry standard
:*[[GameRankings]] − Particularly useful for games that pre-date Metacritic (limit to 2 significant figures, i.e., 83% instead of 83.46%)

:The following sources comprise the most popular and influential voices in the games industry.  It provides a core selection of reviews to build a reception section:
:*[[IGN]] - Most popular English language games website
:*[[GameSpot]] - Second most popular English language games website
:*''[[Game Informer]]'' − US magazine with the largest circulation
:*''[[Edge (magazine)|Edge]]'' − UK's longest running print magazine
:*[[Eurogamer]] - Most popular European English language games website ([[#noscore|See below]])

:For older games, particularly [[History of video game consoles (fifth generation)|fifth generation]] and earlier, web based publications lacked the reach and influence of print publications.  Sources to consider include:
:*''[[Computer and Video Games]]'' - UK magazine first published in 1981
:*''[[Computer Gaming World]]'' - US PC magazine first published in 1981
:*''[[Electronic Gaming Monthly]]'' - US magazine first published in 1989 ([[#aggscore|See below]])
:*''[[GamePro]]'' - US magazine first published in 1989
:*These publications and others may be available from the [[Wikipedia:WikiProject Video games/Reference library|reference library]].

:Single platform publications may offer specialist insight to platform-exclusive games, and allow readers to compare the reception across platforms of multiplatform games.  Consider sources such as ''[[Nintendo Power]]'', ''[[Official Xbox Magazine]]'', ''[[PC Gamer]]'', ''[[PlayStation Official Magazine]]'', and others.

:For niche genres, genre publications may offer specialist insight.  Consider sources such as [[Adventure Gamers]], [[RPGamer]], ''[[PC Pilot]]'', and others.

:Games which have strong cultural ties to their country of origin should have reception from that same country.  Japanese games for example are best served with a ''[[Famitsu]]'' review ([[#aggscore|See below]]).

:Consider coverage from outside traditional video games media.  High quality sources such as ''[[The New York Times]]'', ''[[Wired (magazine)|Wired]]'', and the [[BBC]], do not cater to a "gamer" audience, but may on occasion cover video games.  Wikipedia is both a [[Wikipedia:Wikipedia is an encyclopedia|generalist ''and'' specialist]] encyclopedia.  Opinions from these sources may be more accessible to a non-gamer audience and place the subject in a greater cultural and societal context than is possible at a narrowly focused video gaming publication.
{{Anchor|noscore}}
;Reviews without scores
:Some publications, such as [[Eurogamer]], [[Kotaku]] and [[Joystiq]] may not score their reviews.  If instead of a score, the publication presents the game with a badge or award in its review, this can be included in the table.  This is not necessary.
{{Anchor|aggscore}}
;Consider the aggregate scoring breakdown
:The review aggregators used in the table are considered reliable sources and are trusted to provide the critical consensus.  However, some games may divide opinion and there may be no true consensus.  This division of opinion may already have been captured following the guidelines above, but if not - consider including further reviews expressing these "outlier" opinions.

:Publications such as ''[[Electronic Gaming Monthly]]'' and ''[[Famitsu]]'' review games among a group, with each reviewer offering their individual score.  Using the average or cumulative score from these publications will result in the loss of that breakdown, so include the individual scores, either in the table itself or in a footnote.

;Stars
:If a review uses a stars instead of numbers, you may use the {{tl|rating}} template.  This is not required.  Examples:
::{| class="wikitable"
! Code !! Result
|-
|<code><nowiki>{{Rating|3|5}}</nowiki></code> || {{Rating|3|5}}
|-
|<code><nowiki>{{Rating|3.5|5}}</nowiki></code> || {{Rating|3.5|5}}
|-
|<code><nowiki>{{Rating|7|10}}</nowiki></code> || {{Rating|7|10}}
|}
{{clear}}

== General ==
=== Usage ===
All of the following fields are optional:

:; ''title''*
:: Can be used to provide a custom title for the table; otherwise, it will default to "Reception".
:; ''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''*  [autocollapse, collapsed, expanded]
:# '''<code>autocollapse</code>'''&nbsp;&nbsp;–&nbsp;&nbsp;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]].
:# '''<code>collapsed</code>'''&nbsp;&nbsp;–&nbsp;&nbsp;The table will be collapsed (hidden) by default. This is useful for very long tables.
:# '''<code>expanded</code>'''&nbsp;&nbsp;–&nbsp;&nbsp;The table will be expanded (shown) by default. This is useful if autocollapse is not showing the table in a section that it wouldn't matter.
:# If undefined or set to blank, the table will not be collapsible.
:; ''align''*
:# '''<code>right</code>'''&nbsp;&nbsp;–&nbsp;&nbsp;Displays the table on the right. This is default.
:# '''<code>left</code>'''&nbsp;&nbsp;–&nbsp;&nbsp;Displays the table on the left.
:# '''<code>inherit</code>'''&nbsp;&nbsp;–&nbsp;&nbsp;Specifies that the value of the float property should be inherited from the parent element.
:# '''<code>none</code>'''&nbsp;&nbsp;–&nbsp;&nbsp;The table is not aligned, and will be displayed just where it occurs in the text on the page.

=== Code ===
<table style="background:transparent;width:100%;" cellpadding="16">
<tr style="vertical-align:top;">
<td style="width:25%;">
{| class="wikitable sortable"
|+ Predefined Aggregator Fields
! style="width:220px" | Aggregator
! style="width:55px" | Code
! Rating system<br />example
|-
| [[GameRankings]] || <tt>GR</tt> || 84%
|-
| [[Metacritic]] || <tt>MC</tt> || 83/100
|-
|}
</td>
<td style="width:25%;">
{| class="wikitable sortable"
! style="width:220px" | Reviewer
! style="width:55px" | Code
! Rating system<br />example
|-
| [[1UP.com]] || <tt>1UP</tt> || A+ to D−
|-
| [[Adventure Gamers]] || <tt>AdvGamers</tt> ||
|-
| [[Allgame]] || <tt>Allgame</tt> ||
|-
| ''[[Amstrad Action]]'' || <tt>AAction</tt> ||
|-
| ''[[Amtix!]]'' || <tt>Amtix</tt> ||
|-
| ''[[Computer Gaming World]]'' || <tt>CWG</tt> ||
|-
| ''[[Computer and Video Games]]'' || <tt>CVG</tt> || 9.2 (0.0 to 10.0)
|-
| ''[[Crash (magazine)|Crash]]'' || <tt>CRASH</tt> ||
|-
| ''[[Destructoid]]'' || <tt>Destruct</tt> ||
|-
| ''[[Dragon (magazine)|Dragon]]'' || <tt>Dragon</tt> ||
|-
| ''[[Edge (magazine)|Edge]]'' || <tt>Edge</tt> || 1 to 10
|-
| ''[[Electronic Gaming Monthly]]'' || <tt>EGM</tt> || 9.5 (0.0 to 10.0)
|-
| [[Eurogamer]] || <tt>EuroG</tt> ||Stopped scoring reviews on 10 February 2015
|-
| ''[[Famitsu]]'' || <tt>Fam</tt> || 0 to 40
|-
| [[G4 (TV channel)|G4]] || <tt>G4</tt> ||
|-
| ''[[GameFan]]'' || <tt>GameFan</tt> ||
|-
| ''[[Game Informer]]'' || <tt>GI</tt> ||
|-
| ''[[GamePro]]'' || <tt>GamePro</tt> ||
|-
| [[Game Revolution]] || <tt>GameRev</tt> || A to D− (1996-2012); adapted 5-star rating system in 2012
|-
| ''[[GamesMaster (magazine)|GamesMaster]]'' || <tt>GMaster</tt> ||
|-
| [[GameSpot]] || <tt>GSpot</tt> ||
|}
</td>
<td style="width:25%;">
{| class="wikitable sortable"
! style="width:220px" | Reviewer
! style="width:55px" | Code
! Rating system<br />example
|-
| [[GameSpy]] || <tt>GSpy</tt> ||
|-
| [[GamesRadar]] || <tt>GRadar</tt> ||
|-
| ''[[GamesTM]]'' || <tt>GTM</tt> ||
|-
| [[GameTrailers]] || <tt>GT</tt> ||
|-
| [[GameZone]] || <tt>GameZone</tt> ||
|-
| [[Giant Bomb]] || <tt>GB</tt> ||
|-
| ''[[Hyper (magazine)|Hyper]]'' || <tt>Hyper</tt> ||
|-
| [[IGN]] || <tt>IGN</tt> ||
|-
| [[Joystiq]] || <tt>Joystiq</tt> || No longer scoring reviews after Jan. 2015
|-
| ''[[Maximum PC]]'' || <tt>MaxPC</tt> ||
|-
| ''[[Nintendo Gamer]]'' || <tt>NG</tt> ||
|-
| ''[[NGC Magazine]]'' || <tt>N64</tt> or <tt>NGC</tt> ||
|-
| ''NintendoLife'' || <tt>NLife</tt> ||
|-
| ''[[Nintendo Power]]'' || <tt>NP</tt> ||
|-
| Nintendo World Report || <tt>NWR</tt> ||
|-
| ''[[Official Nintendo Magazine]]'' || <tt>ONM</tt> ||
|-
| [[Official U.S. PlayStation Magazine|''Official PlayStation Magazine'' (US)]] || <tt>OPM</tt> ||
|-
| [[PlayStation Official Magazine|''Official PlayStation Magazine'' (UK)]] || <tt>OPMUK</tt> ||
|-
| [[Official PlayStation Magazine (Australia)|''Official PlayStation Magazine'' (Australia)]] || <tt>OPMAU</tt> ||
|-
| ''[[Official Xbox Magazine]]'' || <tt>OXM</tt> ||
|}
</td>
<td style="width:25%;">
{| class="wikitable sortable"
! style="width:220px" | Reviewer
! style="width:55px" | Code
! Rating system<br />example
|-
| [[Official Xbox Magazine|''Official Xbox Magazine'' (UK)]] || <tt>OXMUK</tt> ||
|-
| [[PALGN]] || <tt>PALGN</tt> ||
|-
| ''[[PC Format]]'' || <tt>PCF</tt> ||
|-
| [[PC Gamer|''PC Gamer'' (UK)]] || <tt>PCGUK</tt> ||
|-
| [[PC Gamer|''PC Gamer'' (US)]] || <tt>PCGUS</tt> ||
|-
| ''[[PC PowerPlay]]'' || <tt>PCPP</tt> ||
|-
| ''[[PC Zone]]'' || <tt>PCZone</tt> ||
|-
| [[Play (UK magazine)|''Play'']] || <tt>Play</tt> ||
|-
| [[Polygon (website)|Polygon]] || <tt>Poly</tt> ||
|-
| ''[[PlayStation: The Official Magazine|PSM]]'' || <tt>PSM</tt> ||
|-
| ''[[PSM3]]'' || <tt>PSM3</tt> ||
|-
| ''[[Sinclair User]]'' || <tt>SUser</tt> ||
|-
| [[TeamXbox]] || <tt>TX</tt> ||
|-
| [[VideoGamer.com]] || <tt>VG</tt> ||
|-
| ''[[X-Play]]'' || <tt>XPlay</tt> ||
|-
| ''[[Your Sinclair]]'' || <tt>YSinclair</tt> ||
|}
</td>
</tr>
</table>

== Award layout ==
=== Usage ===
{{Video game multiple platforms reviews
| title     = Documentation Template
| subtitle  = For testing
| state     = expanded
| award1    = PC Game of the Year (2000) 
| award1Pub = [[British Academy of Film and Television Arts|BAFTA]]
| award2    = Best PC Game of All Time
| award2Pub = ''[[PC Zone]]''
}}
{{template shortcut|VG Awards|Video game awards}}
:; ''award<sub>n</sub>''*
:: These are for the title of the awards that the title has won.
:; ''award<sub>n</sub>Pub''*
:: These are the publishers that provided the award for the title.
</td>
</tr>

=== Code ===
'''Example Blank Template'''
<pre>
{{Video game reviews
| title      = 
| subtitle   = 
<!--Formatting-->
| state      = <!--plain/collapsible-->
| align      = <!--left/right/none/inherit-->
<!-- Awards No limit -->
| award1Pub  = 
| award1     = 
| award2Pub  = 
| award2     = 
}}
</pre>
</tr>
</table>

== Single-Platform/Column layout ==
{{Video game reviews
| title     = Documentation Template
| subtitle  = For testing
| state     = expanded
| 1UP       = PS3/X360:&nbsp;C<br />PSP:&nbsp;C-
| EGM       = PS3/X360:&nbsp;C, C, B-
| GI        = PS3/X360:&nbsp;8.75/10
| GSpot     = DS:&nbsp;5.5/10<br />PS2:&nbsp;6.0/10<br />PS3/X360:&nbsp;7.5/10<br />PSP:&nbsp;7.0/10<br />Wii:&nbsp;6.0/10
| GT        = PS3/X360:&nbsp;6.9/10
| IGN       = PS2:&nbsp;7.2/10<br />PSP:&nbsp;7.5/10<br />PS3/X360:&nbsp;7.3/10<br />Wii:&nbsp;7.8/10
| OXM       = 7.5/10
| XPlay     = PS3/X360:&nbsp;2/5
| GR        = DS:&nbsp;59%<br />PS2:&nbsp;69%<br />PS3:&nbsp;72%<br />PSP:&nbsp;69%<br />Wii:&nbsp;72%<br />X360:&nbsp;74%
| MC        = DS:&nbsp;61/100<br />PS2:&nbsp;68/100<br />PS3:&nbsp;70/100<br />PSP:&nbsp;70/100<br />Wii:&nbsp;70/100<br />X360:&nbsp;73/100
| rev1      = Custom Reviewer
| rev1Score   = With score
| rev3      = Other Custom Reviewer.
| rev3Score   = Can skip numbers.
| award1    = PC Game of the Year (2000) 
| award1Pub = [[British Academy of Film and Television Arts|BAFTA]]
| award2    = Best PC Game of All Time
| award2Pub = ''[[PC Zone]]''
}}

=== Usage ===
:; ''award<sub>n</sub>''*
:: These are for the title of the awards that the title has won.
:; ''award<sub>n</sub>Pub''*
:: These are the publishers that provided the award for the title.
:; ''rev<sub>n</sub>''*
:: These are for custom reviewers. Use with rev<sub>n</sub>Score.
:; ''rev<sub>n</sub>Score''*
:: These are for custom reviewers scores for each Platform. Use with rev<sub>n</sub>.
:; ''agg<sub>n</sub>''*
:: These are for custom aggregate. Use with agg<sub>n</sub>Score.
:; ''agg<sub>n</sub>Score''*
:: These are for custom aggregate scores for each Platform. Use with agg<sub>n</sub>.

=== Code ===
'''Example Blank Template'''
<pre>
{{Video game reviews
| title      = 
| subtitle   = 
<!--Formatting-->
| state      = <!--plain/collapsible-->
| align      = <!--left/right/none/inherit-->
<!-- Aggregators -->
| MC         = 
<!-- Reviewers -->
| XPlay      = 
| IGN        = 
<!-- Custom aggregators limit is set to 10 -->
| agg1      = 
| agg1Score = 
| agg2      = 
| agg2Score = 
<!-- Custom Reviewers limit is set to 10-->
| rev1       = 
| rev1Score  = 
| rev2       = 
| rev2Score  = 
<!-- Awards No limit -->
| award1Pub  = 
| award1     = 
| award2Pub  = 
| award2     = 
}}
</pre>

== Multi-platform ==
=== Usage ===
{{Video game reviews
| title     = Documentation Template
| subtitle  = For testing
| state     = expanded
| na        = true
| DS        = true
| PC        = true
| PS        = true
| SSAT      = true
| MC_DS     = 71/100
| MC_PS     = 91/100
| GR_DS     = 72%
| GR_PC     = 80%
| GR_PS     = 89%
| GR_SSAT   = 75%
| 1UP_DS    = B
| GSpot_DS  = 7.9
| GSpot_PC  = 7.2
| GSpot_PS  = 8.2
| GSpot_SSAT= 7.3
| IGN_DS    = 7.0
| IGN_PS    = 8.7
| GSpy_DS   = {{Rating|2.5|5}}
| rev1      = Custom Reviewer
| rev1_DS   = With score
| rev3      = Other Custom Reviewer.
| rev3_PC   = Can skip numbers.
| award1    = PC Game of the Year (2000)
| award1Pub = [[British Academy of Film and Television Arts|BAFTA]]
| award2    = Best PC Game of All Time
| award2Pub = ''[[PC Zone]]''
}}

:; ''na''*
:: This will set a fill of N/A grayed out.
:; ''award<sub>n</sub>''*
:: These are for the title of the awards that the title has won.
:; ''award<sub>n</sub>Pub''*
:: These are the publishers that provided the award for the title.
:; ''rev<sub>n</sub>''*
:: These are for custom reviewers. Use with rev<sub>n</sub>Platform.
:; ''rev<sub>n</sub>Platform''*
:: These are for custom reviewers scores for each Platform. Use with rev<sub>n</sub>.

=== Code ===
You first need to put any platforms that are being used:
'''The code to use is as follows:'''<br/>Enter true into any platform used.<br/> If not used, set to non-true value, leave blank, or delete the parameter.
<table style="background:transparent;width:100%;" cellpadding="16">
<tr style="vertical-align:top;">
<td rowspan=2>
'''Example Blank Template'''
<pre>
{{Video game reviews
| title      = 
| subtitle   = 
<!--Formatting-->
| state      = <!--plain/collapsible-->
| align      = <!--left/right/none/inherit-->
| na         = true/false; default is false can be omitted.
<!-- Turn on platform etc. -->
| DS         = true
| iOS        = false
<!-- Aggregators etc. -->
| MC_DS      = 
| MC_iOS     = 
<!-- Reviewers etc. -->
| XPlay_iOS  = 
| IGN_X360   = 
<!-- Custom Reviewers limit is set to 10-->
| rev1       = 
| rev1_PC    = 
| rev1_X360  = 
| rev2       = 
| rev2_PC    = 
<!-- Awards no limit-->
| award1Pub  = 
| award1     = 
| award2Pub  = 
| award2     = 
}}
</pre>
</td>
<td>
{| class="wikitable sortable" width="67.5%"
|+ {{vanchor|Predefined System Type}}
! style="width:220px" | System
! style="width:55px" | Code
|-
| [[Atari 2600]] || A2600
|-
| [[Atari Lynx]] || LYNX
|-
| [[ColecoVision]] || CV
|-
| [[Nintendo DS]] || DS
|-
| [[Game Boy]] || GB
|-
| [[Game Boy Advance]] || GBA
|-
| [[Game Boy Color]] || GBC
|-
| [[List of video game consoles|General]] ~~ If review is broad. || GEN
|-
| [[iOS]] || iOS
|-
| [[Macintosh]] || MAC
|-
| [[N-Gage (device)]] || N-G
|-
| [[Nintendo 64]] || N64
|-
| [[Nintendo Entertainment System]] || NES
|-
| [[GameCube]] || NGC
|-
| [[Nvidia Shield]] || NSHI
|-
| [[Personal Computer]] || PC
|-
| [[PlayStation]] || PS
|-
| [[PlayStation 2]] || PS2
|-
| [[PlayStation 3]] || PS3
|-
| [[PlayStation 4]] || PS4
|-
| [[PlayStation Portable]] || PSP
|-
| [[Dreamcast]] || SDC
|-
| [[Sega Game Gear]] || SGG
|-
| [[Super Nintendo Entertainment System]] || SNES
|-
| [[Sega Genesis|Sega Genesis (Mega Drive)]] || SMD
|-
| [[Master System]] || SMS
|-
| [[Sega Saturn]] || SSAT
|-
| [[TurboGrafx-16]] || TG16
|-
| [[PlayStation Vita]] || VITA
|-
| [[Xbox]] || XBOX
|-
| [[Xbox One]] || XONE
|-
| [[Xbox 360]] || X360
|-
| [[Wii]] || WII
|-
| [[Wii U]] || WIIU
|-
| [[Nintendo 3DS]] || 3DS
|}
</td>
</tr>
</table>

==How to add a new platform==
Go to [[Module:Video game reviews/data]] and add {'wiki url/title', 'short code for the system'} within the system array.
* Define a code for the new platform (eg. “PS2” for PlayStation 2)
* Determine its alphabetical order, and the platform code preceding and succeeding it. (eg. For PS2, the PS precedes, and the PS3 succeeds)

==How to add a new reviewer==
Go to [[Module: Video game reviews]] and add {'wikilink/title', 'short code for the reviewer'} within the reviewer array.
* Define a code into the appropriate place (alphabetically) of the existing code.
* Be sure to provide an appropriate wikilink if available.

== Template revisions ==
=== Style changes ===
Here's a record of previous styles that were very different from one another:
* Removed bounding box on title.
* Added color to aggregator and reviewer title rows.

== Template Data ==
{{notice|This template data section contains only key parameters.}}
{{TemplateDataHeader}}

<TemplateData>{
"description": "A template to show the review scores, aggregator scores, and awards given to a title.",
"params": {
  "title": {
    "label": "title",
    "description": "Title of the template.",
    "type": "string",
    "default": "Reception",
    "required": false
  },
  "subtitle": {
    "label": "subtitle",
    "description": "Subtitle of the template.",
    "type": "string",
    "default": "",
    "required": false
  },
  "state": {
    "label": "state",
    "description": "The tables collapsable settings.",
    "type": "string",
    "default": "expanded",
    "required": false
  },
  "align": {
    "label": "align",
    "description": "The tables horizontal alignment settings.",
    "type": "string",
    "default": "right",
    "required": false
  },
  "na": {
    "label": "na",
    "description": "This will set a fill of N/A grayed out.",
    "type": "string",
    "default": "true",
    "required": false
  }
}}</TemplateData>

== See also ==
* [[Wikipedia:WikiProject Video games/Sources]]
* {{tiw|Album ratings}}
* {{tiw|Video game requirements}}
* {{tiw|Video game series reviews}} for video games in a series.
* {{tiw|Rating}}

== Notes ==
{{Reflist}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:Wikipedia rating templates]]
[[Category:Video game infobox templates|Reviews]]

}}</includeonly>