View source for Template:IMDb name/doc

{{Documentation subpage}}

<!-- 
    PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE.
    YOU CAN EDIT THE TEMPLATE DOCUMENTATION AFTER THIS COMMENT.
-->

This is a template to generate links to the [[Internet Movie Database]] for names of film personnel. It should only be used in the "external links" section of an article.

:To link a work (film/movie, TV or Web program/series, video game, etc.), use {{Tl|IMDb title}}.
:To link a specific TV episode or Web series episode, use {{Tl|IMDb episode}}.
:To link an episode list, use {{Tl|IMDb episodes}}.
:To link a company, use {{Tl|IMDb company}}.
:To link a character, use {{Tl|IMDb character}}.
:To link an award, use {{Tl|IMDb award}}.

==Usage==
{{See also|Wikipedia:External links/Perennial websites#IMDb}}

The '''required''' parameter is the ID number. The template then uses the article title as the [[anchor text]]:
<pre>
* {{IMDb name |ID}}
* {{IMDb name | id = ID }}
</pre>
To have the link text be other than the article name, use second parameter:
<pre>
* {{IMDb name |ID |Name}}
* {{IMDb name | id = ID | name = Name}}
</pre>

This can be used when the Wikipedia page name contains disambiguation brackets; for example at the page [[John Smith (actor)]] use <code><nowiki>{{IMDb name|0808774|John Smith}}</nowiki></code> to have "{{IMDb name|0808774|John Smith}}" rather than "{{IMDb name|0808774|John Smith (actor)}}". This is also necessary should you need to add an IMDb link to an article about somebody or something other than the linked person (for example, if you include the IMDb link for [[Bette Davis]] in the [[Joan Crawford]] article, you must specify Bette Davis's name as the text for the link using this option).

The parameter {{Para|section}} can be set to <code>award</code> (alternatively <code>awards</code>) or <code>bio</code> (alternatively <code>biography</code>) to link to the awards or biography section for that person.

*<code><nowiki>{{IMDb name|0000008|Marlon Brando|section=award}}</nowiki></code> gives:
:{{IMDb name|0000008|Marlon Brando|section=award}}
*<code><nowiki>{{IMDb name|0000008|Marlon Brando|section=bio}}</nowiki></code> gives:
:{{IMDb name|0000008|Marlon Brando|section=bio}}

==Detailed instructions==
# Copy and paste one of the options above into the article
# Go to http://www.imdb.com/ and search for the person you want (say, Marlon Brando; you'll reach <code>http://www.imdb.com/find?q=Marlon+Brando&s=all</code>)
# Click on the correct Marlon Brando in the list; this will bring up the page:
## <code>http://www.imdb.com/name/nm0000008/</code> 
# Copy {{em|only}} the 7-digit number (here, "<code>0000008</code>"), omitting the "<code>nm</code>" but keep all the leading zeros (although IMDb seems to add missing leading zeroes in desktop mode [www.imdb.com], but in mobile mode [m.imdb.com] all 7 digits are needed or an error page is served)
# Replace "<code>ID</code>" in the template code with the number
## For the first option above, you'll then have
##: <code><nowiki>* {{IMDb name|0000008}}</nowiki></code> resulting in:
##* {{IMDb name|0000008}}
##: Note that the link text is the same as the title of the page the template is used on; outside the page "Marlon Brando", use the second option:
## Replace "<code>ID</code>" with the number ''and'' "<code>Name</code>" with "<code>Marlon Brando</code>"
##: <code><nowiki>* {{IMDb name|0000008|Marlon Brando}}</nowiki></code> results in:
##:* {{IMDb name|0000008|Marlon Brando}}

==Template data==
{{TemplateDataHeader}}
<templatedata>
{
	"description": "This template generates links to the Internet Movie Database for names of film personnel.",
	"params": {
		"1": {
			"label": "IMDb ID",
			"type": "number",
			"required": true,
			"description": "The IMDb ID for the target page.",
			"aliases":["id"]
		},
		"2": {
			"label": "Display name",
			"type": "string",
			"description": "Name that you want to have displayed. Defaults to article title.",
			"aliases":["name"]
		},
		"section": {
			"label": "IMDb article section",
			"type": "string",
			"description": "Set to \"award\" or \"awards\" to link to the awards section. Set to \"bio\" or \"biography\" to link to the biography section."
		}
	}
}
</templatedata>

==See also==
*[[:Template:IMDb]], a list of related templates
*[[Wikipedia:IMDb]]
*{{Tl|thetvdb}}

<includeonly>
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, THANKS. -->
[[Category:Film external link templates]]
[[Category:People and person external link templates]]
[[Category:Television external link templates]]
[[Category:Templates using data from Wikidata]]
</includeonly>