Template:Infobox football biography/doc

Infobox football biography is intended to provide a quick overview of an association football (or football variant) player's or manager's details to enable a reader to extract the most oft-needed information without trawling through the article proper.

Usage
Note: all the field names ending in 1 should be repeated for each team, e.g. youthyears1 and youthclubs1 should be followed by youthyears2 and youthclubs2 and so on, as needed.

Parameters
All parameters are optional.


 * Enables the template to be embedded into another template, such as Infobox person. See explanation below.
 * Allows for a custom heading to the infobox instead of "Association football career" when embedded into another template.
 * Allows a custom web color to be set for the template's section headings and a divider when embedded into another template.
 * The commonly used name of the player. If this is omitted, it will be inferred from the title of the article.
 * The player's complete name. Long names will wrap automatically to the width of the infobox, so there's no need to include explicit linebreaks. Alias: fullname
 * A picture of the player, ideally on the pitch in the strip of their most recent team (or the team the player is most well known for, in the case of retirees). Images should be given in the format Example.jpg, rather than [[File:Example.jpg]].
 * 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%). The use of has been deprecated and should be avoided per WP:IMGSIZE.
 * Alternative text for the image.
 * A caption for the image.
 * If different from name and full_name.
 * The player's date of birth. A template (Birth date, Birth date and age) should be used to add the date, but be sure to use the appropriate parameters to present the date in the same format as used in the text. The date should not be wikilinked.
 * The location of the player's birth.
 * The player's date of death. The template Death date and age should be used to add the date, but be sure to use the appropriate parameters to present the date in the same format as used in the text. The date should not be wikilinked.
 * The location of the player's death.
 * The player's height in the units most common within the country in which they play, using the format "X m", "X cm", or "X ft Y in". When given in this format, the height will be automatically converted. Note that fractions of an inch can also be added, e.g. "5 ft 8+1/2 in" will output "5 ft $8 1⁄2$ in (1.74 m)".
 * The player's most common position or positions. If a player is known for playing in multiple roles then explain the point more fully within the article.
 * The club for which the player currently plays, or is employed by. If the player now works in a non-playing role at the club, add this after the club in brackets. For retired players and free agents not currently employed by any club or federation, leave blank.
 * The shirt number of the player at their current club.
 * , ... : A list of years that the player has been at each club as a youth, one per attribute, earliest to latest.
 * , ... : A list of clubs that the player was a member of as a youth, one per attribute, earliest to latest.
 * ... : A list of years that the player has been at each college team, one per attribute, earliest to latest.
 * ... : A list of college teams that the player was a member of, one per attribute, earliest to latest.
 * ... : A list of appearances that the player has been awarded in all competitive matches for each college team, one per attribute, earliest to latest.
 * ... : A list of goals that the player has been awarded in all competitive matches for each college team, one per attribute, earliest to latest.
 * , ... : A list of years that the player has been contracted at each club, one per attribute, earliest to latest.
 * , ... : A list of clubs that the player has been contracted at, one per attribute, earliest to latest.
 * , ... : A list of appearances that the player has been awarded in league competition only for each club (note: Playoff matches are not counted as league matches by most statistical sources (e.g. Soccerbase and the Sky Sports (Rothmans) Football Yearbook), so they should not be included in this infobox), one per attribute, earliest to latest.
 * , ... : A list of goals that the player has been awarded in league competition only for each club (note: Playoff matches are not counted as league matches by most statistical sources (e.g. Soccerbase and the Sky Sports (Rothmans) Football Yearbook), so they should not be included in this infobox), one per attribute, earliest to latest.
 * The total number of appearances the player has been awarded in league competition for all clubs.
 * The total number of goals the player has scored in league competition for all clubs.
 * , ... : A list of years that the player has played for each national team, one per attribute, youngest to oldest level (e.g. U17, U21, Olympic team, B team, senior team).
 * , ... : A list of international teams that the player has played for, including non-senior teams such as U21, one per attribute, youngest to oldest level (e.g. U17, U21, Olympic team, B team, senior team).
 * , ... : A list of appearances that the player has been awarded in all competitions and friendlies for each national team, one per attribute, youngest to oldest level (e.g. U17, U21, Olympic team, B team, senior team).
 * , ... : A list of goals that the player has been awarded in all competitions and friendlies for each national team, one per attribute, youngest to oldest level (e.g. U17, U21, Olympic team, B team, senior team).
 * , ... : A list of years that the person has served within the capacity of manager at each team, one per attribute, earliest to latest.
 * , ... : A list of clubs that the person has served within the capacity of team manager. Please do not list positions other than team manager (such as assistant or coach positions, or director of football roles where this role is not considered managerial) unless that position is a significant part of the person's career; this will apply primarily to those with significant or perhaps primary experience in management. Clubs listed can be both local and national and should be restricted to those ordinarily considered notable in themselves.
 * Medals earned in international competition can be added here using the templates Medal.
 * Expands the medals section to be displayed by default instead of being collapsed.
 * A timestamp at which the player's infobox club statistics are unambiguously correct. The bare date of the last match played should not be used because this is not unambiguous. Dates should use the same format as the rest of the article; use five tildes to generate the current date/time in dmy format, or mdytime for mdy format. The parameter is not needed if the player has retired. Alias: pcupdate
 * A timestamp at which the player's infobox national team statistics are unambiguously correct. The bare date of the last match played should not be used because this is not unambiguous. Dates should use the same format as the rest of the article; use five tildes to generate the current date/time in dmy format, or mdytime for mdy format. The parameter is not needed if the player has retired. Alias: ntupdate
 * Enables another template to be embedded into this template, such as Infobox military person. See explanation below.

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

Embedding other templates
The module parameter is used for embedding other templates into this infobox (see Infobox modules and Category:Biographical templates usable as a module).

Style guide
Try to always consider that an infobox exists to support an article and provide a quick synopsis of important facts. This becomes vital when considering that the amount of space available within an infobox is significantly less than that available outside of it.

As per the manual of style entry on linking, years and dates should not be linked as they do not provide much benefit to the user.

Do not add flag icons to the birth_place, death_place, club, national team or other fields. See: Manual of Style (flags).

As per the manual of style the player's height should be in the units most common in the country in which they play. Units should be abbreviated in the infobox and spelt out in the article text. Measurements should be inputted into the height parameter using the format "X m", "X cm", or "X ft Y in". This will automatically convert units between formats and correctly handle the presentation of units in their short forms. Per consensus at WikiProject Football, metric height will then be displayed in metres.

For example:
 * 1.78 m produces 1.78 m (5 ft 10 in)
 * 178 cm produces 1.78 m (5 ft 10 in)
 * 5 ft 8 in produces 5 ft 8 in (1.73 m)
 * 5 ft 8+1/2 in produces 5 ft $8 1⁄2$ in (1.74 m)

Alternatively, the templates convert and height may be used for height conversion. This is particularly useful if the more accurate metric height is known but the output should be in feet and inches, or if a fraction is desired for the converted inches.

For example:
 * If you have the height in metres, but want to display feet and inches first:
 * produces
 * If you have the height in metres, but want to display feet and inches first (with precision to the nearest half inch):
 * produces
 * produces
 * If you have the height in feet and inches (with precision to the nearest half inch), but want to display metres first:
 * produces
 * produces
 * If you have the height in metres, but want to display the converted feet and inches with precision to the nearest half inch:
 * produces
 * produces
 * produces

TemplateData
{	"description": "This infobox template provides a quick overview of an association football player's or manager's details to enable a reader to extract the most oft-needed information without trawling through the article proper.", "params": { "name": { "type": "string", "label": "Name", "description": "The commonly used name of the player. If this is omitted, it will be inferred from the title of the article." },		"image": { "type": "wiki-file-name", "label": "Picture", "description": "A picture of the player, ideally on the pitch in the strip of their most recent team (or the team the player is most well-known for, in the case of retirees). Use the format Example.jpg, rather than ." },		"upright": { "type": "number", "label": "Picture size", "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%).", "example": "0.8" },		"alt": { "type": "string", "label": "Picture alt text", "description": "Alt text for the picture." },		"caption": { "type": "string", "label": "Picture caption", "description": "A caption for the picture." },		"full_name": { "type": "string", "label": "Full name", "description": "The player's complete name.", "aliases": [ "fullname" ] },		"birth_date": { "type": "number", "label": "Birth date", "description": "The player's date of birth. A template should be used to add the date, but be sure to use the appropriate parameters to present the date in the same format as used in the text. The date should not be wikilinked." },		"birth_place": { "type": "string", "label": "Birth place", "description": "The location of the player's birth." },		"death_date": { "label": "Date of death", "description": "Use exact date if known, but otherwise as close an approximation as possible. Example: April 27, 1992", "type": "string", "required": false },		"death_place": { "label": "Place of death", "description": "Example: Washington, DC, USA", "type": "string", "required": false },		"height": { "type": "number", "label": "Height", "description": "The player's height in the units most common within the country in which they play. The template should be used for automatic formatting. The infobox also supports automatic conversion if the height is specified as \"X m\", \"X cm\", or \"X ft Y in\"." },		"position": { "type": "string", "label": "Position", "description": "The player's most common position or positions. If a player is known for playing in multiple roles then explain the point more fully within the article." },		"currentclub": { "type": "string", "label": "Current club", "description": "The club for which the player currently plays, or is employed by. If the player now works in a non-playing role at the club, add this after the club in brackets. For retired players and free agents not currently employed by any club or federation, leave blank." },		"clubnumber": { "type": "number", "label": "Number", "description": "The shirt number of the player at their current club." },		"youthyears1": { "type": "number", "label": "Youth club 1 years", "description": "The years that the player was at their first youth club. Up to 8 clubs can be added using the parameter names \"youthyears2\", \"youthyears3\", etc." },		"youthclubs1": { "type": "string", "label": "Youth club 1", "description": "The first club that the player was a member of as a youth. Up to 8 clubs can be added using the parameter names \"youthclubs2\", \"youthclubs3\", etc." },		"youthyears2": { "type": "number", "label": "Youth club 2 years", "description": "The years that the player was at their second youth club." },		"youthclubs2": { "type": "string", "label": "Youth club 2", "description": "The second club that the player was a member of as a youth." },		"youthyears3": { "type": "number", "label": "Youth club 3 years", "description": "The years that the player was at their third youth club." },		"youthclubs3": { "type": "string", "label": "Youth club 3", "description": "The third club that the player was a member of as a youth." },		"youthyears4": { "type": "number", "label": "Youth club 4 years", "description": "The years that the player was at their fourth youth club." },		"youthclubs4": { "type": "string", "label": "Youth club 4", "description": "The fourth club that the player was a member of as a youth." },		"youthyears5": { "type": "number", "label": "Youth club 5 years", "description": "The years that the player was at their fifth youth club." },		"youthclubs5": { "type": "string", "label": "Youth club 5", "description": "The fifth club that the player was a member of as a youth." },		"years1": { "type": "number", "label": "Club 1 years", "description": "The years that the player was at their first club. Up to 39 years can be added using the parameter names \"years2\", \"years3\", etc." },		"clubs1": { "type": "string", "label": "Club 1", "description": "The first (senior) club that the player has been contracted at. Up to 39 clubs can be added using the parameter names \"clubs2\", \"clubs3\", etc." },		"caps1": { "type": "number", "label": "Club 1 appearances", "description": "The number of appearances that the player has been awarded in league competition for the first club. Playoff matches should not be included. Up to 39 caps can be added using the parameter names \"caps2\", \"caps3\", etc." },		"goals1": { "type": "number", "label": "Club 1 goals", "description": "The number of goals that the player has been awarded in league competition for the first club. Playoff matches should not be included. Up to 39 can be added using the parameter names \"goals2\", \"goals3\", etc." },		"years2": { "type": "number", "label": "Club 2 years", "description": "The years that the player was at their second club." },		"clubs2": { "type": "string", "label": "Club 2", "description": "The second club that the player has been contracted at." },		"caps2": { "type": "number", "label": "Club 2 appearances", "description": "The number of appearances that the player has been awarded in league competition for the second club." },		"goals2": { "type": "number", "label": "Club 2 goals", "description": "The number of goals that the player has been awarded in league competition for the second club." },		"years3": { "type": "number", "label": "Club 3 years", "description": "The years that the player was at their third club." },		"clubs3": { "type": "string", "label": "Club 3", "description": "The third club that the player has been contracted at." },		"caps3": { "type": "number", "label": "Club 3 appearances", "description": "The number of appearances that the player has been awarded in league competition for the third club." },		"goals3": { "type": "number", "label": "Club 3 goals", "description": "The number of goals that the player has been awarded in league competition for the third club." },		"years4": { "type": "number", "label": "Club 4 years", "description": "The years that the player was at their fourth club." },		"clubs4": { "type": "string", "label": "Club 4", "description": "The fourth club that the player has been contracted at." },		"caps4": { "type": "number", "label": "Club 4 appearances", "description": "The number of appearances that the player has been awarded in league competition for the fourth club." },		"goals4": { "type": "number", "label": "Club 4 goals", "description": "The number of goals that the player has been awarded in league competition for the fourth club." },		"years5": { "type": "number", "label": "Club 5 years", "description": "The years that the player was at their fifth club." },		"clubs5": { "type": "string", "label": "Club 5", "description": "The fifth club that the player has been contracted at." },		"caps5": { "type": "number", "label": "Club 5 appearances", "description": "The number of appearances that the player has been awarded in league competition for the fifth club." },		"goals5": { "type": "number", "label": "Club 5 goals", "description": "The number of goals that the player has been awarded in league competition for the fifth club." },		"years6": { "type": "number", "label": "Club 6 years", "description": "The years that the player was at their sixth club." },		"clubs6": { "type": "string", "label": "Club 6", "description": "The sixth club that the player has been contracted at." },		"caps6": { "type": "number", "label": "Club 6 appearances", "description": "The number of appearances that the player has been awarded in league competition for the sixth club." },		"goals6": { "type": "number", "label": "Club 6 goals", "description": "The number of goals that the player has been awarded in league competition for the sixth club." },		"years7": { "type": "number", "label": "Club 7 years", "description": "The years that the player was at their seventh club." },		"clubs7": { "type": "string", "label": "Club 7", "description": "The seventh club that the player has been contracted at." },		"caps7": { "type": "number", "label": "Club 7 appearances", "description": "The number of appearances that the player has been awarded in league competition for the seventh club." },		"goals7": { "type": "number", "label": "Club 7 goals", "description": "The number of goals that the player has been awarded in league competition for the seventh club." },		"years8": { "type": "number", "label": "Club 8 years", "description": "The years that the player was at their eighth club." },		"clubs8": { "type": "string", "label": "Club 8", "description": "The eighth club that the player has been contracted at." },		"caps8": { "type": "number", "label": "Club 8 appearances", "description": "The number of appearances that the player has been awarded in league competition for the eighth club." },		"goals8": { "type": "number", "label": "Club 8 goals", "description": "The number of goals that the player has been awarded in league competition for the eighth club." },		"years9": { "type": "number", "label": "Club 9 years", "description": "The years that the player was at their ninth club." },		"clubs9": { "type": "string", "label": "Club 9", "description": "The ninth club that the player has been contracted at." },		"caps9": { "type": "number", "label": "Club 9 appearances", "description": "The number of appearances that the player has been awarded in league competition for the ninth club." },		"goals9": { "type": "number", "label": "Club 9 goals", "description": "The number of goals that the player has been awarded in league competition for the ninth club." },		"years10": { "type": "number", "label": "Club 10 years", "description": "The years that the player was at their tenth club." },		"clubs10": { "type": "string", "label": "Club 10", "description": "The tenth club that the player has been contracted at." },		"caps10": { "type": "number", "label": "Club 10 appearances", "description": "The number of appearances that the player has been awarded in league competition for the tenth club." },		"goals10": { "type": "number", "label": "Club 10 goals", "description": "The number of goals that the player has been awarded in league competition for the tenth club." },		"totalcaps": { "type": "number", "label": "Club appearances total", "description": "The total number of appearances the player has been awarded in league competition for all non-youth clubs." },		"totalgoals": { "label": "Club goals total", "description": "The total number of goals the player has scored in league competition for all non-youth clubs.", "type": "number" },		"nationalyears1": { "type": "number", "label": "National team 1 years", "description": "The years that the player has played for the first national team. Up to 9 years can be added using the parameter names \"nationalyears2\", \"nationalyears3\", etc." },		"nationalteam1": { "type": "string", "label": "National team 1", "description": "The first national team that the player has played for (including non-senior teams such as U21). Up to 9 teams can be added using the parameter names \"nationalteam2\", \"nationalteam3\", etc." },		"nationalcaps1": { "type": "number", "label": "National team 1 appearances", "description": "The number of appearances that the player has been awarded in all competitions and friendlies for the first national team. Up to 9 numbers can be added using the parameter names \"nationalcaps2\", \"nationalcaps3\", etc." },		"nationalgoals1": { "type": "number", "label": "National team 1 goals", "description": "The number of goals that the player has been awarded in all competitions and friendlies for the first national team. Up to 9 numbers can be added using the parameter names \"nationalgoals2\", \"nationalgoals3\", etc." },		"nationalyears2": { "type": "number", "label": "National team 2 years", "description": "The years that the player has played for the second national team." },		"nationalteam2": { "type": "string", "label": "National team 2", "description": "The second national team that the player has played for." },		"nationalcaps2": { "type": "number", "label": "National team 2 appearances", "description": "The number of appearances that the player has been awarded in all competitions and friendlies for the second national team." },		"nationalgoals2": { "type": "number", "label": "National team 2 goals", "description": "The number of goals that the player has been awarded in all competitions and friendlies for the second national team." },		"nationalyears3": { "type": "number", "label": "National team 3 years", "description": "The years that the player has played for the third national team." },		"nationalteam3": { "type": "string", "label": "National team 3", "description": "The third national team that the player has played for." },		"nationalcaps3": { "type": "number", "label": "National team 3 appearances", "description": "The number of appearances that the player has been awarded in all competitions and friendlies for the third national team." },		"nationalgoals3": { "type": "number", "label": "National team 3 goals", "description": "The number of goals that the player has been awarded in all competitions and friendlies for the third national team." },		"nationalyears4": { "type": "number", "label": "National team 4 years", "description": "The years that the player has played for the fourth national team." },		"nationalteam4": { "type": "string", "label": "National team 4", "description": "The fourth national team that the player has played for." },		"nationalcaps4": { "type": "number", "label": "National team 4 appearances", "description": "The number of appearances that the player has been awarded in all competitions and friendlies for the fourth national team." },		"nationalgoals4": { "type": "number", "label": "National team 4 goals", "description": "The number of goals that the player has been awarded in all competitions and friendlies for the fourth national team." },		"nationalyears5": { "type": "number", "label": "National team 5 years", "description": "The years that the player has played for the fifth national team." },		"nationalteam5": { "type": "string", "label": "National team 5", "description": "The fifth national team that the player has played for." },		"nationalcaps5": { "type": "number", "label": "National team 5 appearances", "description": "The number of appearances that the player has been awarded in all competitions and friendlies for the fifth national team." },		"nationalgoals5": { "type": "number", "label": "National team 5 goals", "description": "The number of goals that the player has been awarded in all competitions and friendlies for the fifth national team." },		"manageryears1": { "type": "number", "label": "Manager club 1 years", "description": "The years that the person has served with the first club in the capacity of team manager." },		"managerclubs1": { "type": "string", "label": "Manager club 1", "description": "The first club that the person has served within the capacity of team manager. Please do not list positions other than team manager (such as assistant or coach positions, or director of football roles where this role is not considered managerial) unless that position is a significant part of the person's career; this will apply primarily to those with significant or perhaps primary experience in management. Clubs listed can be both local and national and should be restricted to those ordinarily considered notable in themselves." },		"manageryears2": { "type": "number", "label": "Manager club 2 years", "description": "The years that the person has served with the second club in the capacity of team manager. Up to 30 can be added using the parameter names \"manageryears3\", \"manageryears4\", etc." },		"managerclubs2": { "type": "string", "label": "Manager club 2", "description": "The second club that the person has served within the capacity of team manager. Up to 30 can be added using the parameter names \"managerclubs3\", \"managerclubs4\", etc." },		"manageryears3": { "type": "number", "label": "Manager club 3 years", "description": "The years that the person has served with the third club in the capacity of team manager." },		"managerclubs3": { "type": "string", "label": "Manager club 3", "description": "The third club that the person has served within the capacity of team manager." },		"manageryears4": { "type": "number", "label": "Manager club 4 years", "description": "The years that the person has served with the fourth club in the capacity of team manager." },		"managerclubs4": { "type": "string", "label": "Manager club 4", "description": "The fourth club that the person has served within the capacity of team manager." },		"manageryears5": { "type": "number", "label": "Manager club 5 years", "description": "The years that the person has served with the fifth club in the capacity of team manager." },		"managerclubs5": { "type": "string", "label": "Manager club 5", "description": "The fifth club that the person has served within the capacity of team manager." },		"manageryears6": { "type": "number", "label": "Manager club 6 years", "description": "The years that the person has served with the sixth club in the capacity of team manager." },		"managerclubs6": { "type": "string", "label": "Manager club 6", "description": "The sixth club that the person has served within the capacity of team manager." },		"manageryears7": { "type": "number", "label": "Manager club 7 years", "description": "The years that the person has served with the seventh club in the capacity of team manager." },		"managerclubs7": { "type": "string", "label": "Manager club 7", "description": "The seventh club that the person has served within the capacity of team manager." },		"manageryears8": { "type": "number", "label": "Manager club 8 years", "description": "The years that the person has served with the eighth club in the capacity of team manager." },		"managerclubs8": { "type": "string", "label": "Manager club 8", "description": "The eighth club that the person has served within the capacity of team manager." },		"manageryears9": { "type": "number", "label": "Manager club 9 years", "description": "The years that the person has served with the ninth club in the capacity of team manager." },		"managerclubs9": { "type": "string", "label": "Manager club 9", "description": "The ninth club that the person has served within the capacity of team manager." },		"manageryears10": { "type": "number", "label": "Manager club 10 years", "description": "The years that the person has served with the tenth club in the capacity of team manager." },		"managerclubs10": { "type": "string", "label": "Manager club 10", "description": "The tenth club that the person has served within the capacity of team manager." },		"medaltemplates": { "type": "string", "label": "Medal templates", "description": "Honors can be added here using templates." },		"club-update": { "type": "string", "label": "Club update timestamp", "description": "A timestamp at which the player's infobox club statistics are unambiguously correct. The bare date of the last match played should not be used because this is not unambiguous. Dates should use the same format as the rest of the article; use five tildes to generate the current date/time in dmy format, or  for mdy format. The parameter is not needed if the player has retired.", "aliases": [ "pcupdate" ] },		"nationalteam-update": { "label": "National team update timestamp", "description": "A timestamp at which the player's infobox national team statistics are unambiguously correct. The bare date of the last match played should not be used because this is not unambiguous. Dates should use the same format as the rest of the article; use five tildes to generate the current date/time in dmy format, or  for mdy format. The parameter is not needed if the player has retired.", "type": "string", "aliases": [ "ntupdate" ] }	},	"format": "block" }

Tracking categories

 * – Used by Template:Wikidata image to track articles where an infobox has no image but Wikidata has an image name. To exclude articles from this category, add an image or yes to the infobox.
 * – Used by Template:Wikidata image to track articles where an infobox has no image but Wikidata has an image name. To exclude articles from this category, add an image or yes to the infobox.
 * – Used by Template:Wikidata image to track articles where an infobox has no image but Wikidata has an image name. To exclude articles from this category, add an image or yes to the infobox.
 * – Used by Template:Wikidata image to track articles where an infobox has no image but Wikidata has an image name. To exclude articles from this category, add an image or yes to the infobox.
 * – Used by Template:Wikidata image to track articles where an infobox has no image but Wikidata has an image name. To exclude articles from this category, add an image or yes to the infobox.

Supporting templates
The following templates are used directly from this template: •

• Abbr

• Br separated entries

• Infobox medal templates

• Infobox person/height

• Longitem

• Main other

• PAGENAMEBASE

• Wikidata image

• Yesno