Template:IMDb title/doc: Difference between revisions
Plastikspork (talk | contribs) Deleted |
|||
(28 intermediate revisions by 10 users not shown) | |||
Line 1: | Line 1: | ||
{{Documentation subpage}} |
{{Documentation subpage}} |
||
{{For-multi|a person|Template:IMDb name|a specific episode|Template:IMDb episode|an episode list|Template:IMDb episodes|an event|Template:IMDb event}} |
|||
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> |
|||
{{ |
{{High-use}} |
||
{{Lua|Module:EditAtWikidata|Module:String2}} |
|||
{{Uses Wikidata|P345}} |
{{Uses Wikidata|P345}} |
||
{{Lua|Module:EditAtWikidata}} |
|||
This template is used to generate an external link to a web page at [[IMDb]]. It should be used |
This template is used to generate an external link to a web page at [[IMDb]]. It should be used exclusively for TITLES—movies, TV series, games, etc.—and is intended for use in the [[Wikipedia:External links|external links]] section of an article. |
||
: ''For a person (actor, actress, etc.), use {{tl|IMDb name}}.'' |
|||
: ''For a specific TV episode or Web series episode, use {{tl|IMDb episode}}.'' |
|||
: ''For an episode list, use {{tl|IMDb episodes}}.'' |
|||
== Usage == |
== Usage == |
||
Unnamed parameters: |
Unnamed parameters: |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | <var>ID</var> }} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | <var>ID</var> | <var>TITLE</var> }} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | <var>ID</var> | <var>TITLE</var> | <var>DESCRIPTION</var> }} |
||
* {{tlcw|{{BASEPAGENAME}} | <var>ID</var> | <var>TITLE</var> | <var>DESCRIPTION</var> | section{{=}} <var>SECTION</var> }} |
|||
Named parameters: |
Named parameters: |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | id{{=}} <var>ID</var> }} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | title{{=}} <var>TITLE</var> }} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | title{{=}} <var>TITLE</var> | description{{=}} <var>DESCRIPTION</var>}} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | quotes{{=}} yes }} |
||
* {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | quotes{{=}} yes }} – for short films |
|||
Using [[Wikidata]] property {{Property|345}}: |
Using [[Wikidata]] property {{Property|345}}: |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} }} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | title{{=}} <var>TITLE</var> }} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | title{{=}} <var>TITLE</var> | description{{=}} <var>DESCRIPTION</var>}} |
||
* {{ |
* {{tlx|{{BASEPAGENAME}} | quotes{{=}} yes }} |
||
* {{tlcw|{{BASEPAGENAME}} | quotes{{=}} yes }} – for short films |
|||
== Instructions == |
== Instructions == |
||
Line 42: | Line 35: | ||
# Copy the 7- or 8-digit ID number that appears after <code>tt</code> in the URL. The leading "tt" is not required, but the template will still work if it is included. The leading zeros in the number are recommended for [[#Linksearch|Linksearch]] uniformity. |
# Copy the 7- or 8-digit ID number that appears after <code>tt</code> in the URL. The leading "tt" is not required, but the template will still work if it is included. The leading zeros in the number are recommended for [[#Linksearch|Linksearch]] uniformity. |
||
# Add the following to the external links section of the article: |
# Add the following to the external links section of the article: |
||
#: |
#: {{tlx|IMDb title|{{Hilite|######}}|''Film Name''}} or {{tlx|IMDb title|id{{=}}{{Hilite|######}}|title{{=}}''Film Name''}} |
||
#: or <code><nowiki>{{</nowiki>IMDb title | id= {{Hilite|######}} | title= ''Film Name'' }}</code> |
|||
#: where <code>######</code> is the number you've copied, and <code>''Film Name''</code> is the title of the movie or show. |
#: where <code>######</code> is the number you've copied, and <code>''Film Name''</code> is the title of the movie or show. |
||
# (Optional) If you want to add an additional description to distinguish this film/show from another that may be on the same page with the same name, use the following text: |
# (Optional) If you want to add an additional description to distinguish this film/show from another that may be on the same page with the same name, use the following text: |
||
#: |
#: {{tlx|IMDb title|#######|''Title''|''Description''}} |
||
#: where <code>#######</code> is the number you've copied, <code>''Title''</code> is the title of the movie or show, and <code>''Description''</code> is the description of the show, in parentheses. |
#: where <code>#######</code> is the number you've copied, <code>''Title''</code> is the title of the movie or show, and <code>''Description''</code> is the description of the show, in parentheses. The description is rendered outside the automatic quote marks or italic formatting. |
||
# (Optional) There is also the <code>section</code> parameter which can be set to <code>awards</code> to link to the Awards section of the site. |
|||
# If the IMDb page is about a short film, add {{para|quotes|yes}} to display with quotation marks (per [[MOS:TITLES]] rather than the template's default italics; any value for this parameter will work, e.g. {{para|quotes|y}} or {{para|quotes|true}}. Note: For an episode of a TV series, use {{tlx|IMDb episode}} instead of this template. |
|||
== Examples == |
== Examples == |
||
=== Parameter: id (1) === |
=== Parameter: id (1) === |
||
# Search on [https://www.imdb.com IMDb.com] for the title [[Alpha Dog]]. This can also be done on the Wikipedia page by previewing |
# Search on [https://www.imdb.com IMDb.com] for the title ''[[Alpha Dog]]''. This can also be done on the Wikipedia page by previewing {{tlx|IMDb title}} and clicking that link (https://www.imdb.com/find?q=Alpha+Dog&s=tt). |
||
# On the IMDb search results page, click the link for "Alpha Dog (2006)". That IMDb page URL is: |
# On the IMDb search results page, click the link for "Alpha Dog (2006)". That IMDb page URL is: |
||
#: <code>[https://www.imdb.com/title/tt0426883/ https://www.imdb.com/title/tt{{Hilite|0426883}}/]</code> or <code>[http://www.imdb.com/title/tt0426883/ http://www.imdb.com/title/tt{{Hilite|0426883}}/]</code> |
#: <code>[https://www.imdb.com/title/tt0426883/ https://www.imdb.com/title/tt{{Hilite|0426883}}/]</code> or <code>[http://www.imdb.com/title/tt0426883/ http://www.imdb.com/title/tt{{Hilite|0426883}}/]</code> |
||
# Copy <code>0426883</code> and add it to the template |
# Copy <code>0426883</code> and add it to the template: |
||
# |
#* {{tlx|IMDb title|0426883|_show_result=y}} |
||
# |
#* {{tlx|IMDb title|id{{=}}0426883}} |
||
#: <code><nowiki>* {{IMDb title | id= 0426883 }}</nowiki></code> |
|||
#:* {{IMDb title | id= 0426883 }} |
|||
Typically this is a list item in the external links section (even if there is only one link), so you should add "*" in front. |
Typically this is a list item in the external links section (even if there is only one link), so you should add "*" in front. |
||
=== Parameter: title (2) === |
=== Parameter: title (2) === |
||
* {{tlx|IMDb title|0426883|Alpha Dog|_show_result=y}} |
|||
* {{tlx|IMDb title|id{{=}}0426883|title{{=}}Alpha Dog|_show_result=y}} |
|||
<code><nowiki>* {{IMDb title | id= 0426883 | title= Alpha Dog }}</nowiki></code> |
|||
:* {{IMDb title | id= 0426883 | title= Alpha Dog }} |
|||
=== Parameter: description (3) === |
=== Parameter: description (3) === |
||
* {{tlx|IMDb title|0106117|Route 66|(1993 TV series)|_show_result=y}} |
|||
* {{tlx|IMDb title|id{{=}}0106117|title{{=}}Route 66|description{{=}}(1993 TV series)|_show_result=y}} |
|||
=== Parameter: qid === |
|||
<code><nowiki>* {{IMDb title | id= 0106117 | title= Route 66 | description= (1993 TV series) }}</nowiki></code> |
|||
Using Wikidata property {{Prop|345}} from Wikidata item {{Q|105801}}: |
|||
:* {{IMDb title | id= 0106117 | title= Route 66 | description= (1993 TV series) }} |
|||
* {{tlx|IMDb title|qid{{=}}Q105801|title{{=}}Stargate|_show_result=y}} |
|||
=== |
=== No parameters === |
||
Usage in Wikipedia article [[Stargate (film)|''Stargate'' (film)]]: |
|||
<code><nowiki>* {{IMDb title | 0111282 | Stargate | section= awards }}</nowiki></code> |
|||
* {{tlx|IMDb title}} → {{IMDb title|qid=Q105801|title=Stargate}} |
|||
<code><nowiki>* {{IMDb title | id= 0111282 | title= Stargate | description= (1994 film) | section= awards }}</nowiki></code> |
|||
:* {{IMDb title | id= 0111282 | title= Stargate | description= (1994 film) | section= awards }} |
|||
=== Parameter: quotes === |
|||
Used for short films, which take quotation marks instead of the default italics. |
|||
<code><nowiki>* {{IMDb title |id=42360 |title=Cue Ball Cat |quotes=y}}</nowiki></code> |
|||
:* {{IMDb title |id=42360 |title=Cue Ball Cat |quotes=y}} |
|||
==TemplateData== |
==TemplateData== |
||
Line 96: | Line 73: | ||
<templatedata> |
<templatedata> |
||
{ |
{ |
||
"description": "This is a template to generate links to Internet Movie Database.", |
|||
"params": { |
|||
"id": { |
|||
"label": "ID", |
|||
"aliases": [ |
|||
"1" |
|||
"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.", |
|||
], |
|||
"type": "number", |
|||
"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 or the qid paramter is used, but required if not.", |
|||
"required": false, |
|||
"type": "number", |
|||
"default": "Wikidata property P345 or IMDb search URL" |
|||
"required": false, |
|||
}, |
|||
"default": "Wikidata property P345 or IMDb search URL" |
|||
"title": { |
|||
}, |
|||
"label": "Title", |
|||
"title": { |
|||
"aliases" : [ "2" ], |
|||
"label": "Title", |
|||
"description": "Title of the production. Defaults to the Wikipedia article name, without any disambiguation such as (film).", |
|||
"aliases": [ |
|||
"type": "string", |
|||
"2" |
|||
"required": false, |
|||
], |
|||
"default": "{{PAGENAMEBASE}}" |
|||
"description": "Title of the production. Defaults to the Wikipedia article name, without any disambiguation such as (film).", |
|||
}, |
|||
"type": "string", |
|||
"description": { |
|||
"required": false, |
|||
"label": "Description", |
|||
"default": "{{PAGENAMEBASE}}" |
|||
"aliases" : [ "3" ], |
|||
}, |
|||
"description": "Description of the production, such as the year made (in parentheses).", |
|||
"description": { |
|||
"type": "string", |
|||
"label": "Description", |
|||
"required": false |
|||
"aliases": [ |
|||
}, |
|||
"3" |
|||
"section": { |
|||
], |
|||
"label": "Section", |
|||
"description": "Description of the production, such as the year made (in parentheses).", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
} |
|||
"qid": { |
|||
} |
|||
"description": "Retrieves the id stored at a specific WikiData item, this can be used to get an id stored in another item without using the 'id' parameter." |
|||
}, |
|||
"link_hide": { |
|||
"description": "If parameter is used and has something other than blank, IMDb will not be wikilinked" |
|||
} |
|||
} |
|||
} |
} |
||
</templatedata> |
</templatedata> |
||
Line 140: | Line 123: | ||
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). |
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 second parameter for the film title override is still available to handle differences between article titles and film titles (e.g. due to [[Wikipedia:Disambiguation|disambiguation]] wording in the title). The first parameter may be left blank to default from Wikidata |
The second parameter for the film title override is still available to handle differences between article titles and film titles (e.g. due to [[Wikipedia:Disambiguation|disambiguation]] wording in the title). The first parameter may be left blank to default from Wikidata – for example <nowiki>{{IMDb title||Film title}}</nowiki>. |
||
== Sections == |
|||
The template will automatically change when the template is used on lists of awards, characters, or soundtracks. The url is made more specific to reflect the articles scope. This is done by identifying the articles type through Wikidata. |
|||
== Linksearch == |
== Linksearch == |
||
Line 149: | Line 135: | ||
== Tracking categories == |
== Tracking categories == |
||
<section begin=Tracking/> |
|||
* {{clc|IMDb template with no id set}} |
|||
* {{ |
* {{Category link with count|IMDb template with invalid id set}} |
||
* {{Category link with count|Pages using IMDb title with no id set}} |
|||
* {{Category link with count|Pages using IMDb title instead of IMDb episode}} |
|||
* {{Category link with count|Pages using IMDb title instead of IMDb episodes}} |
|||
* {{Category link with count|Pages using IMDb title with unknown parameters}} |
|||
* {{Category link with count|IMDb title ID different from Wikidata}} |
|||
* {{Category link with count|IMDb title ID not in Wikidata}}<section end=Tracking/> |
|||
== See also == |
== See also == |
||
Line 156: | Line 148: | ||
Similar television title template: |
Similar television title template: |
||
* {{tl|BBC |
* {{tl|BBC programme}} |
||
* {{tl|TheTVDB}} |
* {{tl|TheTVDB}} |
||
* {{tl|Screenonline TV title}} |
* {{tl|Screenonline TV title}} – which focuses on British television series |
||
Similar film title templates: |
Similar film title templates: |
||
Line 164: | Line 156: | ||
* {{tl|TCMDb title}} |
* {{tl|TCMDb title}} |
||
* {{tl|AFI film}} |
* {{tl|AFI film}} |
||
* {{tl|BFI}} |
|||
* {{tl|Screenonline title}} |
* {{tl|Screenonline title}} |
||
* {{tl|Rotten Tomatoes}} |
* {{tl|Rotten Tomatoes}} |
||
Line 171: | Line 162: | ||
<includeonly>{{Sandbox other|| |
<includeonly>{{Sandbox other|| |
||
<!-- Categories go here and interwikis go in Wikidata. --> |
|||
{{DEFAULTSORT:Imdb title}} |
|||
[[Category:Film external link templates]] |
[[Category:Film external link templates]] |
||
[[Category:Television external link templates]] |
[[Category:Television external link templates]] |
||
Line 178: | Line 167: | ||
[[Category:Templates that add a tracking category]] |
[[Category:Templates that add a tracking category]] |
||
[[Category:External link templates using Wikidata]] |
[[Category:External link templates using Wikidata]] |
||
[[Category:IMDb templates]] |
|||
}}</includeonly> |
}}</includeonly> |
Latest revision as of 23:17, 5 August 2024
This is a documentation subpage for Template:IMDb title. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 198,000 pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
- IMDb ID (P345) (see uses)
This template is used to generate an external link to a web page at IMDb. It should be used exclusively for TITLES—movies, TV series, games, etc.—and is intended for use in the external links section of an article.
Usage
[edit]Unnamed parameters:
{{IMDb title|ID}}
{{IMDb title|ID|TITLE}}
{{IMDb title|ID|TITLE|DESCRIPTION}}
Named parameters:
{{IMDb title|id= ID}}
{{IMDb title|id= ID|title= TITLE}}
{{IMDb title|id= ID|title= TITLE|description= DESCRIPTION}}
{{IMDb title|id= ID|quotes= yes}}
Using Wikidata property IMDb ID (P345):
{{IMDb title}}
{{IMDb title|title= TITLE}}
{{IMDb title|title= TITLE|description= DESCRIPTION}}
{{IMDb title|quotes= yes}}
Instructions
[edit]- Search on IMDb.com for the title you want. On the Wikipedia page of the film concerned this can often be done with the link produced by previewing
{{IMDb title}}
(this may not work if the page title is more than just the film title). - Click on the correct link to go to the movie's page (or whatever you're looking for). Be sure you're getting on the correct title page.
- The page URL should look like this:
https://www.imdb.com/title/tt######/
- where
######
indicates a number.
- Copy the 7- or 8-digit ID number that appears after
tt
in the URL. The leading "tt" is not required, but the template will still work if it is included. The leading zeros in the number are recommended for Linksearch uniformity. - Add the following to the external links section of the article:
{{IMDb title|######|Film Name}}
or{{IMDb title|id=######|title=Film Name}}
- where
######
is the number you've copied, andFilm Name
is the title of the movie or show.
- (Optional) If you want to add an additional description to distinguish this film/show from another that may be on the same page with the same name, use the following text:
{{IMDb title|#######|Title|Description}}
- where
#######
is the number you've copied,Title
is the title of the movie or show, andDescription
is the description of the show, in parentheses. The description is rendered outside the automatic quote marks or italic formatting.
Examples
[edit]Parameter: id (1)
[edit]- Search on IMDb.com for the title Alpha Dog. This can also be done on the Wikipedia page by previewing
{{IMDb title}}
and clicking that link (https://www.imdb.com/find?q=Alpha+Dog&s=tt). - On the IMDb search results page, click the link for "Alpha Dog (2006)". That IMDb page URL is:
- Copy
0426883
and add it to the template:{{IMDb title|0426883}}
→ IMDb title/doc at IMDb{{IMDb title|id=0426883}}
Typically this is a list item in the external links section (even if there is only one link), so you should add "*" in front.
Parameter: title (2)
[edit]{{IMDb title|0426883|Alpha Dog}}
→ Alpha Dog at IMDb{{IMDb title|id=0426883|title=Alpha Dog}}
→ Alpha Dog at IMDb
Parameter: description (3)
[edit]{{IMDb title|0106117|Route 66|(1993 TV series)}}
→ Route 66 (1993 TV series) at IMDb{{IMDb title|id=0106117|title=Route 66|description=(1993 TV series)}}
→ Route 66 (1993 TV series) at IMDb
Parameter: qid
[edit]Using Wikidata property IMDb ID (P345) from Wikidata item Stargate (Q105801):
{{IMDb title|qid=Q105801|title=Stargate}}
→ Stargate at IMDb
No parameters
[edit]Usage in Wikipedia article Stargate (film):
{{IMDb title}}
→ Stargate at IMDb
TemplateData
[edit]TemplateData for IMDb title
This is a template to generate links to Internet Movie Database.
Parameter | Description | Type | Status | |
---|---|---|---|---|
ID | id 1 | 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 or the qid paramter is used, but required if not.
| Number | optional |
Title | title 2 | Title of the production. Defaults to the Wikipedia article name, without any disambiguation such as (film).
| String | optional |
Description | description 3 | Description of the production, such as the year made (in parentheses). | String | optional |
qid | qid | Retrieves the id stored at a specific WikiData item, this can be used to get an id stored in another item without using the 'id' parameter. | Unknown | optional |
link_hide | link_hide | If parameter is used and has something other than blank, IMDb will not be wikilinked | Unknown | optional |
Wikidata
[edit]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 item (Q7572422), which in turn includes an IMDb identifier. If {{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 second parameter for the film title override is still available to handle differences between article titles and film titles (e.g. due to disambiguation wording in the title). The first parameter may be left blank to default from Wikidata – for example {{IMDb title||Film title}}.
Sections
[edit]The template will automatically change when the template is used on lists of awards, characters, or soundtracks. The url is made more specific to reflect the articles scope. This is done by identifying the articles type through Wikidata.
Linksearch
[edit]For a given link target (or first part of that) the pages from where there are links are found by a link such as this:
- https://en.wikipedia.org/w/index.php?title=Special:Linksearch&target=https%3A%2F%2Fbackend.710302.xyz%3A443%2Fhttp%2Fwww.imdb.com%2Ftitle%2Ftt0426 (for http links)
- https://en.wikipedia.org/w/index.php?title=Special:Linksearch&target=https%3A%2F%2Fbackend.710302.xyz%3A443%2Fhttps%2Fwww.imdb.com%2Ftitle%2Ftt0426 (for https links)
Tracking categories
[edit]- Category:IMDb template with invalid id set (4)
- Category:Pages using IMDb title with no id set (3,641)
- Category:Pages using IMDb title instead of IMDb episode (14)
- Category:Pages using IMDb title instead of IMDb episodes (178)
- Category:Pages using IMDb title with unknown parameters (0)
- Category:IMDb title ID different from Wikidata (4,017)
- Category:IMDb title ID not in Wikidata (874)
See also
[edit]Similar television title template:
- {{BBC programme}}
- {{TheTVDB}}
- {{Screenonline TV title}} – which focuses on British television series
Similar film title templates:
- {{AllMovie title}}
- {{TCMDb title}}
- {{AFI film}}
- {{Screenonline title}}
- {{Rotten Tomatoes}}
- {{Metacritic film}}
- {{Mojo title}}