Template:Highest-grossing films franchise

From blackwiki
Jump to navigation Jump to search
Template documentation[view] [edit] [history] [purge]

This template generates a table entry for the franchise chart at List of highest-grossing films. Each entry contains a collapsible table for the franchise, which when expanded will display the films included in the franchise. A franchise may contain more than one series, which when expanded will show an entry for each series. Each series included in the franchise will also be a collapsible table which when expanded will show the films in the series.

Parameters

typefranchise/series/film default: series; selects the type of table entry.
subyes; indicates whether the entry is a sub-table. Initiates the yellow shading for sub-tables.
stateexpanded/collapsed; a series sub-table is in a collapsed state by default, but this flag permits editors to override the default setting.
rank1/2/3...etc; position in chart.
title – title of the franchise/series.
total1000000000; the total gross of the franchise/series. This is automated for series, but has to be manually set for franchises. Enter the number as a raw figure, the template will format it i.e. 1000000 will format to i.e. $1,000,000
totalnote – sometimes it is necessary to include a source for the data; totalnote accompanies total in the table.
number – the number of films in the franchise series. This parameter along with "total" needs to be set to calculate the average for the franchise/series.
highest – the highest grossing film in the series franchise i.e. Foo
gross – the gross of the highest grossing film in the series. For example, if you set "highest" to Foo, then "gross" can be set to 1000000.
currency – the currency unit is $ by default but can be manually set i.e. £
releaseyes/01/02/03/.../48/49//50 etc; indicates whether the franchise/series is currently in release. Initiates the green shading commonly seen in the table. You can shade any franchise/series entry, and up to two individual films. Stipulating an entry number will add shading to the entry that correlates to that number in the table i.e. the number "03" will add shading to the third entry in the table, while "01/03" will add shading to the first and third entries. The leading zero is necessary for entry codes less than 10.

Usage

Series

The most common form of franchise entry is a series. This may be a sequence of films that share a continuity or a production background. An example of this would be the rebooted Batman series; as can be seen in the example, the total and average are calculated automatically. The total can be set manually by setting the "total" parameter, and blue highlighting can be added by setting the "release" parameter:

Highest-grossing film series (The films in each franchise can be viewed by selecting "show".)
Rank Series Total worldwide gross No. of films Average of films Highest-grossing film
{{Highest-grossing films franchise |rank=1|title=[[Batman in film#Christopher Nolan trilogy|Batman (reboot series)]]|total=|number=2|highest=[[The Dark Knight (film)|The Dark Knight]]|gross=1001921825|release=
<!--GROSSES-->
|[[The Dark Knight (film)|The Dark Knight]]
|1001921825
|[[Batman Begins]]
|372710015	
}}

Franchise

A franchise may contain several series. In the case of the Batman franchise, there are three distinct series that have been exhibited theatrically: the Nolan series, the 1989–1997 series, and the animated series which included just a single film. In the example below, "type" is set to "series" for the series that contain multiple films, and to "film" for the animated series, while it is set to "franchise" for the main table entry. The "series" and "film" distinction turns off the collapsible mode which is not needed for series that contain just a single film. The totals for each series are calculated automatically, but an editor must enter the overall franchise total:

Highest-grossing film series (The films in each franchise can be viewed by selecting "show".)
Rank Series Total worldwide gross No. of films Average of films Highest-grossing film
{{Highest-grossing films franchise |type=franchise|rank=1|title=[[Batman in film]]|total={{#expr:1374631840+1252907544+5617391}}|number=7|highest=[[The Dark Knight (film)|The Dark Knight]]|gross=1001921825

|{{Highest-grossing films franchise |type=series|sub=y|title=[[Batman in film#Christopher Nolan trilogy|Batman (reboot series)]]|total=|number=2|highest=[[The Dark Knight (film)|The Dark Knight]]|gross=1001921825
<!--GROSSES-->
|[[The Dark Knight (film)|The Dark Knight]]
|1001921825
|[[Batman Begins]]
|372710015	
}}

|{{Highest-grossing films franchise |type=series|sub=y|title=[[Batman in film#Tim Burton / Joel Schumacher series|Batman (original series)]]|total=|number=4|highest=[[Batman (1989 film)|Batman]]|gross=411348924
<!--GROSSES-->
|[[Batman (1989 film)|Batman]]
|411348924
|[[Batman Forever]]
|336529144		
|[[Batman Returns]]
|266822354	
|[[Batman & Robin (film)|Batman & Robin]]
|238207122	
}}

|{{Highest-grossing films franchise |type=film|sub=y|title=[[Batman: Mask of the Phantasm]]|total=5617391}}

}}

Sub-franchises

A franchise isn't restricted to just containing series, it can also contain sub-franchises, which in turn can include series or further sub-franchises. This is done by setting "type" to "franchise" in the franchise sub-table. This will be a rare scenario for most series, but can be used to add further organisation to franchises. Taking the Batman franchise example, it may be desirable to break the original series down by director:

Highest-grossing film series (The films in each franchise can be viewed by selecting "show".)
Rank Series Total worldwide gross No. of films Average of films Highest-grossing film
{{Highest-grossing films franchise |type=franchise|rank=1|title=[[Batman in film]]|total={{#expr:1374631840+1252907544+5617391}}|number=7|highest=[[The Dark Knight (film)|The Dark Knight]]|gross=1001921825

|{{Highest-grossing films franchise |type=series|sub=y|title=[[Batman in film#Christopher Nolan trilogy|Batman (reboot series)]]|total=|number=2|highest=[[The Dark Knight (film)|The Dark Knight]]|gross=1001921825
<!--GROSSES-->
|[[The Dark Knight (film)|The Dark Knight]]
|1001921825
|[[Batman Begins]]
|372710015	
}}

|{{Highest-grossing films franchise |type=franchise|sub=y|title=[[Batman in film#Tim Burton / Joel Schumacher series|Batman (original series)]]|total={{#expr:678171278+574736266}}|number=4|highest=[[Batman (1989 film)|Batman]]|gross=411348924
|{{Highest-grossing films franchise |type=series|sub=y|title=[[Batman in film#Tim Burton / Joel Schumacher series|Batman (Tim Burton)]]|total=|number=2|highest=[[Batman (1989 film)|Batman]]|gross=411348924
<!--GROSSES-->
|[[Batman (1989 film)|Batman]]
|411348924
|[[Batman Returns]]
|266822354			
}}
|{{Highest-grossing films franchise |type=series|sub=y|title=[[Batman in film#Tim Burton / Joel Schumacher series|Batman (Joel Schumacher)]]|total=|number=2|highest=[[Batman Forever]]|gross=336529144
<!--GROSSES-->
|[[Batman Forever]]
|336529144			
|[[Batman & Robin (film)|Batman & Robin]]
|238207122	
}}
}}

|{{Highest-grossing films franchise |type=film|sub=y|title=[[Batman: Mask of the Phantasm]]|total=5617391}}

}}

Limits

A series can hold up to 50 films. A franchise can hold up to 10 series/sub-franchises. Each limit applies only at the level, so a franchise could contain ten sub-franchises, which in turn could each contain ten series, which could each hold up to fifty films each. The limits have been chosen to allow for plenty of franchise "growth", but can easily be extended if required. In theory, a franchise entry could contain up to 37 levels, the limit the software imposes. However, it is likely that the table would become unreadable before that stage, let alone the fact that a scenario that requires that level of refining is unlikely to ever occur. It is not known at which level it becomes impractical to add another level, but as a guide, the Batman sub-franchise example only has three levels of tables. An analogous example could see further refining by actors, and possibly another level beyond that for spin-offs in the case of some franchises, requiring five levels, and the chart is easily readable to this level.

Updating totals

In the case of series tables, the task of calculating the total is automated. Totals for franchises and sub-franchises have to be manually added. The easiest way to do this, is to type in the film grosses, and use the preview function so you can see what the series totals are. This will leave the franchise total without a value:

Highest-grossing film series (The films in each franchise can be viewed by selecting "show".)
Rank Series Total worldwide gross No. of films Average of films Highest-grossing film

The three totals can then be copied into the franchise table from which the franchise total can be calculated using a summation formula (making sure you enter the amounts in unformatted raw form):

total={{#expr:1374631840+1252907544+5617391}}

Saving this will transclude the franchise total into the table, so the table will look like the one in the second example above. This process will also work for sub-franchises too, working up from the bottom level, one level at time, harvesting the totals and entering them into summation formulas. The alternative method is to work out the totals yourself and enter them directly, but calculating the totals yourself is more subsceptible to error.

Consensus

This template has been designed for usage on a particular article. While it is available to use on other articles, please do not make any alterations that will adjust it aesthetically or functionally, without discussing it first at Talk:List of highest-grossing films. The examples used on this template do not represent a consensus for how this data should be organised; that is for the article editors to determine, in conjunction with the various policies and guidelines. The form the examples take here are purely to demonstrate functionality. On the same note, these examples should not be altered to mirror the structure of organisation on the article, since they are constructed to highlight the differences in functionality.

Technical issues

Due to wikicode rendering in different ways in different browsers, if you tweak something it is best to check it in several browsers. Internet Explorer is the main one, but Firefox, Chrome, Safari and Opera are all popular browsers too.

See also

No description.

Template parameters

ParameterDescriptionTypeStatus
11

no description

Unknownoptional
22

no description

Unknownoptional
33

no description

Unknownoptional
44

no description

Unknownoptional
55

no description

Unknownoptional
66

no description

Unknownoptional
77

no description

Unknownoptional
88

no description

Unknownoptional
99

no description

Unknownoptional
1010

no description

Unknownoptional
1111

no description

Unknownoptional
1212

no description

Unknownoptional
1313

no description

Unknownoptional
1414

no description

Unknownoptional
1515

no description

Unknownoptional
1616

no description

Unknownoptional
1717

no description

Unknownoptional
1818

no description

Unknownoptional
1919

no description

Unknownoptional
2020

no description

Unknownoptional
2121

no description

Unknownoptional
2222

no description

Unknownoptional
2323

no description

Unknownoptional
2424

no description

Unknownoptional
2525

no description

Unknownoptional
2626

no description

Unknownoptional
2727

no description

Unknownoptional
2828

no description

Unknownoptional
2929

no description

Unknownoptional
3030

no description

Unknownoptional
3131

no description

Unknownoptional
3232

no description

Unknownoptional
3333

no description

Unknownoptional
3434

no description

Unknownoptional
3535

no description

Unknownoptional
3636

no description

Unknownoptional
3737

no description

Unknownoptional
3838

no description

Unknownoptional
3939

no description

Unknownoptional
4040

no description

Unknownoptional
4141

no description

Unknownoptional
4242

no description

Unknownoptional
4343

no description

Unknownoptional
4444

no description

Unknownoptional
4545

no description

Unknownoptional
4646

no description

Unknownoptional
4747

no description

Unknownoptional
4848

no description

Unknownoptional
4949

no description

Unknownoptional
5050

no description

Unknownoptional
5151

no description

Unknownoptional
5252

no description

Unknownoptional
5353

no description

Unknownoptional
5454

no description

Unknownoptional
5555

no description

Unknownoptional
5656

no description

Unknownoptional
5757

no description

Unknownoptional
5858

no description

Unknownoptional
5959

no description

Unknownoptional
6060

no description

Unknownoptional
6161

no description

Unknownoptional
6262

no description

Unknownoptional
6363

no description

Unknownoptional
6464

no description

Unknownoptional
6565

no description

Unknownoptional
6666

no description

Unknownoptional
6767

no description

Unknownoptional
6868

no description

Unknownoptional
6969

no description

Unknownoptional
7070

no description

Unknownoptional
7171

no description

Unknownoptional
7272

no description

Unknownoptional
7373

no description

Unknownoptional
7474

no description

Unknownoptional
7575

no description

Unknownoptional
7676

no description

Unknownoptional
7777

no description

Unknownoptional
7878

no description

Unknownoptional
7979

no description

Unknownoptional
8080

no description

Unknownoptional
8181

no description

Unknownoptional
8282

no description

Unknownoptional
8383

no description

Unknownoptional
8484

no description

Unknownoptional
8585

no description

Unknownoptional
8686

no description

Unknownoptional
8787

no description

Unknownoptional
8888

no description

Unknownoptional
8989

no description

Unknownoptional
9090

no description

Unknownoptional
9191

no description

Unknownoptional
9292

no description

Unknownoptional
9393

no description

Unknownoptional
9494

no description

Unknownoptional
9595

no description

Unknownoptional
9696

no description

Unknownoptional
9797

no description

Unknownoptional
9898

no description

Unknownoptional
9999

no description

Unknownoptional
100100

no description

Unknownoptional
Typetype

no description

Unknownoptional
Subsub

no description

Unknownoptional
Rankrank

no description

Unknownoptional
Titletitle

no description

Unknownoptional
Currencycurrency

no description

Unknownoptional
Totaltotal

no description

Unknownoptional
Totalnotetotalnote

no description

Unknownoptional
Numbernumber

no description

Unknownoptional
Highesthighest

no description

Unknownoptional
Grossgross

no description

Unknownoptional
Releaserelease

no description

Unknownoptional
Ranklabelranklabel

no description

Unknownoptional
Rankwidthrankwidth

no description

Unknownoptional
Titlelabeltitlelabel

no description

Unknownoptional
Titlewidthtitlewidth

no description

Unknownoptional
Totallabeltotallabel

no description

Unknownoptional
Totalwidthtotalwidth

no description

Unknownoptional
Numberlabelnumberlabel

no description

Unknownoptional
Numberwidthnumberwidth

no description

Unknownoptional
Averagelabelaveragelabel

no description

Unknownoptional
Averagewidthaveragewidth

no description

Unknownoptional
Highestlabelhighestlabel

no description

Unknownoptional
Highestwidthhighestwidth

no description

Unknownoptional
Whitespacewidthwhitespacewidth

no description

Unknownoptional