Template:MapLeagueInclusionTable/Header/doc

From comp.tf
< Template:MapLeagueInclusionTable/Header
Revision as of 13:17, 18 September 2020 by Efefknee (talk | contribs) (→‎Template:MapLeagueInclusionTable/Header)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This table was made to show a map's inclusions in the map pool of various leagues and in various seasons. The current templates used to make a table are:

These templates can be found here: Category:MapLeagueInclusionTable Base Templates
Each individual map's table templates can be found here: Category:MapLeagueInclusionTable Map Templates
All templates can be found here: Category:MapLeagueInclusionTable Templates

General info

  • All parameters are in lowercase characters
  • The current leagues available to include are UGC (4v4), UGC (6v6), ETF2L (6v6), ESEA (6v6), ozfortress (6v6), AsiaFortress (6v6), UGC (HL) and ETF2L (HL)
  • A full table example is listed at the bottom of this page

Table cross-section

Purple sections are controlled by Template:MapLeagueInclusionTable/Header
Orange sections are controlled by Template:MapLeagueInclusionTable/Row/Map
Hot Pink sections are controlled by Template:MapLeagueInclusionTable/Row/Info
Blue sections are controlled by Template:MapLeagueInclusionTable/Footer

Seasonal Inclusions by League
Map name 4v4 6v6 7v7 Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
DownloadIcon.png cp_cheeseburger Season 1 Season 2 Season 3 Season 4 Season 5 Season 6 Season 7 Season 8 Season 9 Season 10 Season 11
Season 1 Season 2 Season 3
Total inclusions 1 out of 1 2 out of 2 1 out of 3 1 out of 4 1 out of 5 1 out of 6 2 out of 7 2 out of 8 1 out of 9 1 out of 10 1 out of 11

Italic bold denotes the current or latest season

Official map
Adapted or 'pro' version

Template:MapLeagueInclusionTable/Header

The header defines what leagues will be included in the table.
Setting any of the below parameters to '1' will display the parameter's league as a column.
|ugc4s, |ugc6s, |etf2l6s, |esea6s, |ozf6s, |rgl6s, |af6s, |rgl7s, |ugchl|etf2lhl and |rglhl,

Example

{{MapLeagueInclusionTable/Header
 | ugc6s = 1
 | etf2l6s = 1
 | esea6s = 1
 | ozf6s = 1
 | ugchl = 1
}}
|}

Will yield:

Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL

Template:MapLeagueInclusionTable/Row/Map

This controls everything inside the first cell of a single row.
|maptype - The coloured ribbon which indicates the map's type. Must be set to any of the following values:

  • official - For official maps, sets the ribbon colour to grey (#4F4F4F)
  • pro - For maps that have been adapted/re-created from another, or 'pro' maps (e.g. koth_product_rc8). Sets the ribbon colour to green (#F2F2F2)
  • normal - For maps that don't pertain to the above, makes the ribbon invisible

Parameters:
|mapname - The file name for the map version.
|mapdownload - The download link (URL) for the map version. Tips for how to find a map download are listed below.
|maplink - The wiki page the map name will link to. Should only be used for similar maps that are used in the same Inclusion Table (e.g. cp_granary and cp_granary_pro)
|maprowspan - The rowspan for the entire row, must be set to a value (can be set to 1). If set to more than 1, the same amount of /Row/Info rows will need to follow before another /Row/Map template can be used (e.g. if rowspan is set to 3, three /Row/Info templates will follow).

Finding a map download link

The preferable download is a direct link with the map in .bsp.bz2 format. Searching for the map's .bsp.bz2 file name (e.g. koth_product_rc8.bsp.bz2) can often find a website with a download link, make sure that the download is indeed .bsp.bz2 format and is trustworthy. Copying the website's download link address will give you the URL for the |mapdownload parameter.

There are 6 maps with no download links:

  • koth_lakeside.bsp.bz2
  • cp_logjam.bsp.bz2*
  • cp_obscure_remake.bsp.bz2
  • cp_obscure.bsp.bz2
  • cp_standin_rc5.bsp.bz2
  • cp_yukon.bsp.bz2

*This could be due to an archiving error by ETF2L, meaning a different map version is the correct map at hand

Template:MapLeagueInclusionTable/Row/Info

This controls the cells of the row that contain each seasonal inclusion.

  • Only parameters that are defined with the /Header template should be used
  • Parameters should be set to the season number of the parameter's league in which the map is included (e.g. |ugc4s = 2 if the map is included in Season 2 of the UGC 4s League)
  • Inclusions should of course be chronologically ordered
  • Parameters must be set to a value. If there is no seasonal inclusion, setting the parameter to 0 will leave it blank (#BABABA)
  • Inclusions for a map version with multiple rows should always be pushed to the top. For example:
Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
cp_cheeseburger_pro_v42 Season Season 5 Season 17 Season Season Season Season Season Season Season
Season 4 Season Season 20 Season Season Season Season Season Season Season
Season 3 Season Season 16 Season Season Season Season Season Season Season

The above table is incorrect, as the ETF2L and ESEA columns have inclusions that are not at the top of the row. The following is a correct version:

Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
cp_cheeseburger_pro_v42 Season Season 5 Season 20 Season 17 Season Season Season Season Season Season Season
Season 4 Season Season 16 Season Season Season Season Season Season Season
Season 3 Season Season Season Season Season Season Season Season

Full row example

{{MapLeagueInclusionTable/Header |ugc4s = 1 |esea6s = 1 |ozf6s = 1 |etf2lhl = 1}}
{{MapLeagueInclusionTable/Row/Map
 | maptype = pro
 | mapdownload = comp.tf
 | mapname = cp_cheeseburger_pro_v42
 | maprowspan = 1
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 5
 | esea6s = 0
 | ozf6s = 14
 | etf2lhl = 7
}}
{{MapLeagueInclusionTable/Row/Map
 | maptype = official
 | mapname = cp_cheeseburger
 | maplink = Main Page
 | maprowspan = 2
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 4
 | esea6s = 17
 | ozf6s = 13
 | etf2lhl = 0
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 0
 | esea6s = 16
 | ozf6s = 0
 | etf2lhl = 0
}}

Will yield:

Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Download Link cp_cheeseburger_pro_v42 Season 5 Season Season Season 14 Season Season Season Season Season 7 Season
cp_cheeseburger Season 4 Season Season Season 17 Season 13 Season Season Season Season Season
Season Season Season 16 Season Season Season Season Season

Template:MapLeagueInclusionTable/Footer

The footer shows the total inclusions of a map in each individual league.

  • Only parameters that are defined with the /Header template (and therefore the /Row/Info template) should be used
  • Parameters should be set to the total number of seasonal inclusions that the parameter's league has displayed in the table (e.g. |esea6s = 2 if there are 6 inclusions under the ESEA column)
  • The total number of seasons (second part of each cell) is automatically calculated

There is also a 'key' section to the footer which is used as a legend to explain colours/text formatting used in the table.

Parameters:
|official - Displays a table explaining the grey (official) ribbon
|pro - Displays a table explaining the green (pro) ribbon

  • Parameters should only be included if the respective attribute is included in the table (e.g. only include the |pro parameter if there is a pro map in the table)
  • Set a parameter to '1' to display it
  • The caption (saying "Italic bold denotes the current or latest season") is controlled by Template:Current Rotations and is updated in conjunction with that template.

Example

{{MapLeagueInclusionTable/Header |ugc6s = 1 |etf2l6s = 1 |esea6s = 1 |ozf6s = 1 }}
{{MapLeagueInclusionTable/Footer
 | ugc6s = 1
 | etf2l6s = 2
 | esea6s = 3
 | ozf6s = 4
 | official = 1
 | pro = 1
}}

Will yield:

Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Total inclusions out of 28 1 out of 41 2 out of 46 3 out of 30 4 out of 38 out of 21 out of 13 out of 10 out of 39 out of 30 out of 16
Official map
Pro version

Full table example

{{MapLeagueInclusionTable/Header
 | ugc4s = 1
 | esea6s = 1
 | ozf6s = 1
 | etf2lhl = 1
}}
{{MapLeagueInclusionTable/Row/Map
 | maptype = pro
 | mapdownload = Main Page
 | mapname = cp_cheeseburger_pro_v42
 | maprowspan = 1
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 5
 | esea6s = 0
 | ozf6s = 14
 | etf2lhl = 7
}}
{{MapLeagueInclusionTable/Row/Map
 | maptype = official
 | mapname = cp_cheeseburger
 | maplink = Main Page
 | maprowspan = 1
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 4
 | esea6s = 17
 | ozf6s = 0
 | etf2lhl = 0
}}
{{MapLeagueInclusionTable/Footer
 | ugc4s = 2
 | esea6s = 1
 | ozf6s = 1
 | etf2lhl = 1
 | official = 1
 | pro = 1
}}

Will yield:

Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Download Link cp_cheeseburger_pro_v42 Season 5 Season Season Season 14 Season Season Season Season Season 7 Season
cp_cheeseburger Season 4 Season Season Season 17 Season Season Season Season Season
Total inclusions 2 out of 28 out of 41 out of 46 1 out of 30 1 out of 38 out of 21 out of 13 out of 10 out of 39 1 out of 30 out of 16
Official map
Pro version