Template:Infobox snooker player/doc

Usage

{{{name}}}

[[File:{{{image}}}|{{{image_size}}}|alt={{{alt}}}|upright=1]] {{{caption}}}
Born	{{{birth_date}}} {{{birth_place}}}
Died	{{{death_date}}} {{{death_place}}}
Sport country	{{{Sport country}}}
Professional	{{{Professional}}}
Highest ranking	{{{High ranking}}}
Maximum breaks	{{{Official maximums}}}
Best ranking finish	{{{Best finish}}}
Tournament wins
Ranking	{{{Ranking wins}}}
Minor-ranking	{{{Minor wins}}}
World Champion	{{{World champ}}}
Medal record {{{medals}}}

{{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       = 
| Professional        = 
| High ranking        = 
| Official maximums   = 
| Best finish         = 
| Ranking wins        = 
| Minor wins          = 
| World champ         = 
| Women's World champ = <!-- use this for female players' win in the Women's World Championship -->
| medals-expand       = <!-- "yes" to show, hidden by default -->
| medals              = <!-- for displaying snooker medals won in multi-sport events -->
}}

• 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.
• |honorific_suffix= is for things like |honorific_suffix = [[Order of the British Empire|OBE]] – 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 "BA". It is not necessary to use the {{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 |image=ImageName.ext – leaving out the [[...]] bracketing markup causes a table layout error in Internet Explorer. The caption is handled as a separate template parameter, |caption=, not a [[File:...]] parameter.
• The official rankings for the current season are available 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 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 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 |Ranking wins= and |Minor wins= parameters, apart from the |World champ= parameter, where you can list the years. The |Minor wins= should only be used for minor-ranking tournaments.
• The |Official maximums= parameter is number of official maximum breaks achieved during the player's professional career.
• The |Best finish= parameter is for listing the best performance of players who have not won a ranking tournament. Generally use Runner-up, Semi-final, Quarter-final, Last 16, Last 24 or Last 32, followed by the number of times they have reached this stage, eg "(x1)". These achievements should be mentioned in the prose. Do not update until the player has "finished" in a tournament. This parameter is not used for players who have never reached the Last 32 stage.
• The |Sport country= parameter is used here to reflect the sporting nationality of players as competitors. These generally match 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 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 here. The BBC have also adopted this usage as can be seen 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 |Sport country= parameter in the infobox. Format: |Sport country={{flag|CountryName}} or |Sport country={{CountryCode}}
• 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).

Current ranking

The infobox also contains a "Current ranking" field. Data for this field is not stored in the player's infobox but in a separate file: Template:Infobox snooker player/rankings.

Nickname

The infobox also contains a "Nickname" field. Data for this field is not stored in the player's infobox but in a separate file: Template:Infobox snooker player/nicknames.

Century breaks

The infobox also contains a "Century breaks" field. Data for this field is not stored in the player's infobox but in a separate file: Template:Infobox snooker player/century breaks.

Example

Ronnie O'Sullivan
OBE

O'Sullivan at the 2015 German Masters
Born	(1975-12-05) 5 December 1975 Wordsley, West Midlands, England
Sport country	England
Nickname	the Rocket
Professional	1992–present
Highest ranking	1 (May 2002 – May 2003, May 2004 – May 2006, May 2008 – May 2010, March–August 2019, April 2022–present)
Current ranking	1 (as of 19 February 2024)
Maximum breaks	15
Century breaks	1,254 (as of 23 March 2024)
Tournament wins
Ranking	40
Minor-ranking	3
World Champion	2001 2004 2008 2012 2013 2020 2022

{{Infobox snooker player
| name             = Ronnie O'Sullivan
| honorific_suffix = {{post-nominals|country=GBR|OBE|size=100%}}
| image            = Ronnie O’Sullivan at Snooker German Masters (DerHexer) 2015-02-06 07.jpg
| image_size       = 
| caption          = O'Sullivan at the [[2015 German Masters]]
| birth_date       = {{birth date and age|1975|12|05|df=yes}}
| birth_place      = [[Wordsley, West Midlands|Wordsley]], [[West Midlands (region)|West Midlands]], England
| Sport country    = {{ENG}}
| Professional     = 1992–present
| High ranking     = '''[[List of world number one snooker players|1]]''' (May 2002 – May 2003, May 2004 – May 2006, May 2008 – May 2010, March–August 2019, April 2022–present)
| Official maximums = 15
| Ranking wins     = 40
| Minor wins       = 3
| World champ      = {{Hlist|[[2001 World Snooker Championship|2001]] | [[2004 World Snooker Championship|2004]] | [[2008 World Snooker Championship|2008]] | [[2012 World Snooker Championship|2012]] | [[2013 World Snooker Championship|2013]] | [[2020 World Snooker Championship|2020]] | [[2022 World Snooker Championship|2022]]}}
}}

Microformat

The HTML markup produced by this template includes an hCard microformat, which makes the person's details parsable by computers, either acting automatically to catalogue articles across Wikipedia or via a browser tool operated by a reader, to (for example) add the subject to an address book or database. For more information about the use of microformats on Wikipedia, please see the microformat project.

Sub-templates

Date-of-birth ("bday") information will only be included in the microformat if {{birth date}}, or {{birth date and age}} are used in the infobox. (Do not use these if the date is before 1583). Be cautious about using these if the person is still living, per WP:DOB.

To include a URL, use {{URL}}.

Please do not remove instances of these sub-templates.

Classes

hCard uses HTML classes including:

• adr
• agent
• bday
• birthplace
• category
• country-name
• deathdate
• deathplace
• extended-address
• family-name
• fn (required)
• given-name
• honorific-prefix
• honorific-suffix
• label
• locality
• n
• nickname
• note
• org
• role
• url
• vcard

Please do not rename or remove these classes nor collapse nested elements which use them.

Tracking category

• Category:Pages using Infobox snooker player with unknown parameters (3)