Revision 5917739 of "Template:Tcmdb title/doc" on simplewiki

{{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}}-->

This template is used to generate an external link to a web page at the [[Turner Classic Movies|TCM]] Movie Database. It is based on the templates {{tl|IMDb title}} and {{tl|AllMovie title}}. [[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}} | ''ID'' <nowiki>}}</nowiki></code>
* <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | ''ID'' | ''TITLE'' <nowiki>}}</nowiki></code>
* <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | ''ID'' | ''TITLE'' | ''DESCRIPTION'' <nowiki>}}</nowiki></code>

Named parameters:
* <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= ''ID'' <nowiki>}}</nowiki></code>
* <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= ''ID'' | title= ''TITLE'' <nowiki>}}</nowiki></code>
* <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= ''ID'' | title= ''TITLE'' | description= ''DESCRIPTION'' <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."
# TCM 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>{{Hilite|######}}/Film-Name/</code>
#: or <code><nowiki>http://tcmdb.com/title/title.jsp?stid=</nowiki>{{Hilite|######}}</code>
#: where "<code>######</code>" indicates a number.
# Copy the ID number that appears after <code>/title/</code> or <code>stid=</code> in the URL listing.
# In the article you are editing, type <code><nowiki>{{Tcmdb title | id= </nowiki>{{Hilite|######}} | title= ''Film Name'' }}</code>.

== Example ==
# For ''[[Screaming Eagles (film)|Screaming Eagles]]'', the TCM Movie Database page URL is:
#: <code><nowiki>http://www.tcm.com/tcmdb/title/</nowiki>{{Hilite|26660}}/Screaming-Eagles/</code>
#: or <code><nowiki>http://tcmdb.com/title/title.jsp?stid=</nowiki>{{Hilite|26660}}</code>
# Copy <code>26660</code> and add it to this template, ''i.e.'':
#: <code><nowiki>{{Tcmdb title | id= 26660 | title= Screaming Eagles }}</nowiki></code>
#: or <code><nowiki>{{Tcmdb title | 26660 | Screaming Eagles }}</nowiki></code>
# This will display as:
#: {{Tcmdb title | 26660 | Screaming Eagles}}
# Use {{Para|description}} (or an unnamed third parameter) to display text after the film title:
#: <code><nowiki>{{Tcmdb title | id= 26660 | title= Screaming Eagles | description= (1956 film) }}</nowiki></code>
#: or <code><nowiki>{{Tcmdb title | 26660 | Screaming Eagles | (1956 film) }}</nowiki></code>
#: produces {{Tcmdb title | 26660 | Screaming Eagles | (1956 film) }}

==Template data==
{{TemplateDataHeader}}
<templatedata>
{
        "description": "This template is used to generate an external link to a web page at the TCM (Turner Classic Movies) Movie Database.",
        "params": {
                "id": {
                        "label": "ID",
                        "description": "ID number used in the URL of the title's page at the TCM Movie Database.",
                        "type": "number",
                        "required": true,
                        "aliases" : [ "1" ]
                },
                "title": {
                        "label": "Title",
                        "description": "Name of the title. If not specified it defaults to article's {{PAGENAME}}, without any disambiguation such as (film).",
                        "type": "string",
                        "required": false,
                        "aliases" : [ "2" ]
                },
                "description": {
                        "label": "Description",
                        "description": "Description of the title.",
                        "type": "string",
                        "required": false,
                        "aliases" : [ "3" ]
                }
        }
}
</templatedata>

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories go here and interwikis go in Wikidata. -->
[[Category:Television external link templates]]
[[Category:Film external link templates]]
}}</includeonly>