មើលកូដរបស់ ទំព័រគំរូ:ប្រអប់ព័ត៌មាន ល្បែងវីដេអូហ្គេម/doc

{{Documentation subpage}}
{{High-use}}
{{Auto italic title}}
{{Lua|Module:InfoboxImage|Module:WikidataIB|Module:String2|Module:Check for unknown parameters}}

{{Generic template demo
 |collapsible |state |italic title |title |image |caption
 |developer |publisher |series |engine |platforms |released |genre |modes
 |director |producer |designer |programmer |artist |writer |composer
 |cabinet |arcade system |cpu |sound |display
}}
{{Uses Wikidata|P50|P57|P86|P123|P136|P162|P178|P179|P287|P400|P404|P408|P880|P943|P2670|P3080}}

This is an infobox for [[video game]]s. It is capable of pulling reliably sourced values from Wikidata when fields are omitted. (See [[WP:VG/WD]] for a guide to editing Wikidata.) To prevent Wikidata from pulling data for a field, use the parameter in the template but leave its contents blank.

{{TOC limit|3}}

== Usage ==
<pre>
{{Infobox video game
| collapsible = 
| state = 
| italic title = 
| title = 
| image = 
| alt = 
| caption = 
| developer = 
| publisher = 
| series = 
| engine = 
| platforms = 
| released = 
| genre = 
| modes = 
| arcade system = 
}}
</pre>
Add the following credit fields for lead developers who worked on the game (please read inclusion notes below):
<pre>
| director = 
| producer = 
| designer = 
| programmer = 
| artist = 
| writer = 
| composer = 
</pre>

All fields are optional. See talk page for examples and standards.

== Full syntax ==
<pre>
{{Infobox video game
| collapsible = 
| state = 
| italic title = 
| title = 
| image = 
| alt = 
| caption = 
| developer = 
| publisher = 
| series = 
| engine = 
| platforms = 
| released = 
| genre = 
| modes = 
| arcade system = 
| director = 
| producer = 
| designer = 
| programmer = 
| artist = 
| writer = 
| composer = 
}}
</pre>

== Syntax guide ==
{{Infobox video game
| title = Nintendogs
| image = Example-serious.jpg
| caption = An example image
| developer = [[Nintendo EAD]]
| publisher = [[Nintendo]]
| director = Kiyoshi Mizuki
| producer = [[Hideki Konno]]
| composer = Hajime Wakai
| platforms = [[Nintendo DS]]
| released = {{Collapsible list |title={{nobold|April 21, 2005}}|'''Original version'''{{Video game release|JP|April 21, 2005|NA|August 22, 2005|AUS|September 29, 2005|EU|October 7, 2005}}'''''Best Friends'''''{{Video game release|NA|October 24, 2005}}'''''Dalmatian & Friends'''''{{Video game release|EU|June 16, 2006|NA|October 16, 2006}}}}
| genre = [[List of artificial pet games|Pet-raising simulation]]
| modes = [[Single-player]], [[multiplayer]]
}}

Note: In the following, plurals such as "developers", "publishers", "artists", etc do not exclude the singular (i.e. "artists", for example, implies "artist or artists"). Similarly, with the credit fields, individual development tasks for one field (e.g. which artists designed characters and which designed concept art; or which writers created story lines and which wrote scripts) should not be mentioned in the infobox but in the article text instead. Individual tasks should be generally kept to prose and the field should only list key people.<ref>[[Template talk:Infobox video game/Archive 9#Generally keep "development tasks" to prose|August 2010 discussion]]</ref><ref>[[Wikipedia talk:WikiProject Video games/Archive 97#RfC: Designer credits in Infobox video game|February 2013 discussion]]</ref> For example, the distinction between story and script writers of ''[[The Legend of Zelda: Twilight Princess]]'' is mentioned in the article's [[The Legend of Zelda: Twilight Princess#Creation|development section]].

{| class="wikitable"
|-
! Parameter !! Default !! Description
|-
| <code>collapsible</code> || ''no'' || Set <code>=yes</code> to make the box collapsible.
|-
| <code>fetchwikidata</code> || ''ALL'' || If you don't want all values to be fetched from wikidata, specify their property names here (see [[Module:WikidataIB]] for more details)
|-
| <code>suppressfields</code> || || If you want to exclude some Wikidata values, specify their property names here (see [[Module:WikidataIB]] for more details)
|-
| <code>onlysourced</code> || ''yes'' || Set to ''no'' if you only want to fetch values from Wikidata that do not have references (see [[Module:WikidataIB]] for more details, and see [[Wikipedia:Wikidata/2018 Infobox RfC#Discussion|this RFC]], which requires reliable sources for imported Wikidata fields in infoboxes, before doing so)
|-
| <code>qid</code> || || Set to the Wikidata QID of the entry that you want to retrieve info from, if it is not the page that the template is being used on
|-
| <code>refs</code> || ''no'' || set to ''yes'' if you want to fetch references from Wikidata (displayed inline and in the refs section)
|-
| <code>noicon</code> || ''no'' || when set to ''no'', a small pen icon will be shown next to items populated from Wikidata, which can be used to edit the value. If set to ''yes'', the pen icons will be hidden, and instead a single link stating "Edit on Wikidata" will display at the bottom of the Infobox.
|-
| <code>state</code> || || Determines the initial collapsed state of the infobox. Set <code>=collapsed</code> to put the box in collapsed state initially. Set <code>=expanded</code> to put the box in expanded state initially. Set <code>=autocollapse</code> to have the box's initial collapsed state be determined automatically based on the number of other templates in the article that also have the "collapsible" attribute. (Has no effect if <code>collapsible</code> is not used.)
|-
| <code>title</code> || || The full name of the game including punctuation and style (e.g., "Super Mario RPG: Legend of the Seven Stars" instead of "Super Mario RPG" or "Legend of the Seven Stars"). Do not wikilink the name of the game.
|-
| <code>{{vanchor|image}}</code> || {{wikidata entity link|P18}} || The ideal image is an English-language cover or, in the case of an arcade game, a promotional flier. Secondarily, use a logo or foreign-language cover. When cover designs differ between regions, use the cover from the region associated with the game's first English language release, though do not change another English-language version that has been uploaded first. Use art without platform decals, such as PC cover art, where possible. Avoid screenshots (per [[Wikipedia talk:WikiProject Computer and video games/Archive 5#Infobox picture|consensus]]), and multiple images (per [[Wikipedia:Non-free content criteria|WP:FUC]] #3). Also see the [[WP:VGIMAGES|WPVG image guideline]].
* Format the filename without the <code>File:</code> prefix (e.g., <code>Name.jpg</code>). The infobox uses "frameless" and "upright" flags to auto-size the image and accommodate [[Help:Preferences|user preferences]]. Do not manually set the image size with added syntax (e.g., "frameless", "upright", or "px").
|-
| <code>alt</code> || || Alternative text – A short descriptive text associated with an image that serves the same purpose and conveys the same essential information as the image. Useful in situations where the image is not available to the reader, e.g If they are using a [[screen reader]] due to a [[visual impairment]]. See [[WP:ALT]] for information about how to write good Alternative text.
|-
| <code>caption</code> || {{wikidata entity link|P2096}} || A short description of the image. Is it a flyer, a game cover, or something else? (See above for what an image should consist of.) This is used as the alternate text that will be displayed below the image. (Does not show if <code>image</code> is not used.)
|-
| <code>{{vanchor|developer}}</code> || {{Wikidata entity link|P178}} || The popular name or names of the [[video game developer]]s. This field is for the game development company (e.g., Nintendo) or, if confirmed by [[Wikipedia:No original research#Primary, secondary and tertiary sources|primary sources]], the name of the team that developed the game (e.g., Nintendo EAD). The names can be wikilinked. Individual development tasks handled by different companies (e.g., scenario, programming) and [[Porting of video games|ports]] should not be mentioned in the infobox but in the article text instead.
|-
| <code>{{vanchor|publisher}}</code> || {{Wikidata entity link|P123}} || The popular name or names of the [[video game publisher]]s. Add publishers for English-language regions and the developer's region. The names can be wikilinked. Use the {{tl|Video game release}} template for regional publishers. If there are many publishers or if the list grows too long, use the {{tl|Collapsible list}} template, fill the field <code>title=</code> with the primary publisher, and also include the field <code>titlestyle=font-weight:normal;background:transparent;text-align:left;</code>.
|-
| <code>series</code> || {{Wikidata entity link|P179}} || The [[List of video game franchises|video game series]] the game is associated with. Only use this field if there is an article for the series. Wikilink and italicize the names (such as <code><nowiki>''[[Halo (series)|Halo]]''</nowiki></code>).
|-
| <code>{{vanchor|engine}}</code> || {{Wikidata entity link|P408}} || The game's [[Game engine|engine]]. Only use this field for those engines listed in [[:Category:Video game engines]], either engines with an established, independent article (such as [[Unreal Engine]]), or those that have a redirect to their own section on an appropriate developer or series page (such as [[Dunia Engine]]). Wikilink its name (such as <code><nowiki>[[id Tech 3]]</nowiki></code>).<ref>[[Template talk:Infobox video game/Archive 10#Moving forward with the 'game engine' parameter: revised proposal|November 2010 discussion]]</ref> Do not list common middleware engines such as [[Havok (software)|Havok]], [[SpeedTree]] or [[Euphoria (software)|Euphoria]].
|-
| <code>{{vanchor|platforms}}</code> || {{Wikidata entity link|P400}} || The unabbreviated [[video game console|console]] or [[operating system]] family for which the game was specifically developed. With multi-platform games, order by chronology; if the game was released on multiple platforms on the same day, list that subset in alphabetical order. This field includes dedicated [[Porting of video games|ports]], but not games in [[Video game console emulator|emulation]] or services. E.g., we would include the platforms listed in green, but not include those red below:
::''[[Deus Ex (video game)|Deus Ex]]'' was ported specifically for the {{xt|PlayStation 2}}, but was emulated on the {{!xt|PlayStation 3}}
::''[[EarthBound]]'' was not ported but emulated on the {{!xt|Wii U Virtual Console}}
::''[[Star Fox 2]]'' was developed for the {{xt|Super Nintendo Entertainment System}}, but only later saw release in emulation on the {{!xt|SNES Classic Edition}}
::{{xt|Windows}}, not {{!xt|Steam}} or {{!xt|Oculus Rift}}
::{{xt|Xbox 360}}, not {{!xt|Xbox Live Arcade}}, nor {{!xt|Xbox One}} from Microsoft's backward compatibility program
::{{xt|iOS}} or {{xt|Android}}, not {{!xt|App Store}} or {{!xt|Google Play}}
::The original platform, not {{!xt|PlayStation Now}} or {{!xt|OnLive}}
{{anchor|OSX}}Games that were developed for [[macOS]] should cover the operating system's name as it was at the time of the game's release:
::*[[Classic Mac OS]] (before September 13, 2000)
::*[[Mac OS X]] (September 13, 2000–July 24, 2012)
::*[[OS X]] (July 25, 2012–September 21, 2016)
::*[[macOS]] (September 22, 2016–present)
For short platform lists, consider using {{tl|unbulleted list}} ({{tl|ubl}}) to arrange each platform on its own line. For long platform lists (more than 10 or so platforms), and in which there was a key primary platform, consider using {{tl|collapsible list}}, with its {{para|title}} set to the primary platform (see for example [[Lemmings (video game)]])
|-
| <code>{{vanchor|released}}</code> || || Add release dates according to the <code>platforms</code> field, for English-language regions and the developer's region. Use only general public release dates of full games, not mod, festival, preview, or early access dates. If sourced, use the game's exact release date ("{{CURRENTMONTHNAME}} {{CURRENTDAY}}, {{CURRENTYEAR}}"). Use the {{tl|Video game release}} template: <code><nowiki>{{Video game release|NA|</nowiki>{{CURRENTMONTHNAME}} {{CURRENTDAY}}, {{CURRENTYEAR}}<nowiki>}}</nowiki></code>. If there are many release dates, enclose them all with the {{tl|Collapsible list}} template<ref>[[Template talk:Infobox video game/Archive 9#Collapsible release dates|August 2010 discussion]]</ref> followed by {{para|title}} with a {{tl|Nobold}} template using the earliest release date. Platforms can be [[Template:Video game reviews/doc#Predefined System Type|abbreviated]] to fit in one line and should be listed as bolded section titles without colons, separated with commas (e.g., '''PC''', '''3DS''', '''PS4'''). Only use WW to provide clarity where a game has various differing release dates including multiple regional release dates on some platforms and worldwide on other platforms.
|-
| <code>genre</code> || {{Wikidata entity link|P136}} || The gameplay genre or genres (such as [[first-person shooter]], [[Adventure game|adventure]], etc) the game is categorized in by its developers and publishers, or by reliable sources. Do not include broad gameplay mechanics that are frequently confused with genres, such as [[open world]]. This should not include thematic genres (like [[science fiction]], [[Horror fiction|horror]], etc.) as video games are more difficult to categorize in such a way. Verifiable thematic genres can be mentioned in the article's body.
|-
| <code>modes</code> || {{Wikidata entity link|P404}} || Playing modes offered by the game. Currently, the only accepted values are [[single-player]], [[multiplayer]], or both.<ref>[[Template talk:Infobox video game/Archive 9#"Modes" field|August 2010 discussion]]</ref>
|-
| <code>arcade system</code> || {{Wikidata entity link|P2670}} {{Wikidata entity link|Q631229}}, qualifier {{Wikidata entity link|P31}} || The name of or names associated with the arcade game's [[Arcade system board|system board]] hardware. In case of unique arcade hardware, omit this field and use those below.
|-
| <code>director</code> || {{Wikidata entity link|P57}} || The popular names of the game directors or [[creative director]]s who oversaw the creative development of the game. The names can be wikilinked.
# List only the person credited specifically with the title "director";
# Do not list other types of directors in this field;
# For games directed by a succession of people (e.g. [[Massively multiplayer online game|MMOs]] and games with exceptionally long development cycles), indicate their years of involvement.
|-
| <code>producer</code> || {{Wikidata entity link|P162}} || The popular names of the [[video game producer]]s in overall charge of the production of the game. The names can be wikilinked.
# List only the person credited specifically with the title "producer";
# Do not list the "Executive producer" or other "sub"-producer credits;
# If three or more people are credited as "co-producer"s, discuss whether any one played the most significant part and, if decided, list that person;
# List the "Creative producer" only if said person's involvement in the game is discussed in the article's development-related section.
|-
| <code>designer</code> || {{Wikidata entity link|P287}} || The popular names of the [[video game designer]]s, i.e. people who worked on the game's system. The names can be wikilinked. This field is often unfilled in modern high-budget development due to large team sizes and collaboration. Older games and indie games are more likely to use this position.
# If a single person is credited as "Lead designer", list that person; synonyms for this position include "[game] design director" and "lead planner";
# If there is no equivalent to #1, omit this field;
# If three or more people are credited as "lead designer"s, discuss whether any one played the most significant part and, if decided, list that person.
|-
| <code>programmer</code> || {{Wikidata entity link|P943}} || The popular names of the [[video game programmer]]s. The names can be wikilinked. This field is often unfilled in modern high-budget development due to large team sizes and collaboration. Older games and indie games are more likely to use this position.
# If a single person is credited as "lead programmer", list that person; synonyms for this position may include "technical director";
# If there is no equivalent to #1, omit this field;
# If three or more people are credited as "lead programmer", discuss whether one played the most significant part and, if decided, list that person.
|-
| <code>artist</code> || {{Wikidata entity link|P3080}} || The popular names of the [[video game artist]]s. The names can be wikilinked.
# List the person credited as "art director" or "lead artist";
# List no more than three people in this field.
|-
| <code>writer</code> || {{Wikidata entity link|P50}} || The popular names of the [[video game writer]]s. The names can wikilinked. The writers should be listed in the order of their contribution, with those who wrote the game's scenarios/scripts listed before the game's story writers.
# If a single person is credited as "scenario director" or "scenario writer", list that person; synonyms for this position include "lead writer";
# If there is a person credited as "scenario concept writer" or "[original] concept", also list that person here;
# List no more than three people in this field.
|-
| <code>composer</code> || {{Wikidata entity link|P86}} || The popular names of the [[video game composer]]s.
# List people who contributed significantly to the soundtrack. Discuss inclusion criteria on a per-game basis on the talk page.
|-
| <code>commons</code> || {{Wikidata entity link|P373}} || The commons category link
|}

== Microformat ==
{{UF-hprod}}

== Template revisions ==

=== Style changes ===
Here's a record of previous styles that were very different from one another:
* Gray with alternating colors, but with a gap between cells: [//en.wikipedia.org/w/index.php?title=User:Masem/infobox/vginfobox2&oldid=189384947] ([[Template talk:Infobox VG/Archive 6#Ugly.|discussion]])
* Gray but no alternating colored rows: [//en.wikipedia.org/w/index.php?title=Template:Infobox_VG&oldid=192531349]
* Purple with dark borders: [//en.wikipedia.org/w/index.php?title=Template:Infobox_VG&oldid=186949216]

=== Field changes ===
* '''Input method:''' The input method section was removed on August 14, 2010. ([[Template talk:Infobox video game/Archive 9#"Input method" field|discussion]])
* '''Ratings:''' The ratings section was removed on October 2, 2012. ([[Template talk:Infobox video game/Archive 11#Propose removal of ratings section.|discussion]])
* '''Requirements:''' The requirements section was removed on December 18, 2012. ([[Template talk:Infobox video game/Archive 11#Proposed removal of requirements section|discussion]])
* '''Version:''' The version section was removed on February 24, 2013. ([[Template talk:Infobox video game/Archive 11#Proposal for removal of Version field|discussion]])
* '''Media''': The media field was removed on May 8, 2015. ([[Template talk:Infobox video game/Archive 13#Media|discussion]])
* Arcade specific fields, such as '''cabinet''', '''display''', '''CPU''', and '''sound''', were removed on November 26, 2020. ([[Template talk:Infobox video game#Archive 15#Proposal on arcade fields|discussion]])

== TemplateData ==
{{Notice|This template data section is not complete.}}
{{TemplateData header}}

<templatedata>
{
	"description": "A template to generate an infobox for a video game.",
	"params": {
		"title": {
			"label": "title",
			"description": "Title of the game. If not specified the 'name' parameter or the PAGENAME are used. It should be plain text, do not include a wikilink, hyperlink or image in this parameter.",
			"type": "string/line",
			"required": false
		},
		"collapsible": {
			"label": "collapsible",
			"description": "Whether this screenshot is hidden by default, set to 'yes' to place the screenshot in a collapsible section",
			"type": "string/line",
			"required": false
		},
		"state": {
			"label": "state",
			"description": "Determines the initial collapsed state of the infobox. Set collapsed to put the box in collapsed state initially. Set expanded to put the box in expanded state initially. Set autocollapse to have the box's initial collapsed state be determined automatically based on the number of other templates in the article that also have the \"collapsible\" attribute. (Has no effect if collapsible is not used.)",
			"type": "string",
			"default": "autocollapse",
			"required": false
		},
		"image": {
			"label": "image",
			"description": "File name for a screenshot of the image, e.g. 'GIMP screenshot.png'",
			"type": "wiki-file-name",
			"required": false
		},
		"border": {
			"label": "border",
			"description": "Add a border around the image",
			"type": "string",
			"example": "yes"
		},
		"caption": {
			"label": "caption",
			"description": "A short description of the image.",
			"type": "string",
			"required": false
		},
		"developer": {
			"label": "developer",
			"description": "The popular name(s) of the game developer(s), if confirmed by primary sources.",
			"type": "string",
			"required": false
		},
		"publisher": {
			"label": "publisher",
			"description": "The popular name(s) of the video game publisher(s), if confirmed by primary sources.",
			"type": "string",
			"required": false
		},
		"series": {
			"label": "series",
			"description": "The video game series the game is associated with. Only use this field if there is an article for the series. Wikilink and italicize the name(s) (such as Halo).",
			"type": "string",
			"required": false
		},
		"engine": {
			"label": "engine",
			"description": "The game's engine",
			"type": "string",
			"required": false
		},
		"platforms": {
			"label": "platforms",
			"description": "The unabbreviated console or operating system family the game was specifically developed or officially announced (if not canceled) for. This includes dedicated ports, but not games in emulation or services. See documentation for examples.",
			"type": "string",
			"required": false
		},
		"released": {
			"label": "released",
			"description": "Release date. If possible, use the game's exact release date. Example: November 3, 2013.",
			"type": "string",
			"required": false
		},
		"genre": {
			"label": "genre",
			"description": "The genre of the game, such as first-person shooter, adventure, etc.",
			"type": "string",
			"required": false
		},
		"modes": {
			"label": "modes",
			"type": "string",
			"required": false,
			"description": "Playing modes offered by the game. Currently, the only accepted values are single-player, multiplayer, or both."
		},
		"arcade system": {
			"label": "arcade system",
			"type": "string",
			"required": false
		},
		"Note": {
			"label": "Note",
			"type": "string",
			"required": false
		},
		"director": {
			"label": "director",
			"type": "string",
			"required": false,
			"description": "The popular names of the game directors or creative directors who oversaw the creative development of the game. The names can be wikilinked."
		},
		"producer": {
			"label": "producer",
			"type": "string",
			"required": false,
			"description": "The popular names of the game producers in overall charge of the production of the game. The names can be wikilinked."
		},
		"designer": {
			"label": "designer",
			"type": "string",
			"required": false,
			"description": "The popular names of the game designers, i.e. people who worked on the game's system. The names can be wikilinked. This field is often unfilled in modern high-budget development due to large team sizes and collaboration. Older games and indie games are more likely to use this position."
		},
		"programmer": {
			"label": "programmer",
			"type": "string",
			"required": false,
			"description": "The popular names of the game programmers. The names can be wikilinked. This field is often unfilled in modern high-budget development due to large team sizes and collaboration. Older games and indie games are more likely to use this position."
		},
		"artist": {
			"label": "artist",
			"type": "string",
			"required": false,
			"description": "The popular names of the game's artists. The names can be wikilinked."
		},
		"writer": {
			"label": "writer",
			"type": "string",
			"required": false,
			"description": "The popular names of the game's writers. The names can wikilinked. The writers should be listed in the order of their contribution, with those who wrote the game's scenarios/scripts listed before the game's story writers."
		},
		"composer": {
			"label": "composer",
			"type": "string",
			"required": false,
			"description": "The popular names of the composers who worked on the game's music."
		},
		"fetchwikidata": {
			"label": "fetchwikidata"
		},
		"suppressfields": {
			"label": "suppressfields"
		},
		"onlysourced": {
			"label": "onlysourced"
		},
		"qid": {
			"label": "qid"
		},
		"refs": {
			"label": "refs"
		},
		"noicon": {
			"label": "noicon"
		},
		"alt": {
			"label": "alt"
		}
	},
	"format": "block"
}
</templatedata>

== Tracking categories ==
* {{clc|Articles using Infobox video game using locally defined parameters}}
* {{clc|Pages using infobox video game with unknown parameters}}

== See also ==
* {{tl|Infobox video game series}} for video game franchises and series.
* {{tl|Infobox software}} for general software.
* [[WP:IB]] - list of infoboxes

== Notes ==
{{Reflist}}

<includeonly>{{Sandbox other||
<!-- ADD TEMPLATE CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Video game infobox templates| ]]
[[Category:Embeddable templates]]
[[Category:Infobox templates using Wikidata]]
[[Category:Templates that add a tracking category]]
}}</includeonly>