Editing Template:MapLeagueInclusionTable/Header/doc

__NOTOC__
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:
* Template:MapLeagueInclusionTable/Header
* [[Template:MapLeagueInclusionTable/Row/Map]]
* [[Template:MapLeagueInclusionTable/Row/Info]]
* [[Template:MapLeagueInclusionTable/Footer]]
These templates can be found here: '''[[:Category:MapLeagueInclusionTable Base Templates]]'''<br />
Each individual map's table templates can be found here: '''[[:Category:MapLeagueInclusionTable Map Templates]]'''<br />
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), OZF (ozfortress) (6v6), UGC (HL) and ETF2L (HL)
* A full table example is listed at the bottom of this page

== Table cross-section ==
'''<font color="#E0CEF2">Purple</font>'''  sections are controlled by Template:MapLeagueInclusionTable/Header<br />
'''<font color="#F2E0CE">Orange</font>''' sections are controlled by [[Template:MapLeagueInclusionTable/Row/Map]]<br />
'''<font color="#F2CEE0">Hot Pink</font>''' sections are controlled by [[Template:MapLeagueInclusionTable/Row/Info]]<br />
'''<font color="#CEE0F2">Blue</font>''' sections are controlled by [[Template:MapLeagueInclusionTable/Footer]]<br />
{| class="wikitable" style="text-align: center;"
|+ <font color="#E0CEF2">Seasonal Inclusions by League</font>
 ! rowspan="2" colspan="3" style="color: white; background-color: #E0CEF2; width: 22px;" | Map name
 ! style="color: white; background-color: #E0CEF2;" colspan="1 | 4v4
 ! style="color: white; background-color: #E0CEF2;" colspan="4" | 6v6
 ! style="color: white; background-color: #E0CEF2;" colspan="2" | Highlander
|-
 ! style="background-color: #E0CEF2; width:100px;" | [[File:UGC-Icon.png | 20px | link=]] [[UGC]]
 ! style="background-color: #E0CEF2; width:100px;" | [[File:UGC-Icon.png | 20px | link=]] [[UGC]]
 ! style="background-color: #E0CEF2; width:100px;" | [[File:ETF2L-Icon.png | 20px | link=]] [[ETF2L]]
 ! style="background-color: #E0CEF2; width:100px;" | [[File:EseaLogo.png | 20px | link=]] [[ESEA]]
 ! style="background-color: #E0CEF2; width:100px;" | [[File:Ozfortress icon.png | 20px | link=]] [[Ozfortress|OZF]]
 ! style="background-color: #E0CEF2; width:100px;" | [[File:UGC-Icon.png | 20px | link=]] [[UGC]]
 ! style="background-color: #E0CEF2; width:100px;" | [[File:ETF2L-Icon.png | 20px | link=]] [[ETF2L]]
|-
 ! style="border-right: hidden; background-color: #F2E0CE; width: 12px; " rowspan="2" | 
 ! style="background-color: #F2E0CE;" rowspan="2" | [[File:Download Icon.png | 12px | link=comp.tf]] cp_cheeseburger
 ! style="border-left: hidden; background-color: #F2E0CE; width: 12px;" rowspan="2" | 
 | style="background-color:#F2CEE0" | Season 1
 | style="background-color:#F2CEE0" | Season 2
 | style="background-color:#F2CEE0" | Season 3
 | style="background-color:#F2CEE0" | Season 4
 | style="background-color:#F2CEE0" | Season 5
 | style="background-color:#F2CEE0" | Season 6
 | style="background-color:#F2CEE0" | Season 7
|-
 | style="background-color: #F2CEE0" | 
 | style="background-color:#F2CEE0" | Season 1
 | style="background-color:#F2CEE0" | 
 | style="background-color:#F2CEE0" | 
 | style="background-color:#F2CEE0" | 
 | style="background-color:#F2CEE0" | Season 2
 | style="background-color:#F2CEE0" | Season 3
|-
 ! style="background-color:#CEE0F2; color: white;" colspan="3" | Total inclusions
 ! style="background-color:#CEE0F2" | 1 <small>out of</small> 1
 ! style="background-color:#CEE0F2" | 2 <small>out of</small> 2
 ! style="background-color:#CEE0F2" | 1 <small>out of</small> 3
 ! style="background-color:#CEE0F2" | 1 <small>out of</small> 4
 ! style="background-color:#CEE0F2" | 1 <small>out of</small> 5
 ! style="background-color:#CEE0F2" | 2 <small>out of</small> 6
 ! style="background-color:#CEE0F2" | 2 <small>out of</small> 7
|}
<font color="#CEE0F2">'''''Italic bold''''' denotes the current or latest season</font>
{| class="wikitable" style="text-align: left;" 
 | style="width: 20px; height: 20px; background-color: #CEE0F2" |
 | style="border-right: hidden; background-color: #CEE0F2; width: 1px;" |
 | style="background-color:#CEE0F2" | Official map
 | style="border-left: hidden; background-color: #CEE0F2; width: 1px;" |
|-
 | style="width: 20px; height: 20px; background-color: #CEE0F2;" |
 | style="border-right: hidden; background-color: #CEE0F2; width: 1px;" |
 | style="background-color: #CEE0F2" | Adapted or 'pro' version
 | style="border-left: hidden; background-color: #CEE0F2; width: 1px;" |
|}

== Template:MapLeagueInclusionTable/Header ==
The header defines what leagues will be included in the table.<br />
Setting any of the below parameters to '1' will display the parameter's league as a column.<br />
<code>|ugc4s</code>, <code>|ugc6s</code>, <code>|etf2l6s</code>, <code>|esea6s</code>, <code>|ozf6s</code>, <code>|ugchl</code>, and <code>|etf2lhl</code><br />
=== Example ===
<pre>{{MapLeagueInclusionTable/Header
 | ugc6s = 1
 | etf2l6s = 1
 | esea6s = 1
 | ozf6s = 1
 | ugchl = 1
}}
|}</pre>'''Will yield:'''
{{MapLeagueInclusionTable/Header
 | ugc6s = 1
 | etf2l6s = 1
 | esea6s = 1
 | ozf6s = 1
 | ugchl = 1
}}
|}

== [[Template:MapLeagueInclusionTable/Row/Map]] ==
This controls everything inside the first cell of a single row.<br />
<code>|maptype</code> - 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 ({{abbr|<nowiki>#</nowiki>4F4F4F|Hexadecimal colour value}})
* '''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 ({{abbr|<nowiki>#</nowiki>F2F2F2|Hexadecimal colour value}})
* '''normal''' - For maps that don't pertain to the above, makes the ribbon invisible<br /><br />
'''Parameters:'''<br />
<code>|mapname</code> - The file name for the map version.<br />
<code>|mapdownload</code> - The download link (URL) for the map version. Tips for how to find a map download are listed below.<br />
<code>|maplink</code> - 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)''<br />
<code>|maprowspan</code> - 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 <code>|mapdownload</code> 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
<nowiki>*This could be due to an archiving error by ETF2L, meaning a different map version is the correct map at hand</nowiki>
== [[Template:MapLeagueInclusionTable/Row/Info]] ==
This controls the cells of the row that contain each seasonal inclusion.<br />
* 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. ''<code>|''ugc4s = 2</code> 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 ({{abbr|<nowiki>#</nowiki>BABABA|Hexadecimal colour value}})
* Inclusions for a map version with multiple rows should always be pushed to the top. For example:
{{MapLeagueInclusionTable/Header
 | ugc6s = 1
 | etf2l6s = 1
 | esea6s = 1
}}
{{MapLeagueInclusionTable/Row/Map
 | maptype = pro
 | mapname = cp_cheeseburger_pro_v42
 | maprowspan = 3
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc6s = 5
 | esea6s = 17
 | etf2l6s = 0
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 4
 | esea6s = 0
 | etf2l6s = 20
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 3
 | esea6s = 16
 | etf2l6s = 0
}}|}
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:
{{MapLeagueInclusionTable/Header
 | ugc4s = 1
 | etf2l6s = 1
 | esea6s = 1
}}
{{MapLeagueInclusionTable/Row/Map
 | maptype = pro
 | mapname = cp_cheeseburger_pro_v42
 | maprowspan = 3
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc6s = 5
 | esea6s = 17
 | etf2l6s = 20
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 4
 | esea6s = 16
 | etf2l6s = 0
}}
{{MapLeagueInclusionTable/Row/Info
 | ugc4s = 3
 | esea6s = 0
 | etf2l6s = 0
}}|}
=== Full row example ===
<small><pre>{{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
}}</pre></small> '''Will yield:'''
{{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
}}
|}

== [[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. ''<code>|''esea6s = 2</code> 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.<br /><br />
'''Parameters:'''<br />
<code>|official</code> - Displays a table explaining the grey (official) ribbon<br />
<code>|pro</code> - 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 ''<code>|''pro</code> 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 ===
<pre>{{MapLeagueInclusionTable/Header |ugc6s = 1 |etf2l6s = 1 |esea6s = 1 |ozf6s = 1 }}
{{MapLeagueInclusionTable/Footer
 | ugc6s = 1
 | etf2l6s = 2
 | esea6s = 3
 | ozf6s = 4
 | official = 1
 | pro = 1
}}</pre> '''Will yield:'''
{{MapLeagueInclusionTable/Header |ugc6s = 1 |etf2l6s = 1 |esea6s = 1 |ozf6s = 1 }}
{{MapLeagueInclusionTable/Footer
 | ugc6s = 1
 | etf2l6s = 2
 | esea6s = 3
 | ozf6s = 4
 | official = 1
 | pro = 1
}}

== Full table example ==
<pre>{{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 = 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
}}</pre> '''Will yield:'''
{{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 = 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
}}
<noinclude>[[Category:Template]][[Category:MapLeagueInclusionTable Templates]]</noinclude>