View source for Template:TCMDb title/doc

{{Documentation subpage}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
<!-- {{Warning|At March 2011, it is known that the template is not working due to TCM's database's URLs changing. See a discussion about fixing the template [[Wikipedia talk:WikiProject Film/Archive 34#TCM_Movie_Database|here]].|date=March 2011}}-->
{{Template redirect|tcmdb title}}
{{High-use|demo={{ROOTPAGENAME}}}}
{{Uses Wikidata|P2631}}
{{Lua|Module:EditAtWikidata}}

'''{{NAMESPACE}}:{{BASEPAGENAME}}''' displays an external link to a web page for a film title at the [http://www.tcm.com/tcmdb/ TCM Movie Database] (TCMDb). It is intended for use in the [[Wikipedia:External links|external links]] section of an article.

[[Turner Classic Movies]] (TCM) maintains its own comprehensive database of motion picture titles that are not limited to the film libraries that TCM owns, and includes links by which a user can suggest to TCM that they schedule any given title for viewing.

This template is designed for links to film titles; to a link to a person use {{tl|TCMDb name}} instead.

== Usage ==
; Unnamed parameters
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | <var>ID</var> <nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | <var>ID</var> | <var>TITLE</var> <nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | <var>ID</var> | <var>TITLE</var> | <var>DESCRIPTION</var> <nowiki>}}</nowiki></code>

; Named parameters
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= <var>ID</var> <nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= <var>ID</var> | title= <var>TITLE</var> <nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= <var>ID</var> | title= <var>TITLE</var> | description= <var>DESCRIPTION</var> <nowiki>}}</nowiki></code>

; Using [[Wikidata]] property [[d:Property:P2631|P2631]]
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | title= <var>TITLE</var> <nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | title= <var>TITLE</var> | description= <var>DESCRIPTION</var> <nowiki>}}</nowiki></code>

== Instructions ==
# Visit the [http://www.tcm.com/tcmdb/ TCM Movie Database].
# In the keyword search field, type in the title you want to link to, and click "Search."
# TCMDb will show a disambiguation page showing all titles that match your search words. Click on the title you want (make sure you have the correct year of release!).
# The page [[URL]] should look like this:
#: <code><nowiki>http://www.tcm.com/tcmdb/title/</nowiki>{{Highlight|######}}/film-name</code>
#: where "<code>######</code>" indicates a number.
# Copy the ID number that appears after <code>/title/</code> in the URL.
# In the article you are editing, type <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= {{Highlight|######}} | title= ''Film Name'' <nowiki>}}</nowiki></code>.

== Examples ==

=== Unnamed parameters ===
; Usage
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | 26660 | Screaming Eagles <nowiki>}}</nowiki></code>
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | 26660 | Screaming Eagles | (1956 film) <nowiki>}}</nowiki></code>

; Output
:* {{{{BASEPAGENAME}} | 26660 | Screaming Eagles }}
:* {{{{BASEPAGENAME}} | 26660 | Screaming Eagles | (1956 film) }}

; Current URLs
: [https://www.tcm.com/tcmdb/title/26660/screaming-eagles https://www.tcm.com/tcmdb/title/{{Highlight|26660}}/screaming-eagles]
: [https://www.tcm.com/tcmdb/title/26660/Screaming-Eagles/ https://www.tcm.com/tcmdb/title/{{Highlight|26660}}/Screaming-Eagles/] (redirect)
: [https://www.tcm.com/tcmdb/title/26660/- https://www.tcm.com/tcmdb/title/{{Highlight|26660}}/-] (redirect)

; Former URLs
: http://<nowiki/>www.tcm.com/tcmdb/title/title.jsp?stid={{Highlight|26660}}
: http://<nowiki/>tcmdb.com/title/title.jsp?stid={{Highlight|26660}}
: http://<nowiki/>www.tcm.turner.com/title/title.jsp?stid={{Highlight|26660}}
: http://<nowiki/>www.tcm.turner.com/tcmdb/title/title.jsp?stid={{Highlight|26660}}

=== Named parameters ===
; Usage
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= 68177 | title= Batman <nowiki>}}</nowiki></code>
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= 68177 | title= Batman | description= (1966 film) <nowiki>}}</nowiki></code>

; Output
:* {{{{BASEPAGENAME}} | id= 68177 | title= Batman }}
:* {{{{BASEPAGENAME}} | id= 68177 | title= Batman | description= (1966 film) }}

; Current URLs
: [https://www.tcm.com/tcmdb/title/68177/batman https://www.tcm.com/tcmdb/title/68177/batman]
: [https://www.tcm.com/tcmdb/title/68177/Batman/ https://www.tcm.com/tcmdb/title/{{Highlight|68177}}/Batman/] (redirect)
: [https://www.tcm.com/tcmdb/title/68177/- https://www.tcm.com/tcmdb/title/68177/-] (redirect)

; Former URLs
: http://<nowiki/>www.tcm.com/tcmdb/title/title.jsp?stid={{Highlight|68177}}
: http://<nowiki/>tcmdb.com/title/title.jsp?stid={{Highlight|68177}}
: http://<nowiki/>www.tcm.turner.com/title/title.jsp?stid={{Highlight|68177}}
: http://<nowiki/>www.tcm.turner.com/tcmdb/title/title.jsp?stid={{Highlight|68177}}

=== No ID in template or Wikidata ===
; Usage
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>

; Output
: {{ {{BASEPAGENAME}} }}

==TemplateData==
{{TemplateData header}}
<templatedata>
{
        "description": "This template displays an external link to a web page for a film title at the TCM Movie Database (TCMDb). It is intended for use in the external links section of an article.",
        "params": {
                "id": {
                        "aliases" : [ "1" ],
                        "label": "ID",
                        "description": "The ID portion of the URL, such as 26660 in https://www.tcm.com/tcmdb/title/26660/screaming-eagles. This parameter is optional if Wikidata property P2631 exists, but required if not.",
                        "default": "Wikidata property P2631",
                        "type": "number",
                        "required": false
                },
                "title": {
                        "aliases" : [ "2" ],
                        "label": "Title",
                        "description": "The film title, which is displayed in italic type in the link text. This parameter is optional; it defaults to the Wikipedia article name, without any disambiguation such as \"(film)\".",
                        "default": "{{PAGENAMEBASE}}",
                        "type": "string",
                        "required": false
                },
                "description": {
                        "aliases" : [ "3" ],
                        "label": "Description",
                        "description": "May be used to specify a description of the title, which is displayed after the title in the link text.",
                        "type": "string",
                        "required": false
                }
	},
	"paramOrder": [
		"id",
		"title",
		"description"
	]
}
</templatedata>

== See also ==
Other TCMDb templates:
* {{tl|TCMDb name}}

Similar film title templates:
* {{tl|IMDb title}}
* {{tl|AllMovie title}}
* {{tl|AFI film}}
* {{tl|Rotten Tomatoes}}
* {{tl|Metacritic film}}
* {{tl|Mojo title}}

<includeonly>{{Sandbox other||
<!-- Categories go here and interwikis go in Wikidata. -->
[[Category:Television external link templates]]
[[Category:Film external link templates]]
[[Category:External link templates using Wikidata]]
}}</includeonly>