Template:Infobox snooker player/doc

Usage

{{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     = 
| Official maximums = 
| Best finish      = 
| Ranking wins     = 
| Minor wins       = 
| World champ      = 
| medals-expand    = <!-- "no" to hide, shown 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 (and should be used there, with the excepetion of Northern Ireland, for which see below). 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).
• Emphatically do not use the Ulster banner, {{flag|Northern Ireland}} or {{NIR}}: Northern Ireland 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 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 |Sport country={{Flagicon|United Kingdom}} [[Northern Ireland]]. 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 |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.

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.

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

File:Stephen Maguire, Ronnie O’Sullivan, and Michaela Tabb at German Masters Snooker Final (DerHexer) 2012-02-05 05 cropped.jpg O'Sullivan in 2012
Born	(1975-12-05) 5 December 1975 Wordsley, West Midlands
Sport country	England
Nickname	The Rocket The Essex Exocet The Magician
Professional	1992–
Highest ranking	1 (3 years)
Current ranking	1 (as of 19 December 2022)
Maximum breaks	10
Century breaks	1,193 (as of 16 January 2023)
Tournament wins
Ranking	22
World Champion	2001, 2004, 2008

{{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)
| Official maximums    = 10
| Ranking wins  = 22
| World champ   = [[2001 World Snooker Championship|2001]], [[2004 World Snooker Championship|2004]], [[2008 World Snooker Championship|2008]]
}}

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 (0)