Lihimi Tɛmplet:ITF profile/doc ni yi shɛli na

{{Documentation subpage}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
{{Template shortcut|ITF|itf}}
{{Uses Wikidata|P8618}}<!--new ID-->
{{Lua|Module:EditAtWikidata}}
{{High-use}}

'''{{NAMESPACE}}:{{BASEPAGENAME}}''' displays an external link to a professional tennis player's profile at [https://www.itftennis.com/ ITFtennis.com], the official website of the [[International Tennis Federation]] (ITF). It is intended for use in the [[Wikipedia:External links|external links]] section of an article.

== Usage ==
Unnamed parameters:
: {{tlcw|{{BASEPAGENAME}} | <var>ID</var> }}
: {{tlcw|{{BASEPAGENAME}} | <var>ID</var> | <var>NAME</var> }}

Named parameters:
: {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> }}
: {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | name{{=}} <var>NAME</var> }}

Using [[Wikidata]] property [[d:Property:P8618|P8618]]:
: {{tlcw|{{BASEPAGENAME}} }}
: {{tlcw|{{BASEPAGENAME}} | name{{=}} <var>NAME</var> }}

== Examples ==

=== New ID (non-numeric) in template ===
; Usage in the article [[Roger Federer]], with article name as link text
: {{tlcw|a=1|{{BASEPAGENAME}} | roger-federer/800202678/sui }}
: {{tlcw|a=1|{{BASEPAGENAME}} | id{{=}} roger-federer/800202678/sui }}

; Usage with name parameter as link text
: {{tlcw|a=1|{{BASEPAGENAME}} | roger-federer/800202678/sui | Roger Federer }}
: {{tlcw|a=1|{{BASEPAGENAME}} | id{{=}} roger-federer/800202678/sui | name{{=}} Roger Federer }}

; Output
:* {{{{BASEPAGENAME}} | roger-federer/800202678/sui | Roger Federer }}

; Current URLs
: [https://www.itftennis.com/en/players/roger-federer/800202678/sui https://www.itftennis.com/en/players/{{highlight|roger-federer/800202678/sui}}]
: [https://www.itftennis.com/en/players/roger-federer/800202678/sui/mt/s/overview/ https://www.itftennis.com/en/players/{{highlight|roger-federer/800202678/sui}}/mt/s/overview/]

; Former URL
: [https://www.itftennis.com/procircuit/players/player/profile.aspx?playerid=10019424 https://www.itftennis.com/procircuit/players/player/profile.aspx?playerid={{highlight|10019424|pink}}] ([https://web.archive.org/web/20180101120000/https://www.itftennis.com/procircuit/players/player/profile.aspx?playerid=10019424 archive])

=== New ID (non-numeric) in Wikidata ===
; Usage in the article [[Maria Sharapova]]
: {{tlcw|a=1|{{BASEPAGENAME}} }}
: {{tlcw|a=1|{{BASEPAGENAME}} | name{{=}} Maria Sharapova }}

; Output
:* {{{{BASEPAGENAME}} | maria-sharapova/800229006/rus | Maria Sharapova }} [[File:OOjs UI icon edit-ltr-progressive.svg |frameless |text-top |10px |alt=Edit this at Wikidata |link=https://www.wikidata.org/wiki/Q11666#P8618 |Edit this at Wikidata]]

; Current URLs
: [https://www.itftennis.com/en/players/maria-sharapova/800229006/rus https://www.itftennis.com/en/players/{{highlight|maria-sharapova/800229006/rus}}]
: [https://www.itftennis.com/en/players/maria-sharapova/800229006/rus/wt/s/overview/ https://www.itftennis.com/en/players/{{highlight|maria-sharapova/800229006/rus}}/wt/s/overview/]

; Former URL
: [https://www.itftennis.com/procircuit/players/player/profile.aspx?playerid=100013223 https://www.itftennis.com/procircuit/players/player/profile.aspx?playerid={{highlight|100013223|pink}}] ([https://web.archive.org/web/20180101120000/https://www.itftennis.com/procircuit/players/player/profile.aspx?playerid=100013223 archive])

=== Old ID (numeric) in template ===
; Usage
: {{tlcw|a=1|{{BASEPAGENAME}} | 10019424 | Roger Federer }}
: {{tlcw|a=1|{{BASEPAGENAME}} | id{{=}} 10019424 | name{{=}} Roger Federer }}

; Output
:* {{{{BASEPAGENAME}} | 10019424 | Roger Federer }}

=== No ID in template or Wikidata ===
; Usage
: {{tlcw|a=1|{{BASEPAGENAME}} }}

; Output
:* {{{{BASEPAGENAME}} }}

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
  "description": "This template displays an external link to a professional tennis player's profile at ITFtennis.com, the official website of the International Tennis Federation (ITF). It is intended for use in the external links section of an article.",
  "params": {
    "id": {
      "label": "id",
      "aliases": ["1"], 
      "description": "The \"id\" parameter (or unnamed parameter \"1\") should contain the ID portion of the URL. Example: roger-federer/800202678/sui is the ID in https://www.itftennis.com/en/players/roger-federer/800202678/sui or https://www.itftennis.com/en/players/roger-federer/800202678/sui/mt/s/overview/.",
      "type": "string",
      "required": false,
      "default": "Wikidata property P8618"
    },
    "name": {
      "label": "name",
      "aliases": ["2"], 
      "description": "The \"name\" parameter (or unnamed parameter \"2\") may be used to specify the link text, which should be the name of the tennis player. This parameter is optional; it defaults to the Wikipedia article name, without any disambiguation such as \"(tennis)\".",
      "type": "string",
      "required": false,
      "default": "{{PAGENAMEBASE}}"
    }
  },
  "paramOrder": [
    "id",
    "name"
  ]
}
</templatedata>

== Tracking categories ==
; template with ID
* {{clc|ITF template using non-numeric ID}} – current ID and URL
* {{clc|ITF template using numeric ID}} – should be empty

; template missing ID
* {{clc|ITF template using Wikidata property P8618}} – current ID and URL
* {{clc|ITF template missing ID and not in Wikidata}} – should be empty

== Templates and modules used ==
* [[Template:First word]], implemented with [[Module:String]]
* [[Module:EditAtWikidata]]

== See also ==
* {{tl|ATP}} for a male player's profile at the [[Association of Tennis Professionals]] website
* {{tl|WTA}} for a female player's profile at the [[Women's Tennis Association]] website
* {{tl|Davis Cup player}} for a male player's profile at the [[Davis Cup]] website
* {{tl|Billie Jean King Cup player}} for a female player's profile at the [[Billie Jean King Cup]] website

== External links ==
* [https://www.itftennis.com/en/players/ ITF player search page]

<includeonly>{{Sandbox other||
<!-- Categories go here and interwikis go in Wikidata. -->
[[Category:People and person external link templates]]
[[Category:Sports governing body external link templates]]
[[Category:Tennis external link templates]]
[[Category:External link templates using Wikidata]]
[[Category:Templates that add a tracking category]]
}}</includeonly>