Difference between revisions of "Template:Infobox tennis biography/doc"

From blackwiki
Jump to navigation Jump to search
imported>Jonesey95
(→‎Notes: add new name of Fed Cup)
 
(125 intermediate revisions by 48 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
+
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
Please not make any significant alterations to the template (e.g., new fields, field name changes) without establishing general awareness and approval via the [[Template talk:Infobox tennis biography|talk page]].
+
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Wikidata|Module:Check for unknown parameters}}
 +
{{Uses Wikidata|P555|P564|P18}}
  
=== Usage ===
+
Please do not make any significant alterations to the template (e.g., new fields, field name changes) without establishing general awareness and approval via the [[Template talk:Infobox tennis biography|talk page]].
All attributes are optional. If {{{playername}}} is omitted, it will be inferred from the page title.
 
  
<pre style="white-space: pre-wrap">
+
== Usage ==
{{infobox tennis biography
+
All attributes are optional. If {{{name}}} is omitted, it will be inferred from the page title. If {{{singlesrecord}}} or {{{doublesrecord}}} is omitted, it will be inferred from any Wikidata entry.
|playername                        =  
+
 
|image                             = <!-- formatted like this: [[File:Imagename.jpg|250px]]; change 250 to change image size -->
+
<pre style="overflow: auto">
|caption                           = <!-- brief text caption for the image -->
+
{{Infobox tennis biography
|fullname                         =  
+
| name                  =  
|nickname                          =  
+
| image                 = <!-- bare image name, no formatting -->
|country                           =  
+
| image_size            =
|residence                        =  
+
| alt                    =
|datebirth                        = {{birth date and age|yyyy|mm|dd}}
+
| caption               = <!-- brief text caption for the image -->
|placebirth                        =  
+
| fullname               =
|datedeath                        =
+
| native_name            =  
|placedeath                        =
+
| native_name_lang      =
|height                            = <!-- {{convert|HEIGHT IN METRES|m|abbr=on}} or {{convert|FEET|ft|INCHES|in|abbr=on}} -->
+
| itf_name              = <!-- official name as registered by the ITF, only fill if different from article name -->
|weight                            = <!-- {{convert|WEIGHT IN KILOS|kg|abbr=on}} or {{convert|WEIGHT IN POUNDS|lb|abbr=on}} -->
+
| country_represented    = <!-- this is the country represented in international play, not citizenship -->
|college                           =  
+
| residence              =  
|turnedpro                         =  
+
| sportswear_(racquet)  =  
|retired                           =  
+
| birth_date            = <!-- {{birth date and age|yyyy|mm|dd}} -->
|plays                             =  
+
| birth_place            =  
|careerprizemoney                 =  
+
| death_date            = <!-- {{death date and age|yyyy|mm|dd|yyyy|mm|dd}} first date is death date, second date is birth date-->
|tennishofyear                     = <!-- year inducted into the Tennis Hall of Fame -->
+
| death_place            =
|tennishofid                       = <!-- ID from the Tennis HoF website, taken from http://www.tennisfame.com/hall-of-famers/First Name-Last Name i.e. martina-navratilova, which it is all undercase letters-->
+
| height                = <!-- X ft Y in, X cm OR X m; the template will automatically convert (otherwise {{convert}} can be used) -->
|website                           = <!-- official web site address like this: [http://www.site.com www.site.com] -->
+
| college               =  
|singlesrecord                     =  
+
| coach                  = <!-- Coach(es); list the current coach or (if there is more than one) list the current coaches -->
|singlestitles                     =  
+
| turnedpro             =  
|highestsinglesranking             =  
+
| retired               =  
|currentsinglesranking             =  
+
| plays                 =  
|AustralianOpenresult             =  
+
| careerprizemoney       =  
|AustralianOpenjuniorresult        =  
+
| tennishofyear         = <!-- year inducted into the Tennis Hall of Fame -->
|AustralianOpenseniorresult       =  
+
| tennishofid           = <!-- ID from the Tennis HoF website, taken from http://www.tennisfame.com/hall-of-famers/inductees/First Name-Last Name i.e. martina-navratilova, which is all undercase letters-->
|FrenchOpenresult                  =  
+
| website               = <!-- official web site address like this: [http://www.site.com site.com] -->
|FrenchOpenjuniorresult            =  
+
 
|FrenchOpenseniorresult            =  
+
| singlesrecord         = <!-- you may place a <br /> to over-ride values in WikiData, which is incorrect on all pre-1968 players-->
|Wimbledonresult                  =  
+
| singlestitles         =  
|Wimbledonjuniorresult            =  
+
| highestsinglesranking = <!-- use {{Abbr|No.|number}} and numeral -->
|Wimbledonseniorresult            =  
+
| currentsinglesranking = <!-- NEVER UPDATE UNTIL THE WTA/ATP WEBSITE IS UPDATED (Usually on Mondays) -->
|USOpenresult                      =  
+
| retirementsinglesranking =  
|USOpenjuniorresult                =  
+
| AustralianOpenresult   =  
|USOpenseniorresult               =  
+
| FrenchOpenresult      =  
|Othertournaments                 = <!-- adds a "Major tournaments" title -->
+
| Wimbledonresult       =  
|MastersCupresult                 =  
+
| USOpenresult          =  
|WTAChampionshipsresult            =  
+
 
|Olympicsresult                    =  
+
| AustralianOpenjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
|doublesrecord                     =  
+
| FrenchOpenjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
|doublestitles                     =  
+
| Wimbledonjuniorresult  = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
|highestdoublesranking             =  
+
| USOpenjuniorresult    = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
|currentdoublesranking             =  
+
| AustralianOpenseniorresult =  
|grandslamsdoublesresults          =
+
| FrenchOpenseniorresult =  
|AustralianOpenDoublesresult       =  
+
| Wimbledonseniorresult  =  
|AustralianOpenDoublesjuniorresult =  
+
| USOpenseniorresult     =  
|AustralianOpenDoublesseniorresult =  
+
| Othertournaments       = <!-- adds a "Other tournaments" title -->
|FrenchOpenDoublesresult          =  
+
| WHCCresult            =
|FrenchOpenDoublesjuniorresult    =  
+
| WCCCresult            =
|FrenchOpenDoublesseniorresult    =  
+
| TOCresult              =
|WimbledonDoublesresult            =  
+
| MastersCupresult       =
|WimbledonDoublesjuniorresult      =  
+
| GrandSlamCupresult    =
|WimbledonDoublesseniorresult      =  
+
| WCTFinalsresult        =  
|USOpenDoublesresult              =  
+
| WTAChampionshipsresult =
|USOpenDoublesjuniorresult        =  
+
| Olympicsresult        =
|USOpenDoublesseniorresult         =  
+
| Promajors              = <!-- adds a "Professional majors" title -->
|OthertournamentsDoubles           = <!-- adds a "Major doubles tournaments" title -->
+
| USProresult           =  
|MastersCupDoublesresult           =  
+
| WembleyProresult      =
|WTAChampionshipsDoublesresult     =  
+
| FrenchProresult        =  
|OlympicsDoublesresult             =  
+
 
|Mixed                             = <!-- adds mixed information-->
+
| doublesrecord         = <!-- you may place a <br /> to over-ride values in WikiData, which is incorrect on all pre-1968 players-->
|mixedrecord                       =  
+
| doublestitles         =  
|mixedtitles                       =  
+
| highestdoublesranking =  
|AustralianOpenMixedresult         =  
+
| currentdoublesranking = <!-- NEVER UPDATE UNTIL THE WTA/ATP WEBSITE IS UPDATED (Usually on Mondays) -->
|FrenchOpenMixedresult             =  
+
| retirementdoublesranking =
|WimbledonMixedresult             =  
+
| AustralianOpenDoublesresult =  
|USOpenMixedresult                 =  
+
| FrenchOpenDoublesresult =  
|updated                           = <!-- adds date this template was last updated at an individual article -->
+
| WimbledonDoublesresult =  
}}
+
| USOpenDoublesresult    =  
 +
| AustralianOpenDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
 +
| FrenchOpenDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
 +
| WimbledonDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
 +
| USOpenDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
 +
| AustralianOpenDoublesseniorresult =  
 +
| FrenchOpenDoublesseniorresult =  
 +
| WimbledonDoublesseniorresult =  
 +
| USOpenDoublesseniorresult =  
 +
 
 +
| OthertournamentsDoubles = <!-- adds a "Other doubles tournaments" title -->
 +
| WHCCDoublesresult      =
 +
| WCCCDoublesresult      =
 +
| MastersCupDoublesresult =  
 +
| WTAChampionshipsDoublesresult =  
 +
| OlympicsDoublesresult =  
 +
 
 +
| Mixed                 = <!-- adds mixed information-->
 +
| mixedrecord           =  
 +
| mixedtitles           =  
 +
| AustralianOpenMixedresult =  
 +
| FrenchOpenMixedresult =  
 +
| WimbledonMixedresult   =  
 +
| USOpenMixedresult     =
 +
| OthertournamentsMixedDoubles =
 +
| WHCCMixedDoublesresult =
 +
| WCCCMixedDoublesresult =
 +
| OlympicMixedDoublesresult =
 +
 
 +
| Team                  = <!-- adds team information-->
 +
| LaverCupresult        =
 +
| DavisCupresult        =
 +
| FedCupresult          =
 +
| HopmanCupresult        =
 +
| WorldTeamCupresult    =
 +
| WightmanCupresult      =
 +
 
 +
| medaltemplates        = <!-- Olympic medal templates -->
 +
| medaltemplates-expand  = <!-- expands the medaltemplates -->
 +
| updated               = <!-- adds date this template was last updated at an individual article -->
 +
}}</pre>
 +
 
 +
=== Wheelchair tennis ===
 +
Five additional fields are available for [[wheelchair tennis]] players
 +
<pre style="overflow:auto">
 +
| WheelchairTennisMastersresult        =
 +
| Paralympicsresult                    =
 +
| WheelchairTennisMastersDoublesresult =
 +
| ParalympicsDoublesresult            =
 +
| WheelchairWorldTeamCupresult        =
 +
</pre>
 +
 
 +
=== Tennis coaches ===
 +
Seven additional fields are available for tennis coaches
 +
<pre style="overflow:auto">
 +
| CoachYears            =
 +
| CoachPlayers          =
 +
| CoachSinglesTitles    =
 +
| CoachDoublesTitles    =
 +
| CoachTournamentRecord =
 +
| CoachingAwards        =
 +
| CoachingRecords      =
 
</pre>
 
</pre>
  
 
=== Notes ===
 
=== Notes ===
*In the '''updated''' field, If the player is retired, put N/A in this field. Use the date of the previous Monday that the ATP or WTA updated player's stats.
+
* In the '''updated''' field, If the player is retired, put N/A in this field. Use the date of the previous Monday that the ATP or WTA updated player's stats.
*Include '''career prize money''' in [[US Dollar]]s.
+
* Include '''career prize money''' in [[US Dollar]]s.
*For '''height''' and '''weight''', use one of the appropriate conversion templates.
+
* For '''height''', use the appropriate conversion template.
*'''Singles and Doubles titles''', include only titles won on the [[Women's Tennis Association|WTA]] (women) or the [[Association of Tennis Professionals|ATP]] (men) Tour, not the [[International Tennis Federation|ITF]] circuit (the tier below). Titles won on the ITF Circuit can be included in brackets.
+
* '''Singles and Doubles titles''', include only titles won on the [[Women's Tennis Association|WTA]] (women) or the [[Association of Tennis Professionals|ATP]] (men) Tour, not the [[International Tennis Federation|ITF]] circuit (the tier below). Titles won on the ITF Circuit can be included in brackets.
*The '''Grand Slam results and Grand Slam doubles results''' sections show the furthest the player advanced in the Grand Slams, and in what year(s).  
+
* The '''Grand Slam results and Grand Slam doubles results''' sections show the furthest the player advanced in the Grand Slams, and in what year(s).  
*The '''singles and doubles career record''' only includes matches won and lost on the ATP or WTA Tour.
+
* The '''singles and doubles career record''' only includes matches won and lost on the ATP or WTA Tour.
 +
* Please only use these fields if a player was a winner of a major team competition (e.g. Hopman Cup, World Team Cup, Davis Cup, Fed Cup/Billie Jean King Cup, and Wheelchair World Team Cup).
 +
* As an alternative to {{para|height}}, the parameters {{para|height_m}}, {{para|height_cm}} or {{para|height_ft}} and {{para|height_in}} may be used.
 +
 
 +
== Use as a child template ==
 +
The '''embed''' parameter is used when embedding this infobox into another.
 +
 
 +
{{Infobox person module documentation|Infobox tennis biography|parameter=embed|turnedpro|retired|plays|careerprizemoney}}
 +
 
 +
== Embedding other templates ==
 +
The '''module''' parameter is used for embedding other templates into this infobox (see [[Wikipedia:Infobox modules]] and [[:Category:Biographical templates usable as a module]]).
  
=== Microformat ===
+
<pre style="overflow: auto;">
 +
{{Infobox tennis biography
 +
| name =
 +
| <!-- etc. -->
 +
| module =
 +
  {{Infobox ABC
 +
  | embed = yes <!-- or child=yes / subbox=yes -->
 +
  | <!-- etc. -->
 +
  }}
 +
}}
 +
</pre>
 +
 
 +
== Microformat ==
 
{{UF-hcard-person}}
 
{{UF-hcard-person}}
  
<includeonly>
+
== Tracking categories ==
<!-- CATEGORY AND INTERWIKI LINKS GO BELOW HERE -->
+
* {{clc|Pages using infobox tennis biography with tennishofid}}
 +
* {{clc|Pages using infobox tennis biography with unsupported parameters}}
 +
 
 +
<includeonly>{{Sandbox other||
 +
<!-- Categories below this line, please; interwikis at Wikidata -->
 
[[Category:Sportsperson infobox templates|Tennis biography]]
 
[[Category:Sportsperson infobox templates|Tennis biography]]
 
[[Category:Tennis infobox templates|Biography]]
 
[[Category:Tennis infobox templates|Biography]]
 
+
[[Category:Biographical templates usable as a module|Tennis biography]]
[[ca:Plantilla:Infotaula tennista]]
+
[[Category:Infobox templates with module parameter|Tennis biography]]
[[be-x-old:Шаблён:Тэнісіст]]
+
[[Category:Infobox templates with updated parameter]]
[[da:Skabelon:Infoboks tennisspiller]]
+
[[Category:Infobox templates using Wikidata]]
[[es:Plantilla:Ficha de tenista]]
+
[[Category:Templates that add a tracking category]]
[[et:Mall:Tennisist]]
+
}}</includeonly>
[[fa:الگو:جعبه اطلاعات زندگینامه تنیس]]
 
[[fr:Modèle:Infobox Joueur(euse) de tennis]]
 
[[ka:თარგი:ინფოდაფა ჩოგბურთელი]]
 
[[ko:틀:테니스 선수 정보]]
 
[[mk:Шаблон:Инфокутија Тениски играч]]
 
[[nl:Sjabloon:Infobox tennisspeler]]
 
[[ja:Template:テニス選手]]
 
[[pt:Predefinição:Info/Tenista]]
 
[[ru:Шаблон:Теннисист]]
 
[[sk:Šablóna:Infobox tenista]]
 
[[sr:Шаблон:Кутијица тенисери]]
 
[[fi:Malline:Tennispelaaja]]
 
[[sv:Mall:Tennisspelare]]
 
[[tl:Suleras:Infobox Tennis biography]]
 
[[th:แม่แบบ:กล่องข้อมูล นักเทนนิส]]
 
[[uk:Шаблон:Тенісист]]
 
[[zh:Template:Infobox 网球]]
 
</includeonly>
 

Latest revision as of 16:26, 27 November 2020

Template:Uses Wikidata

Please do not make any significant alterations to the template (e.g., new fields, field name changes) without establishing general awareness and approval via the talk page.

Usage

All attributes are optional. If {{{name}}} is omitted, it will be inferred from the page title. If {{{singlesrecord}}} or {{{doublesrecord}}} is omitted, it will be inferred from any Wikidata entry.

{{Infobox tennis biography
| name                   = 
| image                  = <!-- bare image name, no formatting -->
| image_size             = 
| alt                    = 
| caption                = <!-- brief text caption for the image -->
| fullname               = 
| native_name            = 
| native_name_lang       = 
| itf_name               = <!-- official name as registered by the ITF, only fill if different from article name -->
| country_represented    = <!-- this is the country represented in international play, not citizenship -->
| residence              = 
| sportswear_(racquet)   = 
| birth_date             = <!-- {{birth date and age|yyyy|mm|dd}} -->
| birth_place            = 
| death_date             = <!-- {{death date and age|yyyy|mm|dd|yyyy|mm|dd}} first date is death date, second date is birth date-->
| death_place            = 
| height                 = <!-- X ft Y in, X cm OR X m; the template will automatically convert (otherwise {{convert}} can be used) -->
| college                = 
| coach                  = <!-- Coach(es); list the current coach or (if there is more than one) list the current coaches -->
| turnedpro              = 
| retired                = 
| plays                  = 
| careerprizemoney       = 
| tennishofyear          = <!-- year inducted into the Tennis Hall of Fame -->
| tennishofid            = <!-- ID from the Tennis HoF website, taken from http://www.tennisfame.com/hall-of-famers/inductees/First Name-Last Name i.e. martina-navratilova, which is all undercase letters-->
| website                = <!-- official web site address like this: [http://www.site.com site.com] -->

| singlesrecord          = <!-- you may place a <br /> to over-ride values in WikiData, which is incorrect on all pre-1968 players-->
| singlestitles          = 
| highestsinglesranking  = <!-- use {{Abbr|No.|number}} and numeral -->
| currentsinglesranking  = <!-- NEVER UPDATE UNTIL THE WTA/ATP WEBSITE IS UPDATED (Usually on Mondays) -->
| retirementsinglesranking = 
| AustralianOpenresult   = 
| FrenchOpenresult       = 
| Wimbledonresult        = 
| USOpenresult           = 

| AustralianOpenjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| FrenchOpenjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| Wimbledonjuniorresult  = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| USOpenjuniorresult     = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| AustralianOpenseniorresult = 
| FrenchOpenseniorresult = 
| Wimbledonseniorresult  = 
| USOpenseniorresult     = 
| Othertournaments       = <!-- adds a "Other tournaments" title -->
| WHCCresult             = 
| WCCCresult             = 
| TOCresult              = 
| MastersCupresult       = 
| GrandSlamCupresult     = 
| WCTFinalsresult        = 
| WTAChampionshipsresult = 
| Olympicsresult         = 
| Promajors              = <!-- adds a "Professional majors" title -->
| USProresult            = 
| WembleyProresult       = 
| FrenchProresult        = 

| doublesrecord          = <!-- you may place a <br /> to over-ride values in WikiData, which is incorrect on all pre-1968 players-->
| doublestitles          = 
| highestdoublesranking  = 
| currentdoublesranking  = <!-- NEVER UPDATE UNTIL THE WTA/ATP WEBSITE IS UPDATED (Usually on Mondays) -->
| retirementdoublesranking =
| AustralianOpenDoublesresult = 
| FrenchOpenDoublesresult = 
| WimbledonDoublesresult = 
| USOpenDoublesresult    = 
| AustralianOpenDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| FrenchOpenDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| WimbledonDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| USOpenDoublesjuniorresult = <!-- do not add any jr. info once any pro result is recorded in the infobox -->
| AustralianOpenDoublesseniorresult = 
| FrenchOpenDoublesseniorresult = 
| WimbledonDoublesseniorresult = 
| USOpenDoublesseniorresult = 

| OthertournamentsDoubles = <!-- adds a "Other doubles tournaments" title -->
| WHCCDoublesresult      =
| WCCCDoublesresult      =
| MastersCupDoublesresult = 
| WTAChampionshipsDoublesresult = 
| OlympicsDoublesresult  = 

| Mixed                  = <!-- adds mixed information-->
| mixedrecord            = 
| mixedtitles            = 
| AustralianOpenMixedresult = 
| FrenchOpenMixedresult  = 
| WimbledonMixedresult   = 
| USOpenMixedresult      = 
| OthertournamentsMixedDoubles =
| WHCCMixedDoublesresult =
| WCCCMixedDoublesresult =
| OlympicMixedDoublesresult = 

| Team                   = <!-- adds team information-->
| LaverCupresult         =
| DavisCupresult         =
| FedCupresult           =
| HopmanCupresult        =
| WorldTeamCupresult     =
| WightmanCupresult      =

| medaltemplates         = <!-- Olympic medal templates -->
| medaltemplates-expand  = <!-- expands the medaltemplates -->
| updated                = <!-- adds date this template was last updated at an individual article -->
}}

Wheelchair tennis

Five additional fields are available for wheelchair tennis players

| WheelchairTennisMastersresult        = 
| Paralympicsresult                    = 
| WheelchairTennisMastersDoublesresult = 
| ParalympicsDoublesresult             = 
| WheelchairWorldTeamCupresult         = 

Tennis coaches

Seven additional fields are available for tennis coaches

| CoachYears            = 
| CoachPlayers          = 
| CoachSinglesTitles    = 
| CoachDoublesTitles    = 
| CoachTournamentRecord = 
| CoachingAwards        = 
| CoachingRecords       = 

Notes

  • In the updated field, If the player is retired, put N/A in this field. Use the date of the previous Monday that the ATP or WTA updated player's stats.
  • Include career prize money in US Dollars.
  • For height, use the appropriate conversion template.
  • Singles and Doubles titles, include only titles won on the WTA (women) or the ATP (men) Tour, not the ITF circuit (the tier below). Titles won on the ITF Circuit can be included in brackets.
  • The Grand Slam results and Grand Slam doubles results sections show the furthest the player advanced in the Grand Slams, and in what year(s).
  • The singles and doubles career record only includes matches won and lost on the ATP or WTA Tour.
  • Please only use these fields if a player was a winner of a major team competition (e.g. Hopman Cup, World Team Cup, Davis Cup, Fed Cup/Billie Jean King Cup, and Wheelchair World Team Cup).
  • As an alternative to |height=, the parameters |height_m=, |height_cm= or |height_ft= and |height_in= may be used.

Use as a child template

The embed parameter is used when embedding this infobox into another.

This infobox may be used to create a genre-specific section within {{Infobox person}} (or similar biographical infobox templates) for cases where a person may be notable in more than one field; a generic example is shown below. For guidance on usage, see Wikipedia:Infobox modules. Also see the Template:Infobox documentation which explains embedding and subboxes.

{{Infobox person
| name = 
| image = 
| caption = 
| birth_date = 
| birth_place = 
| <!-- etc. -->
| module = 
  {{Infobox tennis biography | embed=yes
  | turnedpro = 
  | retired = 
  | plays = 
  | careerprizemoney = 
  | <!-- etc. -->
  }}
}}

Embedding other templates

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

{{Infobox tennis biography
| name = 
| <!-- etc. -->
| module =
  {{Infobox ABC
  | embed = yes <!-- or child=yes / subbox=yes -->
  | <!-- etc. -->
  }}
}}

Microformat

Template:UF-hcard-person

Tracking categories