Intaai wowonod montok do Templat:Twitter/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Warning|The [[Wikipedia:External links|external links guideline]] recommends [[WP:ELNO|avoiding ==External links== to Twitter]]. Only include links to social media if the subject is particularly known for using that social medium, '''and''' when the link provides the reader with significant unique content, '''and''' it is not easily linked from another link included in the article (i.e. if the individual's homepage is linked and ''that'' has a prominent link to a X feed, delete the X link here, see [[WP:ELMINOFFICIAL]]). Wikipedia is [[WP:NOTDIR|not a comprehensive directory of a subject's web presence]]. Only link to [[WP:ELOFFICIAL|official accounts]] "controlled by the subject (organization or individual person) of the Wikipedia article". Legitimate X accounts are usually named in [[WP:RS|reliable sources]] or linked to by other subject-controlled sources.}}
{{for multi|the template for embedding tweets in articles|Template:Tweet|the navbox|Template:X navbox}}
{{see also|Template:Cite tweet|Wikipedia:External links/Perennial websites}}
{{Template redirects|xsn|Twitter.com|Twitter user|Official Twitter page}}
{{Uses Wikidata|P2002}}
{{Tracks Wikidata|P2002}}
{{Lua|Module:EditAtWikidata|Module:WikidataCheck}}
{{high-use}}

This template generates an external link to an account at [[X (social network)|X]]. It is designed to standardize the text and formatting of links to the legitimate X account profiles of persons or organizations with sufficient [[Wikipedia:Notability|notability]] to be the subject of a Wikipedia article. However, adding a X link is never mandatory and in certain cases should be discouraged.

Note that ''very many'' fake Twitter accounts have been created as hoaxes, parodies, or attempts by fans to mimic a celebrity's style convincingly. Please make a detailed effort to verify the authenticity of any external links you wish to include.

Legitimate Twitter accounts can be found through being named in [[WP:RS|reliable sources]], such as in newspaper stories about the subject, or linked to by other subject-controlled sources, such as the subject's legitimate website. [[Twitter verification#Since November 2022|Since November 2022]], an X account having a [[Twitter verification|verification badge]] no longer indicates any legitimacy, as it is now available to anyone with a [[Twitter Blue]] subscription.

==Usage summary==
; One parameter
: <code><nowiki>{{</nowiki>xsn | <var>username</var> }}</code>
: <code><nowiki>{{</nowiki>xsn | id= <var>username</var> }}</code>

; Two parameters
: <code><nowiki>{{</nowiki>xsn | <var>username</var> | <var>Displayed Name</var> }}</code>
: <code><nowiki>{{</nowiki>xsn | id= <var>username</var> | name= <var>Displayed Name</var> }}</code>

; Using Wikidata property
: <code><nowiki>{{</nowiki>xsn<nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>xsn | name= <var>Displayed Name</var> }}</code>

==Explanations and examples==

=== One parameter ===
Fill this parameter with the ID string used in the [[URL]] for the user's account profile on X. When one parameter is used, the [[link text]] is the title of the Wikipedia article where this template is used.

; URL
: <code>[https://x.com/X https://x.com/{{Highlight|X}}]</code>

; Usage
: <code><nowiki>* {{</nowiki>xsn | {{Highlight|X}} }}</code>
: <code><nowiki>* {{</nowiki>xsn | id= {{Highlight|X}} }}</code>

; Output
:* {{xsn|X}}
:* {{ xsn | id= X }}

Since "X" is the name of the Wikipedia page you now are looking at, the link above appears as "X on X" on this Wikipedia page. The lead name will change according to the name of the Wikipedia page.

=== Two parameters ===
The first parameter will be the ID string used in the [[URL]] at Twitter. The second parameter will be used as the [[link text]].

; URLs
: <code>[https://x.com/AcadiaU https://x.com/{{Highlight|AcadiaU}}]</code>

; Usage
: <code><nowiki>* {{</nowiki>xsn | {{Highlight|AcadiaU}} | Acadia University }}</code>
: <code><nowiki>* {{</nowiki>xsn | id= {{Highlight|AcadiaU}} | name= Acadia University }}</code>

; Output
:* {{xsn | AcadiaU | Acadia University }}
:* {{xsn | id= AcadiaU | name= Acadia University }}

=== No parameters and Wikidata property not defined ===
When used without an "id" parameter, this template will call data from [[Wikidata]], if available. If none is available, the category [[:Category:Twitter template missing ID and not in Wikidata]] will be applied and an error message will be displayed.

; Usage
: <code><nowiki>* {{</nowiki>xsn<nowiki>}}</nowiki></code>

; Output
:* {{xsn}}

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
  "description": "This template generates an external link to an account at X.",
  "params": {
    "id": {
      "label": "ID",
      "aliases": [ "1" ],
      "description": "The username in the X URL, such as AcadiaU in https://x.com/AcadiaU. This parameter is optional if Wikidata property P2002 exists, but required if not.",
      "default": "Wikidata property P2002",
      "example": "AcadiaU",
      "type": "string",
      "required": false
    },
    "name": {
      "label": "Name",
      "aliases": [ "2" ],
      "description": "The name displayed as the link text. This parameter is optional; it defaults to the Wikipedia article name, without disambiguation.",
      "default": "{{PAGENAMEBASE}}",
      "example": "Acadia University",
      "type": "string",
      "required": false
    }
  },
  "paramOrder": [
    "id",
    "name"
  ]
}
</templatedata>

==Tracking categories==
* {{clc|Twitter username different from Wikidata}} – ''comparison is [[case insensitive]], so [https://twitter.com/AcadiaU AcadiaU] matches [https://twitter.com/acadiau acadiau]''
* {{clc|Twitter username not in Wikidata}}
* {{clc|Twitter template missing ID and not in Wikidata}}
* {{clc|Pages using Twitter with unknown parameters}}

==See also==
* {{tl|Cite Twitter profile}}, for use inside ref tags
* {{tl|Tweet}}
* {{tl|Cite tweet}}
* [[Wikipedia:TWITTER]]
* {{tl|Facebook}}
* {{tl|Instagram}}
* {{tl|Pinterest}}
* {{tl|Tumblr}}
* {{tl|flickr-inline}}
* {{tl|flickr-inline2}}

<includeonly>{{Sandbox other||
<!--Categories below this line, please; interwikis at Wikidata-->
[[Category:Social media external link templates]]
[[Category:People and person external link templates]]
[[Category:External link templates using Wikidata]]
[[Category:Templates that add a tracking category]]
[[Category:Twitter templates]]
}}</includeonly>