Template:Infobox cricketer/doc

This template may be used as a module (sub-template) of Infobox person; see Infobox modules for guidance on such usage.

Blank
Place and fill out a copy of one of the following templates at the start of a player's article. Redundant fields may be deleted.

Note: for  entries, use YYYY if player alive, otherwise.

International player
Suitable for most international players.

Domestic player
A shortened list of the available fields suitable for a domestic player.

Basic

 * name: Player's commonly used 'cricket' name (e.g. Len Hutton, AB de Villiers). Note, the name is suppressed if yes.
 * honorific_prefix : For things like  – honorifics of serious significance that are attached to the name in formal address, such as knighthoods and titles of nobility; do not use it for routine things like "Dr." or "Ms.".
 * honorific_suffix : For things like  – honorifics of serious significance that are attached to the name in formal address, such as national orders and non-honorary doctorates; do not use it for routine things like "BA". It is not necessary to use the  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).
 * female: Enter "true" if female
 * image: An image of the subject. Type the name of the image file without adding  before it or wikilinking it. If no image is available yet, do not use an image placeholder.
 * image_size or imagesize: The image size in pixels. Use only when absolutely necessary. Examples: 200px (set width), x300px (set height), or 200x300px (max width & max height).
 * image_upright: Scales the image thumbnail from its default size by the given factor. Values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%).
 * landscape: Set to "yes" when using wide, short images. The image height (rather than width) will be limited to 200 pixels.
 * alt: Alternative text for image, for visually impaired readers (see WP:ALT)
 * caption: A caption for the image displayed. Include date of photograph, if known.
 * full_name or fullname: The player's full name, if different than name.
 * birth_date: The player's birth date. If living, use Birth date and age, Birth-date and age, or Birth year and age. If deceased, use Birth date or Birth-date.
 * birth_place: The player's place of birth. Do not use a flag template; There is no need to link major geographic features such as major country names or the names of global cities such as London.
 * death_date: The player's death date, if applicable. If the date of birth is known, use Death date and age, Death-date and age, or Death year and age. Otherwise, use Death date or Death-date.
 * death_place: The player's place of death, if applicable. Do not use a flag template. There is no need to link major geographic features such as major country names or the names of global cities such as London or to link the same place name if the player was born in the same location.
 * nickname: The player's common nickname. This must be frequently used by reliable sources in reference to the subject per MOS:NICKCRUFT. This would be the case for players such as Ian Botham or Ricky Ponting or, possibly, John Crawley whose nickname appears in his CricInfo profile. In particular note that MOS:BIO says that "a sports journalist's one-off reference to a player [using a name] does not constitute a nickname, and treating it as one is original research".
 * height: The player's height in feet and inches, centimetres, or metres (e.g. 6 ft 2 in or 193 cm or 1.93 m). The infobox will automatically display the appropriate conversion within parentheses.
 * heightft and heightinch: 'or' Enter height in feet and inches (e.g. 6 and 2)
 * heightcm: 'or' Enter height in centimetres (e.g. 193)
 * heightm: 'or' Enter height in metres (e.g. 1.93)
 * batting: Enter "Right-handed" or "Left-handed". There is no need to link these.
 * bowling: Enter style of bowling – (e.g. Right-arm medium or Slow left-arm or Slow left-arm wrist-spin)
 * role: Enter either Batsman, Bowler, All-rounder or Wicket-keeper
 * family: Enter wikilinks to other notable relatives, followed by relationship in s. (e.g. Adam Hollioake (brother)]]
 * website: Enter official website of player if any; use URL

International

 * international: Enter "true" if an international player (Test, ODI or T20I)
 * country: Enter country unlinked, (e.g. England, Australia)
 * country2/3: used if a player played for more than one nation (e.g. Kepler Wessels)
 * internationalspan: Enter YYYY–YYYY (only for players from non-Test/ODI/T20I countries)
 * internationalspan2/3:
 * onetest: Enter "true" if only played one Test
 * testdebutdate: Enter day and month in form dd MMMM (6 June) of first day of match
 * testdebutyear: Enter YYYY
 * testdebutfor: only displays when country2 is set...
 * testdebutagainst: Enter opponent (unlinked) (e.g. New Zealand)
 * testcap: Enter country 'cap' number (see e.g. List of English Test cricketers)
 * testcap2:
 * lasttestdate: (first day of match)
 * lasttestyear:
 * lasttestfor: see "testdebutfor"
 * lasttestagainst:
 * oneodi: Enter "true" if only played one ODI
 * odidebutdate:
 * odidebutyear:
 * odidebutfor: see "testdebutfor"
 * odidebutagainst:
 * odicap: Enter country 'cap' number (see e.g. List of English ODI cricketers)
 * odicap2:
 * odishirt: ODI shirt number (n.b. not the same as cap)
 * lastodidate:
 * lastodiyear:
 * lastodifor: Only use this for "Africa XI", "Asia XI" or "World XI" (also if country2 is set)
 * lastodiagainst:
 * oneT20I:
 * T20Idebutdate:
 * T20Idebutyear:
 * T20Idebutfor: see "testdebutfor"
 * T20Idebutagainst:
 * T20Icap:
 * T20Icap2:
 * lastT20Idate:
 * lastT20Iyear:
 * lastT20Ifor: see "testdebutfor"
 * lastT20Iagainst:
 * T20Ishirt:

Club

 * club1, club2, club3 … club17: Link to name of most recent/current clubs: (e.g. Yorkshire). Only include clubs that the player has actually played for.
 * year1, year2, year3 … year17: Enter years at recent club using ndash (e.g. 2004–2006, or 2006–present)
 * clubnumber1, clubnumber2, clubnumber3 … clubnumber17: Enter most recent squad number if known
 * type1, type2: For debut information. Enter type (e.g. "First-class", "List A" - which can be piped as FC). Only two types are available - type3 will not display
 * onetype1, onetype2: "true" if only one match of the type has been played
 * debutdate1, debutdate2: DD MMMM for first day of match
 * debutyear1, debutyear2: YYYY for the year of debut
 * debutfor1, debutfor2: Wikilink club played for
 * debutagainst1, debutagainst2: Wikilink club played against
 * lastdate1, lastdate2: Final "type1" match, DD MMMM etc... Avoid using for current players
 * lastyear1, lastyear2:
 * lastfor1, lastfor2:
 * lastagainst1, lastagainst2:

Umpires

 * umpire: Enter "true" if player has stood as an international umpire
 * testsumpired: Enter number of Test matches umpired
 * umptestdebutyr: Enter year of first umpired Test match
 * umptestlastyr: Enter year of last umpired Test match if different from debut year


 * odisumpired: Enter number of ODI matches umpired
 * umpodidebutyr: Enter year of first umpired ODI match
 * umpodilastyr: Enter year of last umpired ODI match if different from debut year


 * t20isumpired: Enter number of Twenty20 International matches umpired
 * umpt20idebutyr: Enter year of first umpired Twenty20 International match
 * umpt20ilastyr: Enter year of last umpired Twenty20 International match if different from debut year


 * wtestsumpired: Enter number of women's Test matches umpired
 * umpwtestdebutyr: Enter year of first umpired women's Test match
 * umpwtestlastyr: Enter year of last umpired women's Test match if different from debut year


 * wodisumpired: Enter number of women's ODI matches umpired
 * umpwodidebutyr: Enter year of first umpired women's ODI match
 * umpwodilastyr: Enter year of last umpired women's ODI match if different from debut year


 * wt20isumpired: Enter number of women's Twenty20 International matches umpired
 * umpwt20idebutyr: Enter year of first umpired women's Twenty20 International match
 * umpwt20ilastyr: Enter year of last umpired women's Twenty20 International match if different from debut year


 * fcumpired: Enter number of first-class matches umpired
 * umpfcdebutyr: Enter year of first umpired first-class match
 * umpfclastyr: Enter year of last umpired first-class match if different from debut year


 * listaumpired: Enter number of List A matches umpired
 * umplistadebutyr: Enter year of first umpired List A match
 * umplistalastyr: Enter year of last umpired List A match if different from debut year


 * t20umpired: Enter number of Twenty20 matches umpired
 * umpt20debutyr: Enter year of first umpired Twenty20 match
 * umpt20lastyr: Enter year of last umpired Twenty20 match if different from debut year

Stats
Up to 4 Column types can be used for different codes of the game. Suggested 4 are Test, ODI, FC, LA. Others may be used to make up the columns (T20I, T20, TRO. N.B. It was agreed that T20 figures would only be used to pad out the four columns, and as such they would come at the end of the infoboxes. Test, ODI, FC and LA will occupy the standard four, if one is missing, move the others to a prior column, freeing the space at the end. Giving for example, "Test, FC, LA, T20" or "ODI, T20I, FC, LA" or "FC, LA, T20, U-19". In other words, the priority columns occupy the first available column. The total number of columns can be set from 1 to 4.


 * hidedeliveries: "true" if the player has never bowled, which will hide the bowling statistics (NB: this must be set to true; anything else displays the rows)
 * columns: number of stats columns required "1", "2", "3", "4" – if left blank the statistics section is omitted


 * column1, column2, column3, column4: wikilink code of game e.g. Test, LA
 * matches1, matches2, matches3, matches4: Number of matchtype1 played
 * runs1, runs2, runs3, runs4: Number of runs scored
 * bat avg1, bat avg2, bat avg3, bat avg4: The player's batting average, generally to two decimal places
 * 100s/50s1, 100s/50s2, 100s/50s3, 100s/50s4: Numbers of centuries/half-centuries
 * top score1, top score2, top score3, top score4: The top score in each format. If the top score is not out it is helpful to link the * used, e.g. *
 * deliveries1, deliveries2, deliveries3, deliveries4: Number of balls bowled. See hidedeliveries above
 * wickets1, wickets2, wickets3, wickets4:
 * bowl avg1, bowl avg2, bowl avg3, bowl avg4: An ndash would be used if no wickets have been taken
 * fivefor1, fivefor2, fivefor3, fivefor4: Number of 5 wicket innings. This should be 0 if any wickets have been taken
 * tenfor1, tenfor2, tenfor3, tenfor4: Number of 10 wicket matches. This should be 0 if any wickets have been taken for any form of the game
 * best bowling1, best bowling2, best bowling3, best bowling4: Best bowling figures for an innings (not over two innings of a match)
 * catches/stumpings1, catches/stumpings2, catches/stumpings3, catches/stumpings4: Enter number of catches and number of stumpings separated by / e.g. 12/1


 * source: Enter full address to the source used, for example the player's CricInfo profile followed by the name of the source. If a single web address is used there is no need to enclose the link in square brackets
 * date: Enter day of last update in DD MMMMM format e.g. 19 November
 * year: Enter year of last update e.g. 2007

Formatting

 * child: If set to "yes", produces a child infobox suitable for use inside other infoboxes.
 * headerstyle: a custom CSS style for the header fields. The default is "background-color: #b0c4de".

Use as a child template
The child or embed parameter is used when embedding this infobox into another.

TemplateData
{	"description": "An Infobox for cricketers. The list of parameters is intimidating; they don't all need filling.", "params": { "name": { "label": "Name", "description": "Player's commonly used 'cricket' name (e.g. Len Hutton, AB de Villiers)", "type": "string", "required": true },		"female": { "description": "Enter \"true\" if female", "type": "string" },		"image": { "label": "Image name", "description": "Image of player.jpg", "type": "wiki-file-name", "suggested": true },		"image_size": { "aliases": [ "imagesize", "image size" ],			"label": "Image size", "description": "The image size. Use only when absolutely necessary.", "type": "string" },		"image_upright": { "required": false, "label": "Image upright", "type": "string", "description": "Scales the image thumbnail from its default size by the given factor. Values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%)." },		"landscape": { "label": "Landscape", "description": "Set to 'yes' when using wide, short images. The image height (rather than width) will be limited to 200 pixels.", "type": "boolean" },		"alt": { "label": "Alternative text", "description": "Alternative text for the image, used when the image cannot be load or by the screenreaders for visually disabled people.", "type": "string" },		"caption": { "label": "Caption", "description": "A caption for the image displayed.", "type": "string", "aliases": [ "image caption", "image_caption" ]		},		"full_name": { "aliases": [ "fullname" ],			"label": "Full name", "description": "The player's full name, if different than \"name\".", "type": "string" },		"birth_date": { "label": "Birth date", "description": "The player's birth date. Use year if living or if deceased.", "type": "string" },		"birth_place": { "label": "Birth place", "description": "The player's place of birth. Do not use a flag template.", "type": "string" },		"death_date": { "label": "Death date", "description": "The player's death date, if applicable. Use death year.", "type": "string" },		"death_place": { "label": "Death place", "description": "The player's place of death, if applicable. Do not use a flag template.", "type": "string" },		"nickname": { "label": "Nickname", "description": "The player's common nickname.", "type": "string" },		"height": { "label": "Height", "description": "The player's height. Use \"XXX cm\", \"X.XX m\", or \"X ft Y in\" (without quotation marks). The infobox will display the appropriate conversion within parentheses.", "type": "string" },		"heightft": { "label": "Height (ft)", "description": "Alternative height parameter. Only ft and in OR metres OR cm is needed. The infobox will display the appropriate conversion within parentheses.", "type": "number" },		"heightinch": { "label": "Height (in)", "description": "Alternative height parameter. Only ft and in OR metres OR cm is needed. The infobox will display the appropriate conversion within parentheses.", "type": "number" },		"heightcm": { "label": "Height (cm)", "description": "Alternative height parameter. Only ft and in OR metres OR cm is needed. The infobox will display the appropriate conversion within parentheses.", "type": "number" },		"heightm": { "label": "Height (m)", "description": "Alternative height parameter. Only ft and in OR metres OR cm is needed. The infobox will display the appropriate conversion within parentheses.", "type": "number" },		"batting": { "label": "Batting hand", "description": "Enter \"Right-handed\" or \"Left-handed\"", "type": "string", "suggested": true },		"bowling": { "label": "Bowling style", "description": "Enter style of bowling – (e.g. Right-arm Medium or Slow left-arm or Slow left-arm chinamen)", "type": "string", "suggested": true },		"role": { "description": "Enter either Batsman, Bowler, All-rounder or Wicket-keeper", "type": "string", "suggested": true },		"family": { "description": "Enter wikilinks to other notable relatives, followed by relationship in s. (e.g. AJ Hollioake (brother)",			"type": "content"		},		"website": {			"description": "Enter official website of the player using www.website.com",			"type": "content"		},		"international": {			"description": "Enter \"true\" if an international player (Test or ODI)",			"type": "string"		},		"country": {			"description": "Enter country unlinked, (e.g. England, Australia)",			"type": "string"		},		"country2": {			"description": "Used if a player played for more than one nation (e.g. Kepler Wessels)",			"type": "string"		},		"country3": {			"description": "Used if a player played for more than one nation (e.g. Kepler Wessels)",			"type": "string"		},		"internationalspan": {			"description": "Enter YYYY–YYYY",			"type": "string"		},		"internationalspan2": {			"description": "Enter YYYY–YYYY",			"type": "string" },		"internationalspan3": { "description": "Enter YYYY–YYYY", "type": "string" },		"onetest": { "label": "Only one Test", "description": "Enter \"true\" if only played one Test", "type": "string" },		"testdebutdate": { "label": "Test debut date", "description": "Enter day and month in form dd MMMM (6 June) of first day of match", "type": "string" },		"testdebutyear": { "label": "Test debut year", "description": "Enter YYYY", "type": "number" },		"testdebutfor": { "description": "only displays when country2 is set..." },		"testdebutagainst": { "label": "Test debut opponent", "description": "Enter opponent (unlinked) (e.g. New Zealand)", "type": "string" },		"testcap": { "label": "Test cap", "description": "Enter country 'cap' number (see e.g. List of English Test cricketers)", "type": "number" },		"testcap2": {}, "lasttestdate": {}, "lasttestyear": {}, "lasttestfor": {}, "lasttestagainst": {}, "oneodi": { "label": "Only one ODI", "description": "Enter \"true\" if only played one ODI", "type": "string" },		"odidebutdate": { "label": "ODI debut date", "description": "Enter day and month in form dd MMMM (6 June) of first day of match" },		"odidebutyear": { "label": "ODI debut year", "description": "Enter YYYY" },		"odidebutfor": {}, "odidebutagainst": { "label": "ODI debut against", "description": "Enter opponent (unlinked) (e.g. New Zealand)" },		"odicap": { "label": "ODI cap", "description": "Enter country 'cap' number (see e.g. List of English ODI cricketers)", "type": "number" },		"odicap2": {}, "lastodidate": {}, "lastodiyear": {}, "lastodifor": {}, "lastodiagainst": {}, "odishirt": {}, "oneT20I": {}, "T20Idebutdate": {}, "T20Idebutyear": {}, "T20Idebutfor": {}, "T20Idebutagainst": {}, "T20Icap": {}, "T20Icap2": {}, "lastT20Idate": {}, "lastT20Iyear": {}, "lastT20Ifor": {}, "lastT20Iagainst": {}, "T20Ishirt": {}, "club1": {}, "year1": {}, "clubnumber1": {}, "club2": {}, "year2": {}, "clubnumber2": {}, "club3": {}, "year3": {}, "clubnumber3": {}, "club4": {}, "year4": {}, "clubnumber4": {}, "club5": {}, "year5": {}, "clubnumber5": {}, "club6": {}, "year6": {}, "clubnumber6": {}, "club7": {}, "year7": {}, "clubnumber7": {}, "club8": {}, "year8": {}, "clubnumber8": {}, "club9": {}, "year9": {}, "clubnumber9": {}, "club10": {}, "year10": {}, "clubnumber10": {}, "club11": {}, "year11": {}, "clubnumber11": {}, "club12": {}, "year12": {}, "clubnumber12": {}, "club13": {}, "year13": {}, "clubnumber13": {}, "club14": {}, "year14": {}, "clubnumber14": {}, "club15": {}, "year15": {}, "clubnumber15": {}, "club16": {}, "year16": {}, "clubnumber16": {}, "club17": {}, "year17": {}, "clubnumber17": {}, "onetype1": {}, "type1": {}, "debutdate1": {}, "debutyear1": {}, "debutfor1": {}, "debutagainst1": {}, "lastdate1": {}, "lastyear1": {}, "lastfor1": {}, "lastagainst1": {}, "onetype2": {}, "type2": {}, "debutdate2": {}, "debutyear2": {}, "debutfor2": {}, "debutagainst2": {}, "lastdate2": {}, "lastyear2": {}, "lastfor2": {}, "lastagainst2": {}, "umpire": {}, "testsumpired": {}, "umptestdebutyr": {}, "umptestlastyr": {}, "odisumpired": {}, "umpodidebutyr": {}, "umpodilastyr": {}, "t20isumpired": {}, "umpt20idebutyr": {}, "umpt20ilastyr": {}, "wtestsumpired": {}, "umpwtestdebutyr": {}, "umpwtestlastyr": {}, "wodisumpired": {}, "umpwodidebutyr": {}, "umpwodilastyr": {}, "wt20isumpired": {}, "umpwt20idebutyr": {}, "umpwt20ilastyr": {}, "fcumpired": {}, "umpfcdebutyr": {}, "umpfclastyr": {}, "listaumpired": {}, "umplistadebutyr": {}, "umplistalastyr": {}, "t20umpired": {}, "umpt20debutyr": {}, "umpt20lastyr": {}, "columns": {}, "column1": {}, "column2": {}, "column3": {}, "column4": {}, "matches1": {}, "matches2": {}, "matches3": {}, "matches4": {}, "runs1": {}, "runs2": {}, "runs3": {}, "runs4": {}, "bat avg1": {}, "bat avg2": {}, "bat avg3": {}, "bat avg4": {}, "100s/50s1": {}, "100s/50s2": {}, "100s/50s3": {}, "100s/50s4": {}, "top score1": {}, "top score2": {}, "top score3": {}, "top score4": {}, "hidedeliveries": {}, "deliveries1": {}, "deliveries2": {}, "deliveries3": {}, "deliveries4": {}, "wickets1": {}, "wickets2": {}, "wickets3": {}, "wickets4": {}, "bowl avg1": {}, "bowl avg2": {}, "bowl avg3": {}, "bowl avg4": {}, "fivefor1": {}, "fivefor2": {}, "fivefor3": {}, "fivefor4": {}, "tenfor1": {}, "tenfor2": {}, "tenfor3": {}, "tenfor4": {}, "best bowling1": {}, "best bowling2": {}, "best bowling3": {}, "best bowling4": {}, "catches/stumpings1": {}, "catches/stumpings2": {}, "catches/stumpings3": {}, "catches/stumpings4": {}, "source": {}, "date": {}, "year": {} } }