The {{Medal infobox}} series of templates allow editors to list an athlete or sportsperson's major medals at the top of their respective biography article, alongside the lead section.
Usage
The medal infobox consists of two templates:
{{MedalTableTop}} – for starting the table where the other template(s) aren't in an infobox. Do not use {{MedalTableTop}} or {{MedalTop}} inside an infobox.
{{Medal}} – for the several elements within the table
A further template ({{MedalBox}}) is used for listing medals in the middle of the main article text. Do not use {{MedalBox}} inside an infobox.
<syntaxhighlight lang="text" class="" style="" inline="1">name</syntaxhighlight> – This option adjusts the title that appears at the top of the box. This should typically be the athlete's common name. By default it will display the article title without the disambiguator, for example on Michael Johnson (sprinter) "Michael Johnson" will appear by default. To deactivate the title enter <syntaxhighlight lang="text" class="" style="" inline="1">no</syntaxhighlight> in the field.
<syntaxhighlight lang="text" class="" style="" inline="1">image</syntaxhighlight> – This give you the option to place a headline image in the infobox. Use just the file name and extension, excluding the namespace prefix, for example: MyImage.jpg not File:MyImage.jpg.
<syntaxhighlight lang="text" class="" style="" inline="1">image_size</syntaxhighlight> (or <syntaxhighlight lang="text" class="" style="" inline="1">imagesize</syntaxhighlight>) – This adjusts the size of the image and must consist of a number followed by "px" (e.g. 150px). The default is 100px. Sizes over 200px are no recommended for typical usage.
<syntaxhighlight lang="text" class="" style="" inline="1">alt</syntaxhighlight> – This provides a description of the image for accessibility users or those using weak connections.
<syntaxhighlight lang="text" class="" style="" inline="1">caption</syntaxhighlight> – This adds a short description to describe the image. Try to be brief, using just a few words.
<syntaxhighlight lang="text" class="" style="" inline="1">header</syntaxhighlight> – This optional field can be used to change the text in the opening "Medal record" section. This is useful when the template appears in a section of an article. See Michael Phelps for a working example.
<syntaxhighlight lang="text" class="" style="" inline="1">sport</syntaxhighlight> – This option includes the athlete's sport (e.g. Men's swimming) in the first line of the medal record. This replaces the need for {{Medal|Sport}} when an athlete has medalled in only one sport. In cases where an athlete has competed in multiple sports, it is still possible to use the {{Medal|Sport}} template usage to list the different sports.
<syntaxhighlight lang="text" class="" style="" inline="1">country_code</syntaxhighlight> – This option uses the country code (e.g. USA = United States, CHN = China, GBN = Great Britain) to generate the country that the athlete represents in the second line of the medal record. It will automatically include "the" in front of the country name for the following codes: BHS (the Bahamas), GMB (the Gambia), GBR (the United Kingdom), MHL (the Marshall Islands), NLD (the Netherlands), PHL (the Philippines), SYC (the Seychelles), SLB (the Solomon Islands), ARE (the United Arab Emirates), URS (the Soviet Union), and USA (the File:Flag of the United States (23px).pngUnited States). This replaces the need for {{Medal|Country}} when an athlete has competed for only one country. In cases where an athlete has represented multiple countries, it is still possible to use the {{Medal|Country}} template usage to list the different countries.
<syntaxhighlight lang="text" class="" style="" inline="1">country</syntaxhighlight> – May be used in place of <syntaxhighlight lang="text" class="" style="" inline="1">country_code</syntaxhighlight> to display the country name using text or templates, such as {{BRA}} which displays Brazil (same output as with <syntaxhighlight lang="wikitext" inline style="display: none;" />|country_code=BRA), {{Bkw|Poland}} which displays Poland (linked to the Poland women's national basketball team article), or {{Ih|CAN}} which displays Canada (linked to the Canada men's national ice hockey team article). Include "the" where appropriate (e.g. the {{BHS}}, the {{GMB}}, the {{GBR}}, the {{MHL}}, the {{NLD}}, the {{PHL}}, the {{SYC}}, the {{SLB}}, the {{ARE}}, the {{URS}}, the {{USA}}). This replaces the need for the {{Country}} template (e.g. {{Medal|Country|{{BRA}}}} or {{Medal|Country|{{Bkw|POL}}}}).
<syntaxhighlight lang="text" class="" style="" inline="1">medals</syntaxhighlight> – This is the only compulsory field as this is used to place medals and descriptions within the infobox through the {{Medal}} template. To work correctly, it must be the last field in the main template.
The {{MedalBox}} template has a similar output to the {{MedalTableTop}} template, but it is specifically designed for non-infobox usages (i.e. mid-article boxes).
<syntaxhighlight lang="text" class="" style="" inline="1">color</syntaxhighlight> – This option changes the color of the box header. If omitted, the default is light grey.
<syntaxhighlight lang="text" class="" style="" inline="1">title</syntaxhighlight> – This parameter allows you to customise the box title. If omitted, the default is "Medal record".
<syntaxhighlight lang="text" class="" style="" inline="1">sport</syntaxhighlight> – This displays the athlete's primary sport (e.g. "Men's beach volleyball"). This option supersedes the "{{Medal|Sport}}" template function.
<syntaxhighlight lang="text" class="" style="" inline="1">country</syntaxhighlight> – This displays the athlete's primary country or team using text or a template, such as {{BRA}} which displays Brazil (linked to the Brazil article), {{Bkw|Poland}} which displays Poland (linked to the Poland women's national basketball team article), or {{Ih|CAN}} which displays Canada (linked to the Canada men's national ice hockey team article). Include "the" where appropriate (e.g. the {{BHS}}, the {{GMB}}, the {{GBR}}, the {{MHL}}, the {{NLD}}, the {{PHL}}, the {{SYC}}, the {{SLB}}, the {{ARE}}, the {{URS}}, the {{USA}}). This replaces the need for the {{Medal|Country}} template (e.g. {{Medal|Country|{{BRA}}}} or {{Medal|Country|{{Bkw|POL}}}}).
<syntaxhighlight lang="text" class="" style="" inline="1">medals</syntaxhighlight> – This is the only compulsory field as this is used to place medals and descriptions within the box through the {{Medal}} template. To work correctly it must be the last field in the main template.
Medal performances – There are ten types of medal performances. These contain two separate fields for the year of the competition and its location (e.g. 2008 Beijing, 2010 Delhi) and the medalling event or category (e.g. pole vault, 56 kg, 50 m freestyle). The medal types are (with shortcut in brackets):
For the disqualified medal template, it is possible to create a reference directly after the template to explain the reason for disqualification. This can be particularly useful in the case of relay runners disqualified through no fault of their own, due to doping by team mates for example.
Where an athlete has competed for multiple countries or in multiple sports it will be necessary to use the Country or Sport Medal types, in addition to the main sport and country_code listings in the {{MedalTableTop}} template.
Relevant country (or team) – This is usually the first section showing the person's relevant country (or team).
Country – Enter the country's three-letter IOC code in curly brackets (e.g. {{CHN}}), including "the" where appropriate (e.g. the {{USA}}, the {{URS}}, the {{MHL}}, the {{ARE}}, the {{GBR}}, the {{BHS}}, the {{NLD}}, the {{PHL}}, the {{SYC}}, the {{GMB}}, the {{SLB}}). In rare cases, the correct input may be something else (e.g. a team name).
Sport – This states the sport that the athlete is competing in (e.g. Women's swimming)
Examples
MedalTableTop
For competitors who have competed in the same sport for the same country, the templates should be ordered Sport, Country, Competition1, Award, Competition2, Award and so on.
</syntaxhighlight>
For competitors who have won medals in different sports, competing for the same country, the templates should be ordered Country, Sport1, Competition, Award, Sport2, Competition, Award and so on. The example shown is based on Rebecca Romero.
Competitor who has won medals in the same sport, competing for different countries
</syntaxhighlight>
For competitors who have won medals in the same sport at the same competition, competing for different countries, the templates should be ordered Sport, Competition, Country1, Award, Country2, Award and so on. The example shown is from Mia Audina.
</syntaxhighlight>
For competitors who have won medals in the same sport at different competitions, competing for different countries, the templates should be ordered Sport, Country1, Competition1, Award, Competition2, Award, Country2, Competition1, Award and so on.
</syntaxhighlight>
For use within {{Infobox biathlete}}, {{Infobox fencer}}, {{Infobox figure skater}}, {{Infobox sailor}}, {{Infobox swimmer}} and other infobox templates that are wrappers for Infobox sportsperson have an "embed" function for the medal table. Formatting for the medal table embedded within an infobox generally follows the established formatting of the other examples provided, but duplicate wiki links for the sport name ("MedalSport") and represented country ("MedalCountry") may be eliminated within the embedded medal table.
MedalBox
Here is a basic demonstration of the MedalBox template usage:
{{MedalBottom}} – table now automatically closes by using the |medals= parameter and medal templates prior to the final paired curly brackets at the end of the template.