الگو:Television episode ratings/توضیحات

Usage

The purpose of the {{Television episode ratings}} template is to add a formatted ratings table to pages for television series, specifically either the main article, list of episodes article, or individual season articles, displaying the ratings for each episode of a season, for up to 50 episodes.

Syntax

{{Television episode ratings
| width         = NUMBER
| fontsize      = NUMBER

| hide_rs       = TEXT
| hide_viewers  = TEXT
| hide_dvr      = TEXT
| hide_dvrv     = TEXT
| hide_total    = TEXT
| hide_totalv   = TEXT
| refs_col      = TEXT

| title{1-50}   = TEXT
| date{1-50}    = DATE
| rs{1-50}      = NUMBER
| viewers{1-50} = NUMBER
| dvr{1-50}     = NUMBER
| dvrv{1-50}    = NUMBER
| total{1-50}   = NUMBER
| totalv{1-50}  = NUMBER
| ref{1-50}     = REFERENCE
| next{1-50}    = TEXT
}}

Examples

Basic example

Code

{{Television episode ratings | title1 = [[#ep1|Pilot]] | date1 = September 22, 2014 | rs1 = 3.2/9 | viewers1 = 13.83 | dvr1 = 1.8 | dvrv1 = 5.32 | total1 = 5.0 | totalv1 = 19.22 | title2 = [[#ep2|Single Point of Failure]] | date2 = September 29, 2014 | rs2 = 3.1/8 | viewers2 = 13.36 | dvr2 = 1.5 | dvrv2 = 4.56 | total2 = 4.6 | totalv2 = 17.94 | title3 = [[#ep3|A Cyclone]] | date3 = October 6, 2014 | rs3 = 2.6/7 | viewers3 = 12.05 | dvr3 = 1.3 | dvrv3 = 4.49 | total3 = 3.9 | totalv3 = 16.54 | title4 = [[#ep4|Shorthanded]] | date4 = October 13, 2014 | rs4 = 2.4/6 | viewers4 = 11.51 | dvr4 = 1.2 | dvrv4 = 4.18 | total4 = 3.6 | totalv4 = 15.69 }}

شماره	عنوان	تاریخ پخش	رتبه‌بندی (۱۸–۴۹)	بینندگان (میلیون)	DVR (۱۸–۴۹)	بینندگان DVR (میلیون)	مجموع (۱۸–۴۹)	مجموع بینندگان (میلیون)
1	«Pilot»	September 22, 2014	3.2/9	13.83	1.8	5.32	5.0	19.22
2	«Single Point of Failure»	September 29, 2014	3.1/8	13.36	1.5	4.56	4.6	17.94
3	«A Cyclone»	October 6, 2014	2.6/7	12.05	1.3	4.49	3.9	16.54
4	«Shorthanded»	October 13, 2014	2.4/6	11.51	1.2	4.18	3.6	15.69

Extra options

Hiding columns, Width, Font size, TBD & N/A cells, References, Multiple episodes

Code

{{Television episode ratings | width = 100 | fontsize = 90 | hide_rs = y | hide_dvr = y | hide_total = y | refs_col = y | title1 = [[#ep1|Pilot]] | date1 = September 22, 2014 | viewers1 = 13.83 | dvrv1 = 5.32 | totalv1 = 19.22 | ref1 = {{مرجع ساختگی|1}} | title2 = [[#ep2|Single Point of Failure]] | date2 = September 29, 2014 | viewers2 = 13.36 | dvrv2 = 4.56 | totalv2 = 17.94 | ref2 = {{مرجع ساختگی|2}} | title3 = [[#ep3|A Cyclone]] | date3 = October 6, 2014 | viewers3 = 12.05 | dvrv3 = 4.49 | totalv3 = 16.54 | ref3 = {{مرجع ساختگی|3}} | title4 = [[#ep4|Shorthanded]] | date4 = October 13, 2014 | dvrv4 = n/a | totalv4 = n/a | next4 = y }}

شماره	عنوان	تاریخ پخش	بینندگان (میلیون)	بینندگان DVR (میلیون)	مجموع بینندگان (میلیون)	منابع
1	«Pilot»	September 22, 2014	13.83	5.32	19.22
2	«Single Point of Failure»	September 29, 2014	13.36	4.56	17.94
3	«A Cyclone»	October 6, 2014	12.05	4.49	16.54
4/5	«Shorthanded»	October 13, 2014	TBD	—	—

Parameters

Parameter			Description	Type	Status
Width	Width	width	Width of the ratings table, as a percentage without the % sign, if it is required to be something other than the automatic width. Format: 100	Number	Optional
Font size	Font size	fontsize	Font size of the ratings table, as a percentage without the % sign, if it is required to be something other than the automatic size. Format: 100	Number	Optional
Toggle Columns	Rating/share	hide_rs	Whether or not to hide the Rating/share column, if it is not required. Format: y	Text	Optional
	Viewers	hide_viewers	Whether or not to hide the Viewers column, if it is not required. Format: y	Text	Optional
	DVR	hide_dvr	Whether or not to hide the DVR column, if it is not required. Format: y	Text	Optional
	DVR viewers	hide_dvrv	Whether or not to hide the DVR viewers column, if it is not required. Format: y	Text	Optional
	Total	hide_total	Whether or not to hide the Total column, if it is not required. Format: y	Text	Optional
	Total viewers	hide_totalv	Whether or not to hide the Total viewers column, if it is not required. Format: y	Text	Optional
	References	refs_col	Whether or not to show the unsortable ending References column, if it is required. Format: y	Text	Optional
Values	Title	title{1-50}	The title of the episode, linked to either its episode article or the listing in the episode table. Format: [[#ep1|Pilot]]	Link	Required
	Date	date{1-50}	The date that the episode originally aired, matching the date in the episode table. Format: September 22, 2014 Note: Using {{Start date}} does not allow for correct sorting of dates.	Date	Required
	Rating/share	rs{1-50}	The rating/share for the episode, sourced accordingly. Format: 3.2/9 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	Viewers	viewers{1-50}	The viewers (in millions) for the episode, sourced accordingly. Format: 13.83 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	DVR	dvr{1-50}	The DVR rating for the episode, sourced accordingly. Format: 1.8 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	DVR viewers	dvrv{1-50}	The DVR viewers for the episode, sourced accordingly. Format: 5.32 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	Total	total{1-50}	The total rating for the episode, sourced accordingly. Format: 5.0 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	Total viewers	totalv{1-50}	The total viewers for the episode, sourced accordingly. Format: 19.22 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	References	ref{1-50}	The reference for viewer values for the episode; they will only if the References column is included. Format: Typical reference	Reference	Optional
	Next episode	next{1-50}	Determine whether the ratings apply for two episodes under the same name, and if so, list the episode number as "x/x+1". Format: y Example: |next4=y will display the fourth episode's number as "4/5".	Text	Optional