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}}.''
-# Go to [http://www.imdb.com imdb.com] and search for the person you want
+: ''For a specific TV episode or Web series episode, use {{Tl|IMDb episode}}.''
-# Click on the correct link to go to the person's page. Be sure you're getting the right person
+: ''For an episode list, use {{Tl|IMDb episodes}}.''
-# The page [[URL]] should look like <nowiki>http://www.imdb.com/name/nm#######</nowiki>, where "#######" indicates a number.
+: ''For a company, use {{Tl|IMDb company}}.''
-# Copy ONLY that number (be sure to remove the "nm" and to keep all the zeros)
+: ''For an event, use {{Tl|IMDb event}}.''
-# Add to the external links section the text:
-:<nowiki>{{imdb name|id=#######|name=Name}}</nowiki>
-:where "#######" is the number you've copied, and "Name" is the person's name
-==Example==
+== Usage ==
-#Searching for "Jack Nicholson", you'll reach this page: http://www.imdb.com/name/nm0000197/
+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]].
-#Copy "0000197" and then write:
+* {{tlcw|{{BASEPAGENAME}} | <var>ID</var> }}
-:<nowiki>{{imdb name|id=0000197|name=Jack Nicholson}}</nowiki>
+* {{tlcw|{{BASEPAGENAME}} | id{{=}} <var>ID</var> }}
-The result is {{imdb name|id=0000197|name=Jack Nicholson}}
-Note that, since this will almost certainly go on the external link section, you should add a * before the template text to include it as a list item.
+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> }}
-If you still have any doubts or questions about the use of the template, go to my talk page [[User:Kieff|<nowiki></nowiki>]] &mdash; [[User:Kieff|Kieff]] | [[User talk:Kieff|Talk]] 03:45, Sep 13, 2004 (UTC)
+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>}}
-<pre>
+The ID number may be omitted if the article's [[Wikidata]] item includes property {{Property|345}}.
-* {{Imdb name|ID|Name}} <!-- ID is just the number, don't include the "nm" -->
+* {{tlcw|{{BASEPAGENAME}}}}
-</pre>
+* {{tlcw|{{BASEPAGENAME}} | name{{=}} <var>NAME</var> }}
-I've added this version that's easy to copy and paste. You can copy the entire line including the editor's comment between the <tt><nowiki><!--</nowiki></tt> and <tt><nowiki> --></nowiki></tt>—it won't show when the page is saved. That's not required, of course, you can just copy through the closing (<tt><nowiki>}}</nowiki></tt> brackets):
+* {{tlcw|{{BASEPAGENAME}} | name{{=}} <var>NAME</var> | section{{=}} <var>SECTION</var>}}
-Once you've copied and pasted the code; just double-click the "ID" and "Name" to replace them with the actual information.
-Hope this is helpful. Thanks. <font color="721227">&mdash;</font>[[User:Chidom|<font color="DC5300">'''Chidom'''</font>]]&nbsp;[[User talk:Chidom|<font color="721227"><sup>'''talk'''</sup></font>]]&nbsp; 21:35, 30 December 2006 (UTC)
+== 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",
-[[vi:Tiêu bản:Imdb name]]
+ "aliases": ["2"],
-[[zh:Template:Imdb name]]
+                        "description": "Name to be displayed as link text. Defaults to the Wikipedia article name, without any disambiguation such as (actor).",
+                        "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