Template:IMDb name/doc: Difference between revisions

Latest revision as of 04:34, 3 September 2020

This is a documentation subpage for Template:IMDb name.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 154,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:

Module:EditAtWikidata

This template is used to generate an external link to a web page for a person in the Internet Movie Database. It is intended for use in the external links section of an article.

For a work (film/movie, TV or Web program/series, video game, etc.), use {{IMDb title}}.

For a specific TV episode or Web series episode, use {{IMDb episode}}.

For an episode list, use {{IMDb episodes}}.

For a company, use {{IMDb company}}.

For an event, use {{IMDb event}}.

Usage

If the subject of the Wikipedia article is the same as the IMDb page, only ID number is required. The template then uses the Wikipedia article name as the anchor text.

{{IMDb name | ID }}
{{IMDb name | id= ID }}

To have the link text be other than the article name, use second parameter. This is necessary when adding 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).

{{IMDb name | ID | NAME }}
{{IMDb name | id= ID | name= NAME }}

The parameter |section= can be set to award (alternatively awards) or bio (alternatively biography) to link to the awards or biography section for that person.

{{IMDb name | ID | NAME | section= SECTION }}
{{IMDb name | id= ID | name= NAME | section= SECTION }}

The ID number may be omitted if the article's Wikidata item includes property (P345).

{{IMDb name}}
{{IMDb name | name= NAME }}
{{IMDb name | name= NAME | section= SECTION }}

Instructions and examples

Go to IMDb.com and search for the person you want (say, Marlon Brando; you'll reach https://www.imdb.com/find?q=Marlon+Brando&s=all). This can also be done on the Wikipedia page by previewing {{IMDb name}} and clicking that link ( https://www.imdb.com/find?q=Marlon+Brando&s=nm ).
Click on the correct name in the list (for the actor Marlon Brando, this will bring up the page https://www.imdb.com/name/nm0000008/)
Copy only the 7- or 8-digit number (here, "0000008"), omitting the "nm" but keep all the leading zeros.
Replace "ID" in the template code with the number
1. For the first option above, you'll then have
  * {{IMDb name | 0000008 }} resulting in:
  - IMDb name/doc at IMDb
  Note that the link text is the same as the name of the Wikipedia page the template is used on; outside the page "Marlon Brando", use the second option:
2. Replace "ID" with the number and "Name" with "Marlon Brando"
  * {{IMDb name | 0000008 | Marlon Brando }} results in:
  - Marlon Brando at IMDb
3. The parameter |section= can be set to award (alternatively awards) or bio (alternatively biography) to link to the awards or biography section for that person.
  * {{IMDb name | 0000008 | Marlon Brando | section= awards }} gives:
  - Awards for Marlon Brando at IMDb
  * {{IMDb name | 0000008 | Marlon Brando | section= bio }} gives:
  - Biography for Marlon Brando at IMDb

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for this template in articles based on this TemplateData.

TemplateData for IMDb name

This template is used to generate an external link to a web page for a person in the Internet Movie Database.

Template parameters
Parameter		Description	Type	Status
ID	`id` `1`	The IMDb ID for the target page. This parameter is optional if Wikidata property P345 contains an ID starting with nm, but required if not. Default Wikidata property P345 or IMDb search URL	Number	optional
Name	`name` `2`	Name to be displayed as link text. Defaults to the Wikipedia article name, without any disambiguation such as (actor). Default {{PAGENAMEBASE}}	String	optional
Section	`section`	IMDb article section. Set to "award" or "awards" to link to the awards section. Set to "bio" or "biography" to link to the biography section.	String	optional

@@ Line 1: / Line 1: @@
-<includeonly>{{template doc page transcluded}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
+{{Documentation subpage}}
-<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
+{{High-use}}
-This is a template to generate links to [[Internet Movie Database]]. This template '''should be used exclusively for ''PEOPLE'''''.
+<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
+{{Uses Wikidata|P345}}
+{{Lua|Module:EditAtWikidata}}
-If you need to link a movie, use [[Template:imdb title]] instead.
+This template is used to generate an external link to a web page for a person in the [[IMDb|Internet Movie Database]]. It is intended for use in the [[Wikipedia:External links|external links]] section of an article.
-== Instructions ==
+: ''For a work (film/movie, TV or Web program/series, video game, etc.), use {{Tl|IMDb title}}.''
-# Copy and paste one of the options below into the article
+: ''For a specific TV episode or Web series episode, use {{Tl|IMDb episode}}.''
-# Go to http://www.imdb.com and search for the person you want
+: ''For an episode list, use {{Tl|IMDb episodes}}.''
-# Click on the correct link to go to the person's page; be sure you're getting the right person
+: ''For a company, use {{Tl|IMDb company}}.''
-# The page [[URL]] should look like <tt><nowiki>http://www.imdb.com/name/nm#######/</nowiki></tt>, where "<tt>#######</tt>" indicates a number
+: ''For an event, use {{Tl|IMDb event}}.''
-# Copy '''only''' that number—be sure to remove the "<tt>nm</tt>" and to keep all the zeros
-# Double-click "<tt>ID</tt>" in the string you pasted earlie and replace it with that number
-# As needed, double-click "<tt>Name</tt>" and replace it with the person's name as you want it to appear in the link
-=== Options ===
+== Usage ==
-This option needs just the ID number, it uses the article title as the link text:
+If the subject of the Wikipedia article is the same as the IMDb page, only ID number is required. The template then uses the Wikipedia article name as the [[anchor text]].
-<pre>
+* {{tlcw|{{BASEPAGENAME}} | <var>ID</var> }}
-* {{imdb name|ID}}
+* {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> }}
-</pre>
-Use the following option when you need to have the link text be other than the article name:
-: For example, {{imdb name|0596711| José Molina}} rather than {{imdb name|0596711| José Molina (writer)}}
+To have the link text be other than the article name, use second parameter. This is necessary when adding 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).
+* {{tlcw|{{BASEPAGENAME}} | <var>ID</var> | <var>NAME</var> }}
+* {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | name{{=}} <var>NAME</var> }}
-Note that you would always use this option when adding a link to an article other than the person whom you're linking
+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.
+* {{tlcw|{{BASEPAGENAME}} | <var>ID</var> | <var>NAME</var> | section{{=}} <var>SECTION</var> }}
+* {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | name{{=}} <var>NAME</var> | section{{=}} <var>SECTION</var>}}
-: 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 ID number may be omitted if the article's [[Wikidata]] item includes property {{Property|345}}.
-<pre>
+* {{tlcw|{{BASEPAGENAME}}}}
-* {{imdb name|ID|Name}}
+* {{tlcw|{{BASEPAGENAME}} | name{{=}} <var>NAME</var> }}
-</pre>
+* {{tlcw|{{BASEPAGENAME}} | name{{=}} <var>NAME</var> | section{{=}} <var>SECTION</var>}}
-Note that the options include the "<tt>*</tt>" for a bulleted list since this is most likely to be used in an "External links" section.
-=== Examples ===
-# Copy and paste one of the options above into the article
-# Go to http://www.imdb.com and search for "Jack Nicholson"; you'll reach this page: <tt>http://www.imdb.com/find?s=all&q=Jack+Nicholson</t>
-# Click on the correct Jack Nicholson in the list:
-##<tt>[http://www.imdb.com/name/nm0000197/ Jack Nicholson](Actor, [http://www.imdb.com/title/tt0073486/ One Flew Over the Cuckoo's Nest] (1975))</tt>
-# You then reach this page: <tt>http://www.imdb.com/name/nm0000197/</tt>
-# Copy "<tt>0000197</tt>", omitting the "<tt>nm</tt>"
-# Double-click on "<tt>ID</tt>" in the string and paste the number
-## For the first option above, just double-click "<tt>ID</tt>" and paste the number you found:
-##: <tt><nowiki>* {{imdb name|0000197}}</nowiki></tt> results in:
-##:* {{imdb name|0000197}}
-##:: Note that the link text is the same as the title of the article; since the link text should be the actor's name, use the second option
-## For the second option double-click "<tt>ID</tt>" and paste the number, then double-click "<tt>Name</tt>" and replace it with "<tt>Jack Nicholson</tt>"
-##: <tt><nowiki>* {{imdb name|0000197|Jack Nicholson}}</nowiki></tt> results in:
-##:* {{imdb name|0000197|Jack Nicholson}}
-If you still have any doubts or questions about the use of the template, go to the talk page for [[User:Kieff|Kieff]] | [[User talk:Kieff|Talk]] or [[User:Chidom|Chidom]] | [[User talk:Chidom|Talk]]
+== Instructions and examples ==
+{{See also|Wikipedia:External links/Perennial websites#IMDb}}
-<includeonly>
+# Go to [https://www.imdb.com/ IMDb.com] and search for the person you want (say, Marlon Brando; you'll reach <code>https://www.imdb.com/find?q=Marlon+Brando&s=all</code>). This can also be done on the Wikipedia page by previewing <code><nowiki>{{IMDb name}}</nowiki></code> and clicking that link ( https://www.imdb.com/find?q=Marlon+Brando&s=nm ).
-<!-- ADD CATEGORIES BELOW THIS LINE -->
+# Click on the correct name in the list (for the actor [[Marlon Brando]], this will bring up the page <code>https://www.imdb.com/name/nm0000008/</code>)
-[[Category:External link templates|Imdb name]]
+# Copy {{em|only}} the 7- or 8-digit number (here, "<code>0000008</code>"), omitting the "<code>nm</code>" but keep all the leading zeros.
-[[Category:Television templates|Imdb name]]
+# Replace "<code>ID</code>" in the template code with the number
-[[Category:Film templates|Imdb name]]
+## 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 name of the Wikipedia 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 }}
+## 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= awards }}</nowiki></code> gives:
+##:* {{IMDb name | 0000008 | Marlon Brando | section= awards }}
+##: <code><nowiki>* {{IMDb name | 0000008 | Marlon Brando | section= bio }}</nowiki></code> gives:
+##:* {{IMDb name | 0000008 | Marlon Brando | section= bio }}
-<!-- ADD INTERWIKIS BELOW THIS LINE -->
+== TemplateData ==
-[[bg:Шаблон:Imdb name]]
+{{TemplateData header}}
-[[da:Skabelon:Imdb navn]]
+<templatedata>
-[[de:Vorlage:IMDb Name]]
+{
-[[pt:Imdb nome]]
+ "description": "This template is used to generate an external link to a web page for a person in the Internet Movie Database.",
-[[es:Plantilla:Imdb nombre]]
+ "params": {
-[[fi:Malline:IMDb-h]]
+ "id": {
-[[fr:Modèle:Imdb name]]
+ "label": "ID",
-[[id:Templat:Imdb nama]]
+ "aliases": [ "1" ],
-[[it:Template:Imdb nome]]
+                        "description": "The IMDb ID for the target page. This parameter is optional if Wikidata property P345 contains an ID starting with nm, but required if not.",
-[[hu:Sablon:Imdb név]]
+                        "type": "number",
-[[nl:Sjabloon:IMDb naam]]
+                        "required": false,
-[[no:Mal:Imdb navn]]
+                        "default": "Wikidata property P345 or IMDb search URL"
-[[pl:Szablon:Imdb]]
+ },
-[[ru:Шаблон:Imdb name]]
+ "name": {
-[[sl:Template:Imdb name]]
+ "label": "Name",
-[[sv:Mall:Imdb namn]]
+ "aliases": ["2"],
-[[vi:Tiêu bản:Imdb name]]
+                        "description": "Name to be displayed as link text. Defaults to the Wikipedia article name, without any disambiguation such as (actor).",
-[[zh:Template:Imdb name]]
+                        "type": "string",
+                        "required": false,
+                        "default": "{{PAGENAMEBASE}}"
+ },
+ "section": {
+ "label": "Section",
+ "description": "IMDb article section. Set to \"award\" or \"awards\" to link to the awards section. Set to \"bio\" or \"biography\" to link to the biography section.",
+ "type": "string",
+ "required": false
+ }
+ }
+}
+</templatedata>
-</includeonly>
+== Tracking categories ==
+* {{clc|IMDb template with no id set}}
+* {{clc|IMDb template with invalid id set}}
+== See also ==
+* [[:Template:IMDb]], a list of related templates
+* [[Wikipedia:IMDb]]
+=== Similar person templates ===
+* {{Tl|AllMovie name}}
+* {{Tl|TCMDb name}}
+* {{tl|BFI}}
+<includeonly>{{Sandbox other||
+<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
+[[Category:Film external link templates]]
+[[Category:People and person external link templates]]
+[[Category:Television external link templates]]
+[[Category:Templates using data from Wikidata]]
+[[Category:Templates that add a tracking category]]
+[[Category:External link templates using Wikidata]]
+}}</includeonly>

Template:IMDb name/doc: Difference between revisions

Latest revision as of 04:34, 3 September 2020

Contents

Usage

Instructions and examples

TemplateData

Tracking categories

See also

Similar person templates

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools