Bản mẫu:Rotten Tomatoes data/doc

Đối với citations, xem {{Cite Rotten Tomatoes}}. Đối với external links, xem {{Rotten Tomatoes}}. Đối với inline prose, xem {{Rotten Tomatoes prose}}.

Rotten Tomatoes data retrieves (the most recent) Rotten Tomatoes data from Wikidata. Currently available only for movies.

For this template to work properly, the Wikidata item to be accessed should have Rotten Tomatoes data available, e.g. as shown here.

Usage

{{Rotten Tomatoes data|command|qid=...}}
{{Rotten Tomatoes data|command|title=...}}

Command options are described in § Examples. The optional parameter qid should be the Q-identifier of the Wikidata item to be accessed, e.g. Q943338. Alternatively, one can use the parameter title which should be the title of the Wikipedia article whose connected Wikidata item is to be accessed, e.g. American Psycho (film). By default, when neither qid nor title are provided, the item connected to the current article is accessed.

For this template to work properly, the Wikidata item to be accessed should have Rotten Tomatoes data available, e.g. as shown here. An error message is produced for missing data. See Wikipedia:Wikidata § Access_from_Wikipedia for how to access the Wikidata item connected to an article.

Examples

In the following examples we use the film Hitch which has a corresponding Wikidata item (Q943338).

• The score command produces the Tomatometer score.
  • {{Rotten Tomatoes data|score|qid=Q943338}} ⇒ 69%
• The title of a Wikipedia article can be given instead of qid.
  • {{Rotten Tomatoes data|score|title=Hitch (film)}} ⇒
• The count command produces the number of critic reviews. The parameter spell can be used to apply {{Spellnum per MOS}} to the count.
  • {{Rotten Tomatoes data|count|qid=Q943338}} ⇒ 188
  • {{Rotten Tomatoes data|count|spell=y|title=Meadowland (film)}} ⇒
• The average command produces the average rating.
  • {{Rotten Tomatoes data|average|qid=Q943338}} ⇒ 6.3/10
• The table command is convenient for use in tables to provide a quick overview of a score and reviews.
  • {{Rotten Tomatoes data|table|qid=Q943338}} ⇒ 69% (188 reviews)
• The access date (or accessdate or access-date) command produces the ngày truy cập (P813) date from the reference if it exists, and otherwise produces the thời điểm (P585) if it exists.
  • {{Rotten Tomatoes data|access date|qid=Q943338}} ⇒ tháng 9 ngày 14, 2021
  • {{Rotten Tomatoes data|access date|df=dmy|qid=Q943338}} ⇒ 14/9/2021
  • {{Rotten Tomatoes data|access date|df=ymd|qid=Q943338}} ⇒ 2021 tháng 9 ngày 14
  • {{Rotten Tomatoes data|access date|df=iso|qid=Q943338}} ⇒ 2021-09-14
• The date command produces the thời điểm (P585) if it exists, and otherwise produces the ngày truy cập (P813) date from the reference if it exists. Use the access date command for citations. The date command exists mostly in case the thời điểm (P585) differs from the ngày truy cập (P813) date for some reason.
  • {{Rotten Tomatoes data|date|qid=Q943338}} ⇒ tháng 9 ngày 14, 2021
• The as of (or asof) command wraps the template {{As of}}, except that any values given for the year, month, and day parameters are converted to the corresponding value from the date command.
  • {{Rotten Tomatoes data|as of|year|month|day|qid=Q943338}} ⇒ Tính đến ngày 14 tháng 9 năm 2021
  • {{Rotten Tomatoes data|as of|y|m|d|lc=y|df=us|qid=Q943338}} ⇒ tính đến ngày 14 tháng 9 năm 2021
  • {{Rotten Tomatoes data|as of|a|b|lc=y|df=us|qid=Q943338}} ⇒ tính đến tháng 9 năm 2021
• The prose command produces the result of the template {{Rotten Tomatoes prose}} with autofilled parameters.
  • {{Rotten Tomatoes data|prose|qid=Q943338}} ⇒ Trên trang web tổng hợp đánh giá Rotten Tomatoes, 69% trong số 188 bài phê bình được xác định là tích cực, với điểm trung bình là 6.3/10.
• The rtid command produces the item's Rotten Tomatoes (P1258) value.
  • {{Rotten Tomatoes data|rtid|qid=Q943338}} ⇒ m/hitch
  • {{Rotten Tomatoes data|rtid|noprefix=y|qid=Q943338}} ⇒ hitch
• The url command produces the full Rotten Tomatoes URL using the item's Rotten Tomatoes (P1258) value and the property's formatter URL.
  • {{Rotten Tomatoes data|url|qid=Q943338}} ⇒ https://www.rottentomatoes.com/m/hitch
• The edit command wraps the template {{EditAtWikidata}}, linking to pid=P444.
  • {{Rotten Tomatoes data|edit|qid=Q943338}} ⇒

Error detection

Certain errors are reported for missing/faulty parameters and data. For example:

• {{Rotten Tomatoes data|count}} ⇒
• {{Rotten Tomatoes data|count|title=Apple Apple Apple}} ⇒
• {{Rotten Tomatoes data|score|qid=Q2}} ⇒

TemplateData

Đây là tài liệu Dữ liệu bản mẫu cho bản mẫu này được sử dụng bởi Trình soạn thảo trực quan và các công cụ khác; xem báo cáo sử dụng tham số hàng tháng cho bản mẫu này.

Dữ liệu bản mẫu cho Rotten Tomatoes data

Retrieves Rotten Tomatoes data from Wikidata. Currently available only for movies. For this template to work properly, the Wikidata item to be accessed should have Rotten Tomatoes data available.

Tham số		Miêu tả	Kiểu	Trạng thái
Command	1	Command which tells this template what value to return. For usage examples and explanations, see the full documentation at "Template:Rotten Tomatoes data/doc". The "score" command returns the Tomatometer score, e.g. 99%. The "count" command returns the number of reviews, e.g. 112. The "average" command returns the average rating, e.g. 5.5/10. The "table" command returns the score and count in the format "XX% (YYY reviews)". The "rtid" command returns the Rotten Tomatoes ID, e.g. m/titanic. The "url" command returns the url, e.g. https://www.rottentomatoes.com/m/titanic. The "date" command returns the date on which the Tomatometer score was accurate, e.g. October 1, 2021. The "access date" command returns the date on which the Tomatometer score was retrieved and added to Wikidata, e.g. October 1, 2021. The "as of" command turns the rest of this template into a wrapper for "Template:As of" and returns the result of that template, except that any values given for the year, month, or day are converted to the corresponding value from the "date" command. The "prose" command returns the result of "Template:Rotten Tomatoes prose" with autofilled parameters. The "edit" command returns the result of "Template:EditAtWikidata", linked to property P444. Giá trị đề nghị score count average rtid url date access date as of prose edit Ví dụ score	Chuỗi dài	bắt buộc
Date format	df	Date format for the "date" and "access date" commands. Options are "mdy" (May 4, 2021), "dmy" (4 May 2021), "iso" (2021-05-04), and "ymd" (2021 May 4). If omitted, the "mdy" format is used. Giá trị đề nghị mdy dmy iso ymd Mặc định mdy Ví dụ dmy	Chuỗi dài	tùy chọn
No prefix for rtid	noprefix	Removes the Rotten Tomatoes ID prefix (e.g. "m/") when used with the "rtid" command. Give this parameter any value to remove the prefix. Giá trị đề nghị y yes true Ví dụ y	Chuỗi dài	tùy chọn
Spell out the count	spell	Wraps the count with "Template:Spellnum per MOS" when used with the "count" command. Give this parameter any value to activate the wrapping. Giá trị đề nghị y yes true Ví dụ y	Chuỗi dài	tùy chọn
Wikidata Q-identifier	qid	Q-identifier of the Wikidata item to be accessed. If both "qid" and "title" are omitted, the item connect to the current page is accessed. Only one of the parameters "qid" and "title" should be used. Ví dụ Q943338	Chuỗi dài	tùy chọn
Title of article	title	Title of the Wikipedia article whose connected Wikidata item is to be accessed. If both "qid" and "title" are omitted, the item connect to the current page is accessed. Only one of the parameters "qid" and "title" should be used. Ví dụ Black Widow (2021 film)	Chuỗi dài	tùy chọn