Jump to content

Template:Television season ratings/doc

From Wikipedia, the free encyclopedia

Usage

[edit]

The purpose of the {{Television season ratings}} template is to add a formatted ratings table to pages for television series, specifically the main article, displaying the timeslots, ratings and similar information for each season, for up to 50 seasons.

Syntax

[edit]
{{Television season ratings
| title                     = TEXT
| multiseries               = TEXT
| width                     = NUMBER

| series{1-50}              = TEXT
| series_length{1-50}       = TEXT
| n{1-50}                   = TEXT
| link{1-50}                = TEXT
| timeslot{1-50}            = TEXT
| timeslot_length{1-50}     = TEXT
| network{1-50}             = TEXT
| network_length{1-50}      = TEXT
| episodes{1-50}            = NUMBER
| start{1-50}               = DATE
| startrating{1-50}         = NUMBER
| end{1-50}                 = DATE
| endrating{1-50}           = NUMBER
| season{1-50}              = NUMBER
| rank{1-50}                = NUMBER
| viewers{1-50}             = NUMBER
| 18_49_rank{1-50}          = NUMBER
| 18_49_rating{1-50}        = NUMBER
| references{1-50}          = REFERENCE(S)

| season_length{1-50}       = TEXT
| rank_length{1-50}         = TEXT
| viewers_length{1-50}      = TEXT
| 18_49_rank_length{1-50}   = TEXT
| 18_49_rating_length{1-50} = TEXT
| references_length{1-50}   = TEXT

| hide_timeslot             = TEXT
| hide_tv_season            = TEXT
| hide_viewers              = TEXT
| hide_rank                 = TEXT
| hide_18_49_rank           = TEXT
| hide_18_49_rating         = TEXT
| hide_FLratings            = TEXT
| show_caption              = TEXT
| show_network              = TEXT
| show_references           = TEXT
| timezone                  = TEXT
| unit                      = TEXT
| nolink                    = TEXT
}}

Example

[edit]
Code
{{Television season ratings
| title            = Show

| link1            = Main Page
| timeslot1        = Monday 10 p.m.
| timeslot_length1 = 2
| episodes1        = 13
| start1           = {{Start date|2013|6|24}}
| startrating1     = 13.53
| end1             = {{End date|2013|9|16}}
| endrating1       = 12.10
| season1          = 2012–13
| rank1            = 50
| viewers1         = 11.19
| 18_49_rank1      = 4
| 18_49_rating1    = 2.7/8

| link2            = Main Page
| episodes2        = 13
| start2           = {{Start date|2014|6|30}}
| startrating2     = 9.41
| end2             = {{End date|2014|9|22}}
| endrating2       = 7.52
| season2          = 2013–14
| rank2            = 76
| viewers2         = 7.17
| 18_49_rank2      = 9
| 18_49_rating2    = 1.6/5

| link3            = Main Page
| timeslot3        = Thursday 9 p.m.
| episodes3        = 13
| start3           = {{Start date|2015|6|25}}
| startrating3     = 6.25
| end3             = {{End date|2015|9|10}}
| endrating3       = 4.23
| season3          = 2014–15
| rank3            = 43
| viewers3         = 4.70
| 18_49_rank3      = 10
| 18_49_rating3    = 1.0/4
}}
Viewership and ratings per season of Show
Season Timeslot (ET) Episodes First aired Last aired TV season Viewership
rank
Avg. viewers
(millions)
18–49
rank
Avg. 18–49
rating
Date Viewers
(millions)
Date Viewers
(millions)
1 Monday 10 p.m. 13 June 24, 2013 (2013-06-24) 13.53 September 16, 2013 (2013-09-16) 12.10 2012–13 50 11.19 4 2.7/8
2 13 June 30, 2014 (2014-06-30) 9.41 September 22, 2014 (2014-09-22) 7.52 2013–14 76 7.17 9 1.6/5
3 Thursday 9 p.m. 13 June 25, 2015 (2015-06-25) 6.25 September 10, 2015 (2015-09-10) 4.23 2014–15 43 4.70 10 1.0/4

Parameters

[edit]
Parameter Description Type Status
Title title The title of the series in the table's caption, which uses {{Screen reader-only}} to not be displayed in a browser but be voiced by a screen reader, defaults to the page name. Set this parameter (in plain text) to change the series' title if it should not be the page name.
Format: Text
Text Optional
Multi-Series multiseries Set to include the "Series" column, for producting a table with multiple series.
Format: y
Text Optional
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
Values Series series{1-50} Use it |multiseries= is set, to include the linked series title.
Format: Arrow
Text/Link Optional
Series Length series_length{1-50} Use if |multiseries= and |series= are set, to determine the rowspan of the linked series title. Include even if it is set to 1.
Format: 8
Number Optional
Number n{1-50} Customizable season number to change from the default automatically incrementing number, useful for multiple series where the season number is not the same as the parameter number.
Format: 8
Number Optional
Link link{1-50} The link to the season's ratings table on the episodes page if available, without square brackets, where more detailed information is available.
Format: List of The 100 episodes#Season 1
Text Optional
Timeslot timeslot{1-50} The timeslot for the season in question, including the day of the week and hour.
Format: Wednesday 9:00 pm
Text Optional
Timeslot Length timeslot_length{1-50} How many consecutive seasons that the series has stayed in the same timeslot for.
Format: 2
Exclusion: 1
Number Optional
Network network{1-50} The Network for the season in question.
Format: CBS
Text Optional
Network Length network_length{1-50} How many consecutive seasons that the series has stayed on the same Network.
Format: 2
Exclusion: 1
Number Optional
Episodes episodes{1-50} The number of episodes included in the season in question. The count is for the total episodes, rather than how many have aired.
Format: 16
Exclusion: TBA
Number Optional
Start date start{1-50} The start date for the entire season in question; this is, the air date of the premiere episode. A start date is required for the row to display.
Format: {{Start date|2014|03|19}}
Exclusion: TBA
Date Required
Premiere viewers startrating{1-50} The viewers for the premiere of the season in millions, sourced accordingly; this should be the same value that is displayed in the season's episode table for the episode.
Format: 2.73
Exclusion: TBD
Number Optional
End date end{1-50} The end date for the entire season in question; this is, the air date of the finale episode.
Format: {{End date|2014|06|11}}
Exclusion: TBA
Date Optional
Finale viewers endrating{1-50} The viewers for the finale of the season in millions, sourced accordingly; this should be the same value that is displayed in the season's episode table for the episode.
Format: 2.73
Exclusion: TBD
Number Optional
TV season season{1-50} The television season of the season in question. This should only be in the format "2015–16", so that it directly links to 2015–16 United States network television schedule, for example. It will not automatically link if |nolink= is set.
Format: 2015–16
Numbers Required
Rank rank{1-50} The official rank released by the network for the entire season compared to other series, sourced accordingly.
Format: 150
Exclusion: TBD
Number Optional
Viewers viewers{1-50} The official average viewers released by the network for the entire season, sourced accordingly.
Format: 2.59
Exclusion: TBD
Number Optional
18–49 rank 18_49_rank{1-50} The official 18–49 rank released by the network for the entire season, sourced accordingly.
Format: 2.59
Exclusion: TBD
Number Optional
18–49 rating 18_49_rating{1-50} The official 18–49 rating released by the network for the entire season, sourced accordingly.
Format: 2.59
Exclusion: TBD
Number Optional
References references{1-50} A column dedicated to listing references.
Format: {{cite web}}
Exclusion: N/A
Reference Optional
Span
Columns
Season season_length{1-50} The rowspan of the season_length column. Set to a number for the first season, and set corresponding seasons to hide.
Example format: 3 for Season 1, hide for Season 2 and Season 3.
Number/Text Optional
Rank rank_length{1-50} The rowspan of the rank_length column. Set to a number for the first season, and set corresponding seasons to hide.
Example format: 3 for Season 1, hide for Season 2 and Season 3.
Number/Text Optional
Viewers viewers_length{1-50} The rowspan of the viewers_length column. Set to a number for the first season, and set corresponding seasons to hide.
Example format: 3 for Season 1, hide for Season 2 and Season 3.
Number/Text Optional
18–49 rank 18_49_rank_length{1-50} The rowspan of the 18_49_rank_length column. Set to a number for the first season, and set corresponding seasons to hide.
Example format: 3 for Season 1, hide for Season 2 and Season 3.
Number/Text Optional
18–49 rating 18_49_rating_length{1-50} The rowspan of the 18_49_rating_length column. Set to a number for the first season, and set corresponding seasons to hide.
Example format: 3 for Season 1, hide for Season 2 and Season 3.
Number/Text Optional
References references_length{1-50} The rowspan of the references column. Set to a number for the first season, and set corresponding seasons to hide.
Example format: 3 for Season 1, hide for Season 2 and Season 3.
Number/Text Optional
Toggle
Columns
Timeslot hide_timeslot Whether or not to hide the Timeslot column, if it is not required (e.g. for shows that frequently change timeslots).
Format: y
Text Optional
TV season hide_tv_season Whether or not to hide the TV season column, if it is not required (e.g. for shows on kids' channels such as Disney/Nickelodeon).
Format: y
Text Optional
Viewers hide_viewers Whether or not to hide the Viewership column, if it is not required (e.g. for shows on kids' channels such as Disney/Nickelodeon).
Format: y
Text Optional
Viewership rank hide_rank Whether or not to hide the Viewership rank column, if it is not required (e.g. for shows on kids' channels such as Disney/Nickelodeon).
Format: y
Text Optional
18–49 rank hide_18_49_rank Whether or not to hide the 18–49 rank column, if it is not required.
Format: y
Text Optional
Avg. 18–49 rating hide_18_49_rating Whether or not to hide the Avg. 18–49 rating column, if it is not required.
Format: y
Text Optional
Avg. First/last aired ratings hide_FLratings Whether or not to hide the ratings for the first/last aired columns, if it is not required. Setting this will condense the header row further when it hide the relevant cells.
Format: y
Text Optional
Show Caption show_caption Whether or not to show the table's caption, if it is not placed immediately below a heading, where the heading is effectively identical to the table's caption.
Format: y
Text Optional
Show Network show_network Whether or not to show the Network column, if it is required.
Format: y
Text Optional
Show References show_references Whether or not to show the References column, if it is required.
Format: y
Text Optional
Timezone timezone The timezone of all of the timeslots for the series.
Format: [[Eastern Time Zone|ET]]
Exclusion: ET
Text/Link Optional
Unit unit The unit override for the Viewers column header.
Format: (thousands)
Exclusion: (millions)
Hide:  
Text Optional
No link nolink If set, it will allow the season column to be linked manually, or simply plain text.
Format: y
Text Optional