ਫਰਮਾ:Cite Box Office Mojo/doc ਲਈ ਸਰੋਤ ਵੇਖੋ

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Template shortcut|Cite BOM}}
{{Uses Wikidata|P345}}
{{CS1 wrapper |type= |base=Cite web}}
{{Lua|Module:EditAtWikidata}}

A template for citing box office data on [[Box Office Mojo]].

== Usage ==
{{csdoc|usage}}
{| class="wikitable" style="width: 100%"
|+ Basic parameters only, in horizontal format
|- style="vertical-align:top;"
|
: <code><nowiki>{{Cite Box Office Mojo |id= |title=}}</nowiki></code>
{{end}}
{{csdoc|usage full}}
: <code><nowiki>{{Cite Box Office Mojo |id= |title= |access-date= |archive-url= |archive-date= |url-status= |mode= |publisher_hide= }}</nowiki></code>
{{end}}
{{A note}} The {{para|id}} parameter is the same as the film's IMDb id.

*The field id can be left blank and will pull from [[Wikidata]] property {{Property|345}} if available, but will have an error message if no entered in template or available at Wikidata
*The field title can be left blank and will pull from the page name with parentheses

== Examples ==
'''<code><nowiki>{{Cite Box Office Mojo |id=0120338 |title=Titanic}}</nowiki></code>'''
: {{Cite Box Office Mojo |id=0120338 |title=Titanic}}
'''<code><nowiki>{{Cite Box Office Mojo |id=0120338 |title=Titanic |accessdate=February 14, 2020}}</nowiki></code>'''
: {{Cite Box Office Mojo |id=0120338 |title=Titanic |accessdate=February 14, 2020}}
'''<code><nowiki>{{Cite Box Office Mojo |id=0120338 |title=Titanic |accessdate=February 14, 2020 |mode=cs2}}</nowiki></code>'''
: {{Cite Box Office Mojo |id=0120338 |title=Titanic |accessdate=February 14, 2020 |mode=cs2}}

== Error detection ==
The parameter {{para|id}} is '''{{red|required}}''' if [[Wikidata]] property {{Property|345}} is not available. If omitted or left blank, error will be reported.

Examples:
{{demo
|demo_kill_categories =yes
|<nowiki>{{Cite Box Office Mojo|title=I'm an incomplete citation!}}</nowiki>
}}

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"id": {
			"label": "id",
			"description": "Number of the IMDb title, taken from the numbers at the end of its IMDb URL. This parameter is optional if Wikidata property P345 contains an ID starting with tt, but required if not. If entered manually, should not start with tt",
			"type": "string",
			"required": false,
			"default": "Wikidata property P345"
		},
		"title": {
			"label": "title",
			"description": "Title of the film. Defaults to the Wikipedia article name, without any disambiguation such as (film).",
			"type": "string",
			"required": false,
			"default": "{{PAGENAMEBASE}}"
		},
		"publisher_hide": {
			"label": "publisher_hide",
			"description": "To hide the publisher parameter",
			"type": "string",
			"required": false
		},
		"access-date": {
			"aliases": [
				"accessdate"
			],
			"label": "access date",
			"description": "The full date when the site was accessed; do not wikilink",
			"type": "date"
		},
		"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": "string"
		},
		"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"
		},
		"mode": {
			"label": "mode",
			"description": "Similar to the parameter used by cs1|2 templates, when set to cs2, element separator switches from dot to comma; static text is rendered in lowercase; rendering omits the trailing dot",
			"type": "string"
		}
	},
	"description": "A template for citing box office data on Box Office Mojo"
}
</templatedata>

== Wikidata ==
The [[Wikidata]] project provides a central collection of information and parameters for articles for the various [[Wikimedia Foundation]] projects. This includes the IMDB title codes for films. For example, the film ''[[Space Milkshake]]'' has a corresponding [[wikidata:Q7572422|Wikidata item (Q7572422)]], which in turn includes an [[wikidata:Property:P345|IMDb identifier]]. If {{tl|IMDb title}} is invoked in an article without the "id" parameter, and if Wikidata has an IMDb identifier specified for that article's corresponding item, the IMDb link with its title code will be included automatically.

For new film articles, the IMDb identifier property (and the film title item itself) may need to be added at Wikidata first, so that the default IMDb link can be available for use on Wikipedia and other Wikimedia projects.

This Wikidata capability was implemented on the English Wikipedia as of April 2013.

Note that the title code (first parameter) can still be specified as before and this will override the Wikidata default e.g. where this template is used to link to a film whose title does not correspond to the subject of the article (for example, in the case of a single article about a film and its sequels).

The title parameter override is available to handle differences between article titles and film titles (e.g. due to [[Wikipedia:Disambiguation|disambiguation]] wording in the title). The id parameter may be left blank to default from Wikidata - for example <nowiki>{{IMDb title||Film title}}</nowiki>.

== Tracking category ==
* {{clc|Cite Box Office Mojo templates with errors}}

==See also==

===Similar film citation templates===
*{{tl|Cite The Numbers}}
*{{tl|Cite Rotten Tomatoes}}
*{{tl|Cite Metacritic}}

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Specific-source templates]]
[[Category:External link templates using Wikidata]]
[[Category:Templates that add a tracking category]]
}}</includeonly>