View source for Template:Infobox snooker player/doc

{{Documentation subpage}}
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Wikidata|Module:Check for unknown parameters}}
{{Uses Wikidata|P18}}

== Usage ==
{{Parameter names example | name | image | image_size | alt | caption | birth_date | birth_place | death_date | death_place | Sport country | Nickname | Professional | High ranking | Prize money | High break | Century break | Best finish | Ranking wins | Minor wins | Major wins | Other wins | World champ | website }}

<pre style="overflow: auto;">
{{Infobox snooker player
| name             = 
| honorific_suffix =
| image            = 
| image_size       = 
| alt              = 
| caption          = 
| birth_date       = <!-- {{Birth date and age|YYYY|MM|DD|df=yes}} -->
| birth_place      = 
| death_date       = <!-- {{Death date and age|YYYY|MM|DD|YYYY|MM|DD|df=yes}} -->
| death_place      = 
| Sport country    = 
| Nickname         = 
| Professional     = 
| High ranking     = 
| Prize money      = 
| High break       = 
| Century break    = 
| Best finish      = 
| Ranking wins     = 
| Major wins       = 
| Minor wins       = 
| Other wins       = 
| World champ      = 
| UK champ         = 
| website          = <!-- {{URL|www.Example.com}} and leave off the "www." part if not necessary -->
}}
</pre>
{{clear}}

* '''All information in the infobox should also be in the article prose''', in some (usually ''more'' not less detailed) form, '''and should be sourced there.'''  Please do ''not'' put reference citations in the infobox nor add information to the infobox before adding it the main article text.  Infoboxes are convenient ''summaries'' of important stats from articles; they are ''not'' mini-articles unto themselves and should not be treated as such.
* {{para|honorific_suffix}} is for things like <code><nowiki>|honorific_suffix = [[Order of the British Empire|OBE]]</nowiki></code> – honorifics of serious significance that are attached to the name in formal address, such as knighthoods and non-honorary doctorates; do not use it for routine things like "[[Bachelor of arts|BA]]". It is not necessary to use the {{tlx|post-nominals}} template in this parameter; doing so will make the output smaller (that template is intended for inline use in the article lead, and uses small-caps style).
* Images must be specified in a format like {{para|image|<nowiki /><var>ImageName.ext</var>}} – leaving out the <code><nowiki>[[...]]</nowiki></code> bracketing markup causes a table layout error in Internet Explorer.  The caption is handled as a separate template parameter, {{para|caption}}, not a <code><nowiki>[[File:...]]</nowiki></code> parameter.
* The official rankings for the current season are available [http://www.worldsnooker.com/page/WorldRankingsArticle/0,,13165~2216576,00.html here]. '''Do not''' use ''provisional rankings'' in the infobox, although they can be included (if noted as provisional) in the main text of the article. Wait until the official rankings are released for the next season (or when the season has just finished, use the rankings from [http://www.global-snooker.com/world-professional-snooker-ranking-lists.asp here] as they are usually correct, and the official rankings take a long time before they are released) before editing the data in the infobox; also wait until the parameter name is '''changed''' to reflect the current season and the '''article''' for the next seasons rankings are made. Make sure '''all''' articles that contain this infobox are updated; this should be done in one long editing session when the infobox parameter is updated, to ensure that none of them are left out. This will probably be co-ordinated from [[Wikipedia:WikiProject Snooker|WikiProject Snooker]].
* Fill in what tournaments a player has won in the actual article, in a separate section from the rest, rather than in the infobox. Only list the ''number of events'' that player has won, in the infobox's '''{{para|Ranking wins}}''' and '''{{para|Other wins}}''' parameters, apart from the '''{{para|World champ}}''' '''{{para|UK champ}}''' parameter, where you can list the years. Please don't add amateur, pro-am, team and non-snooker titles to the {{para|Other wins}} parameter.
* If a player has won all their tournaments before the 1973/1974 season ([[Snooker world rankings 1976/1977|1976/1977]] is when the first snooker world rankings were published), list them under '''{{para|Major wins}}''', like in the [[John Pulman]], [[Fred Davis (billiards player)|Fred Davis]] and [[Walter Donaldson (snooker player)|Walter Donaldson]] articles.
* The {{para|Minor wins}} should be used for minor-ranking tournaments.
* If a player has won some tournaments before and after the 1973/1974 season, list them according to [[List of snooker tournaments]].
* The '''{{para|High break}}''' parameter is for the highest break achieved during the player's professional career. The highest break for an amateur player can also be added, but if the player turns professional then their professional highest break should be used (even if this is lower than their amateur highest break).
* The '''{{para|Century break}}''' parameter is for the number of century breaks achieved by the player during their professional career. This parameter should not be used for amateur players.
* The '''{{para|Best finish}}''' parameter is for listing the best performance of players who have '''not''' won a ranking tournament yet, and should list the tournament that the player has progressed '''furthest''' in. (Or if the player has reached this stage more than three, than just a number. This achievements should be mentioned in the prose.)
* The '''{{para|Sport country}}''' parameter is used here to reflect the ''sporting nationality'' of players as competitors. These generally match [[List of FIFA country codes|those of FIFA]]. It is ''not the player's legal citizenship'' (which will often be the same but need not be).  In snooker, as in association football, rugby, etc., players usually represent [[Sovereignty|sovereign]] [[nation-states]], but may represent non-sovereign sub-national entities, such as the constituent countries of the UK (England, Wales, Scotland and Northern Ireland) for sporting purposes. It is not just Wikipedia that does this, as can be seen at the official [[International Billiards and Snooker Federation]] website [http://www.ibsf.info/past-champions.shtml here]. The [[BBC]] have also adopted this usage as can be seen [http://news.bbc.co.uk/sport1/hi/other_sports/snooker/results/default.stm here].  The Wikipedia usage reflects the real-life usage within the sport.  This is a ''snooker player infobox'', not a general biography box and its purpose is to express information about the player in relation to their sport.  Finally, this parameter should not be used at all for snooker personages not notable as pro or top-flight amateur players, but for another role such as referee, announcer, etc.
* '''Flag templates''': Please use flags properly, per [[Wikipedia:Manual of Style (icons)]]:
:* Flag templates are ''only'' used for the '''{{para|Sport country}}''' parameter in the infobox (and ''should'' be used there, with the excepetion of Northern Ireland, for which see below).  Format: {{Para|Sport country|{<nowiki />{flag{{!}}<var>CountryName</var><nowiki>}}</nowiki>}} or {{Para|Sport country|{<nowiki />{<var>CountryCode</var><nowiki>}}</nowiki>}}
:* Flag templates are ''never'' used for birth/death places (per [[Wikipedia:Manual of Style (icons)]]), as this improperly implies citizenship/nationality that simply may not apply (many people are born, and even die, abroad).
:* Emphatically do '''not''' use the [[Flag of Northern Ireland|Ulster banner]], {{tlx|flag|Northern Ireland}} or {{tl|NIR}}: {{NIR}} for "Sport country" in snooker player infoboxes. This flag does not officially or civically represent N.I. any longer and hasn't in years. Meanwhile (much more seriously) use of the flag to indicate someone's nationality, in any sense, is a major [[WP:NPOV|point of view]] problem in a Wikipedia article.  The flag is a major Unionist political rallying symbol; using it in infoboxes will, for many readers, imply a political position not a nationality, much less a sporting nationality.  Technically, the proper infobox usage for people from N.I. would be {{para|Sport country|<nowiki>{{Flagicon|United Kingdom}} [[Northern Ireland]]</nowiki>}}. Irish Nationalists are equally offended by this, however, making that, too, a PoV-pushing issue. Just don't use a flag for Northern Irish snooker player infoboxes.  Therefore simply use {{para|Sport country|[[Northern Ireland]]}}.
:* The Ulster Banner ''is'' appropriate for use in ''sports statistics'' tables, such as tournament results, because the flag, curiously, ''does'' have official status in various sport federations as the flag of N.I. for sporting purposes, and it carries no political connotations when used in this context.  So, for example, Alex Higgins should have no flag in his infobox, but in ranking tournament results would have the Ulster Banner.
* '''website''': use {{Tl|URL}}.

== Example ==
{{Infobox snooker player
| name          = Ronnie O'Sullivan
| image         = Stephen Maguire, Ronnie O’Sullivan, and Michaela Tabb at German Masters Snooker Final (DerHexer) 2012-02-05 05 cropped.jpg
| caption       = O'Sullivan in 2012
| birth_date    = {{birth date and age|1975|12|5|df=yes}}
| birth_place   = [[Wordsley]], [[West Midlands (county)|West Midlands]]
| Sport country = {{flag|England}}
| Nickname      = The Rocket<br />The Essex Exocet<br />The Magician
| Professional  = 1992–
| High ranking  = [[List of world number one snooker players|1]] (3 years)
| Prize money   = [[Pound sterling|UK£]]5,161,560
| High break    = 147 (10 times)
| Century break = 625
| Ranking wins  = 22
| Other wins    = 22
| World champ   = [[2001 World Snooker Championship|2001]], [[2004 World Snooker Championship|2004]], [[2008 World Snooker Championship|2008]]
| website       = {{URL|ronnieosullivan.tv}}
}}

<pre style="overflow: auto;">
{{Infobox snooker player
| name          = Ronnie O'Sullivan
| image         = Stephen Maguire, Ronnie O’Sullivan, and Michaela Tabb at German Masters Snooker Final (DerHexer) 2012-02-05 05 cropped.jpg
| caption       = O'Sullivan in 2012
| birth_date    = {{birth date and age|1975|12|5|df=yes}}
| birth_place   = [[Wordsley]], [[West Midlands (county)|West Midlands]]
| Sport country = {{flag|England}}
| Nickname      = The Rocket<br />The Essex Exocet<br />The Magician
| Professional  = 1992–
| High ranking  = [[List of world number one snooker players|1]] (3 years)
| Prize money   = [[Pound sterling|UK£]]5,161,560
| High break    = 147 (10 times)
| Century break = 625
| Ranking wins  = 22
| Other wins    = 22
| World champ   = [[2001 World Snooker Championship|2001]], [[2004 World Snooker Championship|2004]], [[2008 World Snooker Championship|2008]]
| website       = {{URL|ronnieosullivan.tv}}
}}
</pre>
{{clear}}

== Microformat ==
{{UF-hcard-person}}

== Tracking category ==
* {{clc|Pages using Infobox snooker player with unknown parameters}}

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Sportsperson infobox templates|Snooker player]]
[[Category:Snooker infobox templates|Player]]
[[Category:Infobox templates using Wikidata]]
[[Category:Templates that add a tracking category]]
}}</includeonly>