View source for Template:Metacritic film/doc

{{Documentation subpage}}
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata -->
{{High-use| 4,000 }}
{{Uses Wikidata|P1712}}
{{Tracks Wikidata|P1712}}
{{Lua|Module:EditAtWikidata|Module:WikidataCheck}}
{{for|inline prose|Template:MC film}}

'''{{NAMESPACE}}:{{BASEPAGENAME}}''' displays an external link to a web page for ''film title'' at the [[Metacritic]] website. It is intended for use in the [[Wikipedia:External links|external links]] section of an article.

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

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

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

== Instructions ==
# Go to [https://www.metacritic.com Metacritic.com] and search for the film title. Click on the correct link to go to the film's page. The [[URL]] should look like this:
#: <code><nowiki>https://</nowiki>www.metacritic.com/movie/{{Hilite|film-name}}/</code>
# Copy only the portion after <code>/movie/</code> and add one of the following to the '''External links''' section of the article:
#: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | <var>{{Hilite|film-name}}</var> }}</code>
#: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= <var>{{Hilite|film-name}}</var> }}</code>
#: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | <var>{{Hilite|film-name}}</var> | <var>Film Name</var> }}</code>
#: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= <var>{{Hilite|film-name}}</var> | title= <var>Film Name</var> }}</code>
#: where <code><var>film-name</var></code> is the film's unique ID string as copied from the URL
#: and <code><var>Film Name</var></code> is the title of the film (this is optional, if not specified it defaults to the Wikipedia article name).

== Examples ==

=== Unnamed parameters ===
; URL
: <kbd>[https://www.metacritic.com/movie/the-godfather/ https://www.metacritic.com/movie/{{Hilite|the-godfather}}/]</kbd>

; Usage
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | the-godfather | The Godfather <nowiki>}}</nowiki></code>

; Output
:* {{{{BASEPAGENAME}} | the-godfather | The Godfather }}

=== Named parameters ===
; URL
: <kbd>[https://www.metacritic.com/movie/the-terminator/ https://www.metacritic.com/movie/{{Hilite|the-terminator}}/]</kbd>

; Usage
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= the-terminator | title= The Terminator{{noitalic| (1984)}} <nowiki>}}</nowiki></code>

; Output
:* {{{{BASEPAGENAME}} | id= the-terminator | title= The Terminator{{noitalic| (1984)}} }}

=== 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 film title web page at the Metacritic website. 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 the-godfather in https://www.metacritic.com/movie/the-godfather/. This parameter is optional if Wikidata property P1712 exists, but required if not.",
                        "type": "string",
                        "default": "Wikidata property P1712",
                        "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.",
                        "type": "string",
                        "default": "{{PAGENAMEBASE}}",
                        "required": false
                }
	},
	"paramOrder": [
		"id",
		"title"
	]
}
</templatedata>

==Tracking categories==
The following are also used by {{tl|Metacritic album}}, {{tl|Metacritic television}} and {{tl|Metacritic video game}}:
* {{clc|Metacritic ID not in Wikidata}}
* {{clc|Metacritic ID different from Wikidata}}
* {{clc|Metacritic ID same as Wikidata}}

== See also ==
Similar film title templates:
* {{tl|IMDb title}}
* {{tl|AllMovie title}}
* {{tl|TCMDb title}}
* {{tl|AFI film}} 
* {{tl|Rotten Tomatoes}}
* {{tl|Mojo title}}

Other media:
*For a television series or made-for-TV movie, use {{tl|Metacritic television}}
*For a music album, use {{tl|Metacritic album}}
*For a video game, use {{tl|Metacritic video game}}

<includeonly>{{Sandbox other||
<!-- Categories below this line and interwikis at Wikidata -->
[[Category:Metacritic templates]]
[[Category:Film external link templates]]
[[Category:External link templates using Wikidata]]
[[Category:Templates that add a tracking category]]
}}</includeonly>