View source for Template:Infobox ice hockey player/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Lua|Module:Infobox3cols|Module:InfoboxImage}}

This infobox is to be used for [[ice hockey]] players.  Suggestions on change should be noted in the talk page.

== Usage ==

===Metric: height (cm), weight (kg)===
{{Parameter names example | name | halloffame | image | image_size | alt | caption | birth_date | birth_place | death_date | death_place | height_cm=123 | weight_kg=45 | position | career_end | shoots | catches | team | league | prospect_team | former_teams | prospect_league | played_for | ntl_team=Soviet Union | ntl_team_2=Unified Team | ntl_team_3=Russia | sex | draft | draft_year | draft_team | wha_draft | wha_draft_year | wha_draft_team | career_start | website | medaltemplates | show-medals }}
<pre style="overflow: auto; white-space: pre;">
{{Infobox ice hockey player
| name            = 
| halloffame      = 
| image           = 
| image_size      = 
| alt             = 
| caption         = 
| birth_date      = 
| birth_place     = 
| death_date      = 
| death_place     = 
| height_cm       = 
| weight_kg       = 
| position        = 
| shoots          = 
| catches         = 
| league          = 
| team            = 
| prospect_league = 
| prospect_team   = 
| former_teams    = 
| played_for      = 
| sex             = 
| ntl_team        = 
| ntl_team_2      = 
| ntl_team_3      = 
| draft           = 
| draft_year      = 
| draft_team      = 
| wha_draft       = 
| wha_draft_year  = 
| wha_draft_team  = 
| career_start    = 
| career_end      = 
| website         = 
| medaltemplates  = 
| show-medals     = 
}}
</pre>
{{clear}}

=== Metric: height (m) ===
{{Parameter names example | name= | height_m=1.23 }}
<pre style="overflow: auto;">
| height_m        = 
</pre>

=== Imperial: height (ft/in), weight (lb) ===
{{Parameter names example | name= | height_ft=5 | height_in=6 | weight_lb=120 }}
<pre style="overflow: auto;">
| height_ft       = 
| height_in       = 
| weight_lb       = 
</pre>

== Parameters ==
The only ''required'' parameters are '''name''' and '''career_start''' (failure to fill in data for either of these WILL NOT delete that field from the infobox). You must enter parameter names ''exactly'' as shown below (i.e.: letter case matters!). Please follow the guidelines provided in parenthesis for best results:

=== TemplateData ===
{{TemplateData header}}
<templatedata>
{
	"description": "A template to display an infobox for ice hockey players.",
	"params": {
		"name": {
			"description": "Player's name, if not given the page name is used.",
			"type": "string",
			"default": "{{PAGENAME}}",
			"required": true
		},
		"halloffame": {
			"description": "Year of induction for [[Hockey Hall of Fame]].",
			"type": "number",
			"required": false
		},
		"image": {
			"description": "Image of player (file name only).",
			"type": "string",
			"required": false
		},
		"image_size": {
			"description": "Width in px, default is original image size.  Try to use 230px, if image is too pixelated upon article preview, leave field blank and image will be shrunk to original size.",
			"type": "number",
			"required": false
		},
		"alt": {
			"description": "Image alt text, for visually impaired readers; see [[Wikipedia:Alternative text for images]].",
			"type": "string",
			"required": false
		},
		"caption": {
			"description": "Image caption",
			"type": "string",
			"required": false
		},
		"birth_date": {
			"description": "For living players, use {{birth date and age}}, {{birth-date and age}}, or {{birth year and age}}. For deceased players, use {{birth date}} or {{birth-date}}. Add |df=yes before the }} if you want day-month format instead of month-day.",
			"type": "string",
			"required": false
		},
		"birth_place": {
			"description": "Place of birth. Format appropriate to the country (see [[WP:PLACE]]); use [[country]] as called at time of birth.",
			"type": "string",
			"required": false
		},
		"death_date": {
			"description": "Use {{death date and age}} or {{death-date and age}}.  Add |df=yes before the }} if you want day-month format instead of month-day.",
			"type": "string",
			"required": false
		},
		"death_place": {
			"description": "Place of death (if known). Format appropriate to the country (see [[WP:PLACE]])",
			"type": "string",
			"required": false
		},
		"height_cm": {
			"description": "Player's height (centimeters). Do not use both cm and ft/in.",
			"type": "number",
			"required": false
		},
		"height_m": {
			"description": "Player's height (meters). Do not use both m and ft/in.",
			"type": "number",
			"required": false
		},
		"height_ft": {
			"description": "Player's height (feet; use with height_in). Do not use both ft/in and m.",
			"type": "number",
			"required": false
		},
		"height_in": {
			"description": "Player's height (inches; use with height_ft). Do not use both ft/in and m.",
			"type": "number",
			"required": false
		},
		"weight_kg": {
			"description": "Player's weight (kilograms). Do not use both kg and lb.",
			"type": "number",
			"required": false
		},
		"weight_lb": {
			"aliases": [
				"weight_lbs"
			],
			"description": "Player's weight (pounds). Do not use both lb and kg.",
			"type": "number",
			"required": false
		},
		"position": {
			"description": "All positions can be wikified.  i.e.: use [[Centre (ice hockey)|Centre]], [[Defenceman (ice hockey)|Defence]], [[Winger (ice hockey)|Left Wing/Right Wing]], [[Goaltender]].",
			"type": "string",
			"required": false
		},
		"shoots": {
			"description": "Left/Right (if player is a skater; use catches for a goalie).  It is HIGHLY RECOMMENDED that one of these two field choices is used in the template. The only reason that this field has been made optional is because there is discretion involved in choosing which of the two to use in the infobox, based on whether the player is a skater or a goalie.",
			"type": "string",
			"required": false
		},
		"catches": {
			"description": "Left/Right (if player is a goalie; use shoots for a skater).  It is HIGHLY RECOMMENDED that one of these two field choices is used in the template. The only reason that this field has been made optional is because there is discretion involved in choosing which of the two to use in the infobox, based on whether the player is a skater or a goalie.",
			"type": "string",
			"required": false
		},
		"league": {
			"description": "Current league. Use abbreviation and link. i.e.: [[National Hockey League|NHL]], [[Kontinental Hockey League|KHL]], etc. If league name is relatively short, you can use the full name. i.e.: [[SM-liiga]]. Infobox WILL flex to accommodate the name.",
			"type": "string",
			"required": false
		},
		"team": {
			"description": "Current team (in league above). Enter FULL NAME of team with link, i.e. [[Boston Bruins]], [[HC Dynamo Moscow]], etc.",
			"type": "string",
			"required": false
		},
		"prospect_league": {
			"description": "For players who have been drafted, but have yet to play a game.  Use abbreviation and link. i.e.: [[ECHL]], [[Minor Hockey League|MHL]], etc.  Any entry into this field will also automatically place (P) next to the pro team listed.",
			"type": "string",
			"required": false
		},
		"prospect_team": {
			"description": "For players who have been drafted, but have yet to play a game. Enter FULL NAME of team with link, i.e. [[Ontario Reign]], [[HK Rīga]], etc.",
			"type": "string",
			"required": false
		},
		"former_teams": {
			"description": "Pro teams an active player played for. Enter FULL NAME of teams in chronological order.",
			"type": "string",
			"required": false
		},
		"played_for": {
			"description": "Pro teams a retired player played for. Enter FULL NAME of teams.",
			"type": "string",
			"required": false
		},
		"sex": {
			"description": "Use f for female players.",
			"type": "string",
			"required": false
		},
		"ntl_team": {
			"description": "Any national senior teams a player played for. Only enter the country name, such as Czech Republic, which generates a link to [[Czech Republic men's national ice hockey team]] (or [[Czech Republic women's national ice hockey team]] if sex=f).",
			"type": "string",
			"required": false
		},
		"ntl_team_2": {
			"description": "If a player played on two national senior teams.",
			"type": "string",
			"required": false
		},
		"ntl_team_3": {
			"description": "In the rare case that a player played on 3 national senior teams such as those from Russia, Soviet Union and the Unified Team, or Eastern Bloc defectors who played for Canada prior to the fall of the Iron Curtain.",
			"type": "string",
			"required": false
		},
		"draft": {
			"description": "Position taken overall in [[NHL Entry Draft]] (1969 or later only), i.e. ''13th overall''. If not drafted AND career began in 1969 or later, put ''Undrafted''.",
			"type": "string",
			"required": false
		},
		"draft_year": {
			"description": "Year of NHL Entry Draft, i.e.: 2001 (which creates a link to [[2001 NHL Entry Draft]]).",
			"type": "number",
			"required": false
		},
		"draft_team": {
			"description": "Enter FULL NAME of team (NO ABBREVIATION), i.e.: [[Edmonton Oilers]].",
			"type": "string",
			"required": false
		},
		"wha_draft": {
			"description": "Position taken overall in [[WHA Amateur Draft]], i.e. ''13th overall''.",
			"type": "string",
			"required": false
		},
		"wha_draft_year": {
			"description": "Year of WHA Amateur Draft, i.e.: 2001 (which creates a link to [[2001 WHA Amateur Draft]]).",
			"type": "number",
			"required": false
		},
		"wha_draft_team": {
			"description": "Enter FULL NAME of team (NO ABBREVIATION), i.e.: [[Cleveland Crusaders]].",
			"type": "string",
			"required": false
		},
		"career_start": {
			"description": "First pro year if professional, first year of top level of amateur competition if amateur.",
			"type": "number",
			"default": "value of ''draft_year''.",
			"required": true
		},
		"career_end": {
			"description": "Final year of career.",
			"type": "number",
			"required": false
		},
		"website": {
			"description": "Player's official website; use {{URL}}",
			"type": "string",
			"required": false
		},
		"medaltemplates": {
			"description": "Player's international medals won. Only use if there is no international play or awards section. When using do not use the MedalCountry template as that is already handled by the ntl_team parameters.",
			"type": "string",
			"required": false
		},
		"show-medals": {
			"description": "If set to \"no\", the medal table is collapsed. By default, it is expanded and will only be collapsed if the \"hide\" link is clicked.",
			"type": "string",
			"default": "yes",
			"required": false
		}
	},
	"paramOrder": [
		"name",
		"halloffame",
		"image",
		"image_size",
		"alt",
		"caption",
		"birth_date",
		"birth_place",
		"death_date",
		"death_place",
		"height_cm",
		"height_m",
		"height_ft",
		"height_in",
		"weight_kg",
		"weight_lb",
		"position",
		"shoots",
		"catches",
		"league",
		"team",
		"prospect_league",
		"prospect_team",
		"former_teams",
		"played_for",
		"sex",
		"ntl_team",
		"ntl_team_2",
		"ntl_team_3",
		"draft",
		"draft_year",
		"draft_team",
		"wha_draft",
		"wha_draft_year",
		"wha_draft_team",
		"career_start",
		"career_end",
		"website",
		"medaltemplates",
		"show-medals"
	],
	"format": "block"
}
</templatedata>

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

{{Infobox person module documentation|Infobox ice hockey player|parameter=embed}}

== Examples ==

=== Example 1: male player, draft ===
{{Infobox ice hockey player
| name            = Aleš Hemský
| image           = Hemskydraft.png
| alt             = Young man with clean-cut reddish-blonde hair and a blue business shirt and tie, holding up a dark athletic uniform reading "HEMSKY 01" in large white letters
| caption         = Hemský at the 2001 NHL entry draft
| birth_date      = {{Birth date and age|1983|8|13|mf=y}}
| birth_place     = [[Pardubice]], [[Czechoslovakia]]
| height_ft       = 6
| height_in       = 0
| weight_lb       = 192
| position        = [[Winger (ice hockey)|Right Wing]]
| shoots          = Right
| league          = [[National Hockey League|NHL]]
| team            = [[Edmonton Oilers]]
| former_teams    = '''[[Czech Extraliga|CZE]]'''<br />[[HC Pardubice]]
| ntl_team        = Czech Republic
| draft           = 13th overall
| draft_year      = 2001
| draft_team      = [[Edmonton Oilers]]
| career_start    = 2002
| career_end      = 
}}
<pre style="overflow: auto">
{{Infobox ice hockey player
| name            = Aleš Hemský
| image           = Hemskydraft.png
| alt             = Young man with clean-cut reddish-blonde hair and a blue business shirt and tie, holding up a dark athletic uniform reading "HEMSKY 01" in large white letters
| caption         = Hemský at the 2001 NHL entry draft
| birth_date      = {{Birth date and age|1983|8|13|mf=y}}
| birth_place     = [[Pardubice]], [[Czechoslovakia]]
| height_ft       = 6
| height_in       = 0
| weight_lb       = 192
| position        = [[Winger (ice hockey)|Right Wing]]
| shoots          = Right
| league          = [[National Hockey League|NHL]]
| team            = [[Edmonton Oilers]]
| former_teams    = '''[[Czech Extraliga|CZE]]'''<br />[[HC Pardubice]]
| ntl_team        = Czech Republic
| draft           = 13th overall
| draft_year      = 2001
| draft_team      = [[Edmonton Oilers]]
| career_start    = 2002
| career_end      = 
}}
</pre>
{{clear}}

=== Example 2: female player, no image ===
{{Infobox ice hockey player
| name            = Carla MacLeod
| birth_date      = {{birth date and age|1982|06|16}}
| birth_place     = [[Spruce Grove]], [[Alberta]], [[Canada]]
| height_ft       = 5
| height_in       = 4
| weight_lb       = 133
| position        = [[Defenceman (ice hockey)|Defence]]
| shoots          = Right
| league          = [[Western Collegiate Hockey Association|WCHA]] team<br />[[Canadian Women's Hockey League|CWHL]]
| team            = [[Wisconsin Badgers women's ice hockey|Wisconsin Badgers]]<br />[[Calgary Oval X-Treme]]
| sex             = f
| ntl_team        = Canada
| career_start    = 2003
| career_end      = 2010
}}
<pre style="overflow: auto">
{{Infobox ice hockey player
| name            = Carla MacLeod
| birth_date      = {{birth date and age|1982|06|16}}
| birth_place     = [[Spruce Grove]], [[Alberta]], [[Canada]]
| height_ft       = 5
| height_in       = 4
| weight_lb       = 133
| position        = [[Defenceman (ice hockey)|Defence]]
| shoots          = Right
| league          = [[Western Collegiate Hockey Association|WCHA]] team<br />[[Canadian Women's Hockey League|CWHL]]
| team            = [[Wisconsin Badgers women's ice hockey|Wisconsin Badgers]]<br />[[Calgary Oval X-Treme]]
| sex             = f
| ntl_team        = Canada
| career_start    = 2003
| career_end      = 2010
}}
</pre>
{{clear}}

=== Example 3: Hall of Fame player, deceased, Olympic medals ===
{{Infobox ice hockey player
| name            = Valeri Kharlamov<br />{{smaller|Валерий Харламов}}
| halloffame      = 2005
| birth_date      = {{birth date|df=yes|1948|1|14}}
| birth_place     = [[Moscow]], [[Soviet Union]]
| death_date      = {{death date and age|df=yes|1981|8|27|1948|1|14}}
| death_place     = [[Solnechnogorsk]], Soviet Union
| height_ft       = 5
| height_in       = 8
| weight_lb       = 165
| position        = [[Winger (ice hockey)|Left Wing]]
| shoots          = Left
| played_for      = [[HC CSKA Moscow|CSKA Moscow]]
| ntl_team        = URS
| career_start    = 1967
| career_end      = 1981
| medaltemplates  = 
{{MedalCompetition | [[Olympic Games]] }}
{{MedalGold | [[1972 Winter Olympics|1972 Sapporo]] | [[Ice hockey at the 1972 Winter Olympics|Team]] }}
{{MedalGold | [[1976 Winter Olympics|1976 Innsbruck]] | [[Ice hockey at the 1976 Winter Olympics|Team]] }}
{{MedalSilver | [[1980 Winter Olympics|1980 Lake Placid]] | [[Ice hockey at the 1980 Winter Olympics|Team]] }}
}}
<pre style="overflow: auto">
{{Infobox ice hockey player
| name            = Valeri Kharlamov<br />{{smaller|Валерий Харламов}}
| halloffame      = 2005
| birth_date      = {{birth date|df=yes|1948|1|14}}
| birth_place     = [[Moscow]], [[Soviet Union]]
| death_date      = {{death date and age|df=yes|1981|8|27|1948|1|14}}
| death_place     = [[Solnechnogorsk]], URS
| height_ft       = 5
| height_in       = 8
| weight_lb       = 165
| position        = [[Winger (ice hockey)|Left Wing]]
| shoots          = Left
| played_for      = [[HC CSKA Moscow|CSKA Moscow]]
| ntl_team        = Soviet Union
| career_start    = 1967
| career_end      = 1981
| medaltemplates  = 
{{MedalCompetition | [[Olympic Games]] }}
{{MedalGold | [[1972 Winter Olympics|1972 Sapporo]] | [[Ice hockey at the 1972 Winter Olympics|Team]] }}
{{MedalGold | [[1976 Winter Olympics|1976 Innsbruck]] | [[Ice hockey at the 1976 Winter Olympics|Team]] }}
{{MedalSilver | [[1980 Winter Olympics|1980 Lake Placid]] | [[Ice hockey at the 1980 Winter Olympics|Team]] }}
}}
</pre>
{{clear}}

=== Example 4: goaltender, metric ===
{{Infobox ice hockey player
| name            = Son Ho-sung<br />손호성
| image           = Sonhosungnet.jpg
| caption         = Son during an away game against [[High1]]
| birth_date      = {{Birth date and age|1982|11|23|df=y}}
| birth_place     = [[Seoul]], [[South Korea]]
| height_cm       = 180
| weight_kg       = 78
| position        = [[Goaltender]]
| catches         = Left
| league          = [[Asia League Ice Hockey|ALH]]
| team            = [[Anyang Halla]]
| former_teams    = [[High1]]
| ntl_team        = South Korea
| career_start    = 2005
| career_end      = 
}}
<pre style="overflow: auto">
{{Infobox ice hockey player
| name            = Son Ho-sung<br />손호성
| image           = Sonhosungnet.jpg
| caption         = Son during an away game against [[High1]]
| birth_date      = {{Birth date and age|1982|11|23|df=y}}
| birth_place     = [[Seoul]], [[South Korea]]
| height_cm       = 180
| weight_kg       = 78
| position        = [[Goaltender]]
| catches         = Left
| league          = [[Asia League Ice Hockey|ALH]]
| team            = [[Anyang Halla]]
| former_teams    = [[High1]]
| ntl_team        = South Korea
| career_start    = 2005
| career_end      = 
}}
</pre>
{{clear}}

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

== Tracking category ==
* {{clc|Infobox ice hockey player with problems}}

== See also ==
;Supporting templates and modules
* [[Template:Subinfobox bodystyle]]
* [[Module:InfoboxImage]]
* [[Template:Convert]]
* [[Template:Infobox medal templates]]
;Templates to be used with infobox:
* {{tlx|Birth date and age}}, {{tlx|Birth-date and age}}, or {{tlx|Birth year and age}} (living player)
* {{tlx|Birth date}} and {{tlx|Death date and age}} (deceased player)
* {{tlx|Birth-date}} and {{tlx|Death-date and age}} (deceased player)
* {{tlx|URL}} (website)
;Information
* [[Wikipedia:Alternative text for images]]
* [[Hockey Hall of Fame]]
* [[NHL Entry Draft]]
* [[WHA Amateur Draft]]

<includeonly>
<!-- Categories below this line, please; interwikis at Wikidata -->
{{Basepage subpage|
[[Category:Ice hockey infobox templates|Player]]
[[Category:Sportsperson infobox templates|Ice hockey]]
[[Category:Biographical templates usable as a module|Ice hockey]]
[[Category:Templates that add a tracking category]]
[[Category:Infobox templates with three columns]]
}}
</includeonly>