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: @@
 {{Documentation subpage}}
-<!--Categories where indicated at the bottom of this page, please; interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->
+{{High-use}}
-{{high-risk|100,000+}}
+<!-- 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}}
-This template is used to generate an external link to a web page for a person in the [[IMDb|Internet Movie Database]]. It should only be used in the "external links" section of an article.
+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.
 : ''For a work (film/movie, TV or Web program/series, video game, etc.), use {{Tl|IMDb title}}.''
@@ Line 10: / Line 11: @@
 : ''For an episode list, use {{Tl|IMDb episodes}}.''
 : ''For a company, use {{Tl|IMDb company}}.''
-: ''For a character, use {{Tl|IMDb character}}.''
+: ''For an event, use {{Tl|IMDb event}}.''
-: ''For an award, use {{Tl|IMDb award}}.''
-==Usage==
+== Usage ==
-{{See also|Wikipedia:External links/Perennial websites#IMDb}}
+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]].
+* {{tlcw|{{BASEPAGENAME}} | <var>ID</var> }}
+* {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> }}
-The '''required''' parameter is the ID number. The template then uses the article title as the [[anchor text]]:
+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).
-<pre>
+* {{tlcw|{{BASEPAGENAME}} | <var>ID</var> | <var>NAME</var> }}
-* {{IMDb name | ID }}
+* {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> | name{{=}} <var>NAME</var> }}
-* {{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 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).
+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>}}
-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.
+The ID number may be omitted if the article's [[Wikidata]] item includes property {{Property|345}}.
+* {{tlcw|{{BASEPAGENAME}}}}
+* {{tlcw|{{BASEPAGENAME}} | name{{=}} <var>NAME</var> }}
+* {{tlcw|{{BASEPAGENAME}} | name{{=}} <var>NAME</var> | section{{=}} <var>SECTION</var>}}
-*<code><nowiki>{{IMDb name | 0000008 | Marlon Brando | section= awards }}</nowiki></code> gives:
+== Instructions and examples ==
-:{{IMDb name | 0000008 | Marlon Brando | section= awards }}
+{{See also|Wikipedia:External links/Perennial websites#IMDb}}
-*<code><nowiki>{{IMDb name | 0000008 | Marlon Brando | section= bio }}</nowiki></code> gives:
-:{{IMDb name | 0000008 | Marlon Brando | section= bio }}
-==Detailed instructions==
+# 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 ).
-# Copy and paste one of the options above into the article
+# 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>)
-# Go to [http://www.imdb.com/ 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>)
+# Copy {{em|only}} the 7- or 8-digit number (here, "<code>0000008</code>"), omitting the "<code>nm</code>" but keep all the leading zeros.
-# 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 }}
+##:* {{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:
+##: 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 }}
-==TemplateData==
+== TemplateData ==
 {{TemplateData header}}
 <templatedata>
@@ Line 60: / Line 60: @@
  "label": "ID",
  "aliases": [ "1" ],
- "description": "The IMDb ID for the target page.",
+                        "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.",
- "type": "number",
+                        "type": "number",
- "required": true
+                        "required": false,
+                        "default": "Wikidata property P345 or IMDb search URL"
  },
  "name": {
  "label": "Name",
  "aliases": ["2"],
- "description": "Name that you want to have displayed. Defaults to article title.",
+                        "description": "Name to be displayed as link text. Defaults to the Wikipedia article name, without any disambiguation such as (actor).",
- "type": "string",
+                        "type": "string",
- "required": false
+                        "required": false,
+                        "default": "{{PAGENAMEBASE}}"
  },
  "section": {
@@ Line 81: / Line 83: @@
 </templatedata>
-== Tracking category ==
+== Tracking categories ==
-* {{clc|IMDb template with no id set}}, a hidden tracking category used by this template
+* {{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 templates:
+=== Similar person templates ===
 * {{Tl|AllMovie name}}
-* {{Tl|Tcmdb name}}
+* {{Tl|TCMDb name}}
-* {{Tl|thetvdb}}
+* {{tl|BFI}}
-<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
+<includeonly>{{Sandbox other||
-<!--Categories below this line, please; interwikis at Wikidata-->
+<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
 [[Category:Film external link templates]]
 [[Category:People and person external link templates]]

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