Template:Cite tweet/doc

A template for citing tweets posted on Twitter.

Usage
{| class="wikitable" style="width: 100%"
 * + Required parameters only, in horizontal format
 * - style="vertical-align:top;"



When known, the author's real name should be specified in the author parameter (or last and first). If their real name is not known, then the tweet is probably not an acceptable usage of a self-published source.

Using sfn and harvid
To use this template with shortened footnotes (e.g. the sfn template), add ref with harvid in the parameter value, like this:



This reference would be cited as.

Optional date parameter
Unlike most citation templates, the date parameter is optional. This is because the date can be calculated directly from the Tweet's ID using Module:TwitterSnowflake (wrapped with Template:TwitterSnowflake).

If the date parameter is off by more than one day from what the calculated date is, the template will output an error. This can be fixed by removing or correcting the date parameter.

If the Tweet was posted before November 4, 2010, the date cannot be calculated from the ID the template will output an error if no date is provided.

Examples
 

 

 

If the author has a Wikipedia article, use of author-link is recommended:  

Note that if last is used, author is ignored:  

This tweet was posted before November 4, 2010, so date is necessary:  

Error detection

 * The parameters user, number, and title are . If omitted or left blank, errors will be reported. For example:
 * The tweet URL depends on user and number; if either or both are missing, the URL defaults to https://twitter.com/
 * The tweet date depends on number for Tweets posted after November 4, 2010, if the given date parameter is off by more than a day from the calculated date, an error is displayed
 * Templates are checked for harv, which is an error. The ref parameter must use harvid in the value.
 * The template also checks for parameters that are unsupported (e.g. misspellings of parameter names).
 * Errors are tracked in Category:Cite tweet templates with errors
 * The template also checks for parameters that are unsupported (e.g. misspellings of parameter names).
 * Errors are tracked in Category:Cite tweet templates with errors

TemplateData
{	"params": { "number": { "label": "Tweet number", "description": "Numerical ID of the tweet", "type": "number", "required": true },		"user": { "label": "User handle", "description": "Twitter account name, without the @", "type": "string", "required": true },		"title": { "label": "Tweet contents", "description": "Partial or entire content of the tweet, optionally including hashtags (#), at signs (@), and links. Note: double quote marks (\") should be replaced with single quote marks (') because the entire title will display surrounded by double quotes.",			"type": "string",			"required": true		},		"author": {			"label": "Tweet author",			"description": "Author's real name, if known. If not known, then the tweet is probably not an acceptable usage of a self-published source (see WP:SPS)",			"suggested": true,			"type": "string"		},		"author-link": {			"aliases": [				"authorlink"			],			"label": "Author's article",			"description": "Title of existing Wikipedia article about the author",			"type": "wiki-page-name"		},		"retweet": {			"label": "Retweeted by",			"description": "The reliable source who retweeted the tweet, if the original tweeter is not anyone particularly notable. May be wikilinked."		},		"date": {			"label": "Date",			"description": "Date of the tweet; do not wikilink; do not include time.",			"type": "date",			"suggested": true		},		"access-date": {			"aliases": [				"accessdate"			],			"label": "Access date",			"description": "The full date when the tweet was accessed; do not wikilink",			"type": "date",			"suggested": true		},		"language": {			"label": "Language",			"description": "The language in which the tweet is written, if not in English.",			"example": "fr",			"type": "string"		},		"location": {			"label": "Tweet location",			"description": "The location from which a tweet was sent.",			"example": "London",			"type": "string"		},		"archive-url": {			"label": "Archive URL",			"aliases": [				"archiveurl"			],			"description": "The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archive-date'",			"type": "url" },		"archive-date": { "label": "Archive date", "aliases": [ "archivedate" ],			"description": "Date when the original URL was archived; do not wikilink", "type": "date" },		"url-status": { "label": "URL status", "description": "If set to 'live', the title displays as the live link; if set to dead, the title displays as the archive link", "type": "string" },		"script-title": { "label": "Tweet script", "description": "For tweets in languages that do not use a Latin-based alphabet (Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, Vietnamese, etc). Prefix with two-character ISO639-1 language code followed by a colon, e.g. for Japanese use: ja:...", "example": "ja:東京タワー", "type": "string" },		"trans-title": { "label": "Translated tweet", "description": "An English language translation, if the tweet cited is in a foreign language; use of 'language' parameter is recommended", "type": "string" },		"link": { "label": "Link to Twitter article?", "description": "Set to \"no\" to not link to the Wikipedia article for Twitter. Useful for preventing overlinking when more than one tweet is cited.", "type": "boolean" },		"df": { "label": "Date format", "description": "Valid values: dmy, dmy-all, mdy, mdy-all, ymd, ymd-all", "type": "string" },		"ref": { "label": "Ref anchor", "description": "An anchor identifier; can be made the target of wikilinks to full references", "type": "string" },		"quote": { "label": "Quote", "description": "Relevant text quoted from the source; displays last, enclosed in quotes; must include terminating punctuation", "type": "string" }	},	"description": "A template for citing tweets posted on Twitter", "paramOrder": [ "number", "user", "title", "author", "author-link", "retweet", "date", "access-date", "language", "location", "archive-url", "archive-date", "url-status", "script-title", "trans-title", "link", "df", "quote", "ref" ],	"format": "inline" }