View source for Template:Tweet/doc

{{documentation subpage}}
{{tweet|name=Example|username=example|text=Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc dignissim, dolor vitae ullamcorper aliquet, velit mi sagittis metus.|date=12 Jul 2017|reference={{dummy reference}} }}
This template allows relevant tweets to be easily quoted within articles, with a citation automatically generated using {{tlx|cite tweet}}.

Using this template is better than a screen-shot of a tweet because the text is [[WP:ACCESSIBLE|accessible]] to screen readers.

It is an alternative to standard quotation templates because it displays all relevant information about the tweet (date of posting, user's name, user's handle, etc).

== Full blank syntax ==
<pre>
{{tweet
|text =        [content of the tweet]
|name =        [user's name as it appears at the top of the tweet]
|username =    [user's @ handle]
|date =        [date of the tweet formatted according to MOS:DATE]
|ID =          [number at the end of the tweet URL]
|replyto =     [optional: username tweet is replying to]
|image =       [optional: image or logo associated with twitter account]
|left =        [optional: any value makes tweet aligned left]
|block =       [optional: any value displays tweet as block (text above and below, doesn't flow around).]
|width =       [optional: custom tweet width]
|reference =   [optional: {{tweet}} automatically creates a reference, but one can be provided to use instead. See 2nd example.]
|lang =        [optional: language code of the tweet if non-English]
|translation = [optional: English translation of tweet if original tweet non-English]
}}
</pre>

== Example usage: ==
<pre><nowiki>
{{tweet
|text=@WilliamShatner Good day, Captain. #ISS is in standard orbit and Commander Swanson has the conn. Hope you’re having a great weekend!
|name=NASA
|username=NASA
|date=Aug 2, 2014
|ID=495719809695621121
|replyto=WilliamShatner
|image=NASA logo.svg
}}
</nowiki></pre>
{{clear}}
{{tweet
|text=@WilliamShatner Good day, Captain. #ISS is in standard orbit and Commander Swanson has the conn. Hope you’re having a great weekend!
|name=NASA
|username=NASA
|date=Aug 2, 2014
|ID=495719809695621121
|replyto=WilliamShatner
|image=NASA logo.svg
}}
{{clear}}
<pre><nowiki>
{{tweet
|text=Despite the constant negative press covfefe
|name=Donald J. Trump
|username=realDonaldTrump
|date=30 May 2017
|ID=869766994899468288
|left=yes
|reference={{dummy reference}}
}}
</nowiki></pre>
{{clear}}
{{tweet
|text=Despite the constant negative press covfefe
|name=Donald J. Trump
|username=realDonaldTrump
|date=30 May 2017
|ID=869766994899468288
|left=yes
|reference={{dummy reference}}
}}
{{clear}}
<pre><nowiki>
{{tweet
|name=Donald J. Trump
|username=realDonaldTrump
|date=Jan 5 2018
|text=I authorized Zero access to White House (actually turned him down many times) for author of phony book! I never spoke to him for book. Full of lies, misrepresentations and sources that don't exist. Look at this guy's past and watch what happens to him and Sloppy Steve [Bannon]!
|reference={{dummy reference}}
|block=yes
}}
</nowiki></pre>
{{clear}}
{{tweet|name=Donald J. Trump|username=realDonaldTrump|date=Jan 5 2018|text=I authorized Zero access to White House (actually turned him down many times) for author of phony book! I never spoke to him for book. Full of lies, misrepresentations and sources that don't exist. Look at this guy's past and watch what happens to him and Sloppy Steve [Bannon]!|reference={{dummy reference}}|block=yes}}
{{clear}}
<pre><nowiki>
{{tweet
|text=Dubito, ergo cogito, ergo sum
|lang=la
|translation=I doubt, therefore I think, therefore I am
|username=descartes
|name=René Descartes
|ref=example
|date=1637
}}
</nowiki></pre>
{{tweet
|text=Dubito, ergo cogito, ergo sum
|lang=la
|translation=I doubt, therefore I think, therefore I am
|username=descartes
|name=René Descartes
|ref=<ref>example</ref>
|date=Jan 1 1637
}}
{{clear}}
==TemplateData==
<templatedata>
{
	"params": {
		"block": {
			"label": "block",
			"description": "Any value displays tweet as block (text above and below, doesn't flow around). Overrides left parameter",
			"type": "string"
		},
		"width": {
			"label": "width",
			"description": "Custom tweet width",
			"example": "300px",
			"type": "string"
		},
		"left": {
			"label": "left",
			"description": "Any value makes tweet aligned left",
			"type": "string"
		},
		"name": {
			"label": "name",
			"description": "User's name as it appears at the top of the tweet",
			"type": "string",
			"required": true
		},
		"username": {
			"label": "username",
			"description": "User's Twitter handle. Do not include the @ symbol.",
			"required": true
		},
		"date": {
			"label": "date",
			"description": "Date of the tweet formatted according to MOS:DATE",
			"type": "date",
			"required": true
		},
		"text": {
			"label": "text",
			"description": "Content of the tweet",
			"type": "string",
			"required": true
		},
		"ID": {
			"aliases": [
				"id"
			],
			"label": "ID",
			"description": "The number at the end of the tweet URL",
			"type": "number",
			"suggested": true
		},
		"reference": {
			"label": "reference",
			"description": "A custom reference can be provided to use instead of the automatically generated one",
			"example": "<ref>custom reference</ref>",
			"aliases": [
				"ref"
			],
			"type": "string"
		},
		"image": {
			"label": "image",
			"description": "Image or logo associated with twitter account",
			"type": "wiki-file-name"
		},
		"replyto": {
			"label": "replyto",
			"description": "Username the tweet is replying to",
			"type": "string"
		},
		"lang": {
			"label": "lang",
			"description": "language code of original tweet",
			"example": "de",
			"type": "string",
			"aliases": [
				"language"
			]
		},
		"translation": {
			"label": "translation",
			"description": "english translation of the tweet"
		}
	},
	"description": "This template allows relevant tweets to be easily quoted within articles, with a citation automatically generated using the template, \"cite tweet\".\n\nUsing this template is better than a screen-shot of a tweet because the text is accessible to screen readers.\n\nIt is an alternative to standard quotation templates because it displays all relevant information about the tweet (date of posting, user's name, user's handle, etc) in a way that reflects Twitter's design language."
}
</templatedata>

== Refs ==
{{reflist}}

[[Category:Quotation templates]]