Template:MLB standings/sandbox

This is the template sandbox page for Template:MLB standings (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

This template uses TemplateStyles:

Template:MLB standings/sandbox/styles.css

This template is used on approximately 3,800 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:MLB standings (sandbox)

Usage

For a division standings template:

{{MLB standings
|division=<division name>
|year=<year>
|seeds={{{seeds|}}}
|highlight={{{highlight|}}}
|<1st place team>
|<home wins>|<home losses>
|<road wins>|<road losses>
|<2nd place team>
|<home wins>|<home losses>
|<road wins>|<road losses>
|<3rd place team>
|<home wins>|<home losses>
|<road wins>|<road losses>
|<4th place team>
|<home wins>|<home losses>
|<road wins>|<road losses>
|<5th place team>
|<home wins>|<home losses>
|<road wins>|<road losses>
}}

For the division leaders table in a wild card standings template:

{{MLB standings
|input=overallWinLoss
|division=Division leaders
|year=<year>
|template_name=<name of template page without "Template:" prefix>
|highlight={{{highlight|}}}
|<1st division leader>
|<overall wins>|<overall losses>
|<2nd division leader>
|<overall wins>|<overall losses>
|<3rd division leader>
|<overall wins>|<overall losses>
}}

For the wild card standings in a wild card standings template:

{{MLB standings
|input=overallWinLoss
|output=wildCard
|year=<year>
|template_name=<name of template page without "Template:" prefix>
|highlight={{{highlight|}}}
|<1st team>
|<overall wins>|<overall losses>
|<2nd team>
|<overall wins>|<overall losses>
|<3rd team>
|<overall wins>|<overall losses>
...
}}

For the wild card standings in a wild card standings template from 2012 to 2021, the following alternate syntax is supported:

{{MLB standings
|input=overallWinLoss
|output=wildCard2012
|year=<year>
|template_name=<name of template page without "Template:" prefix>
|highlight={{{highlight|}}}
|<1st team>
|<overall wins>|<overall losses>
|<2nd team>
|<overall wins>|<overall losses>
|<3rd team>
|<overall wins>|<overall losses>
...
}}

This template is a helper template for annual MLB division standings templates, such as Template:2013 NL East standings. It is also used to create the standings tables contained in a wild card standings template, such as Template:2013 AL Wild Card standings.

Creating an MLB division standings template

To create a division standings template for a given MLB division and year:

Create the template with the name Template:<year> <AL or NL> <East, Central, or West> standings. For example: Template:2013 AL Central standings
Use the {{MLB standings}} template as shown in the usage example above. The teams must be listed in the correct standings order. For the |division= parameter, use one of the following values:
- National League East
- National League Central
- National League West
- American League East
- American League Central
- American League West
Note the |seeds= and |highlight= parameters must be included as shown, in order to allow these parameters to be passed through from the division standings template.
If you are creating a standings template for a division not listed above, and you want the heading in the standings table to link to a specific article, add a |division_link= parameter, set to the name of the target article.
For cases where the name of the team season article page is not in the format "<year> <team name> <season>", see § Support for customizing links.

The resulting division standings template can be used as follows:

In the season article for a team: use the |highlight= parameter, set to the name of the team. For example, in the 2013 Toronto Blue Jays season article, use the following: {{2013 AL East standings|highlight=Toronto Blue Jays}}
In the MLB season article:
- During the regular season, when no teams have clinched a playoff position: use the division standings template without any parameters. For example, in the 2013 Major League Baseball season article, use the following: {{2013 NL Central standings}}
- When a team has clinched a playoff spot but the seeding for the playoffs is unknown, use the |highlight= parameter to specify the team in the playoffs. Multiple teams can be listed by using a comma to separate them. For example, to indicate that the Seattle Mariners and Oakland A's are going to be in the 2013 playoffs, use the following: {{2013 AL West standings|highlight=Seattle Mariners,Oakland A's}}
- When the seeding of a team bound for the playoffs is known, use the |seeds= parameter to specify the team's seeding, in the format "<seed number>:<team name>". Multiple seeds can be listed by using a comma to separate them. For example, to indicate that the Chicago White Sox are seeded first and the Kansas City Royals are seeded fourth in the 2013 playoffs, use the following: {{2013 AL Central standings|seeds=1:Chicago White Sox,4:Kansas City Royals}}
- Both the |seeds= and |highlight= parameters can be combined together as needed. For example, to indicate that the Washington Nationals are seeded first and the Atlanta Braves have clinched the playoffs with a yet-to-be-determined seeding, use the following: {{2013 NL East standings|seeds=1:Washington Nationals|highlight=Atlanta Braves}}

Creating a wild card standings template

A wild card standings template, such as Template:2013 AL Wild Card standings, consists of a division leaders table and a wild card standings table. To create the division leaders table, use the {{MLB standings}} template as shown in the usage example above. The teams must be listed in the desired output order. For the |division= parameter, use |division=Division leaders. Set the |input= parameter to |input=overallWinLoss. The |template_name= parameter must specify the name of the template page, such as |template_name=2013 AL Wild Card standings, without the "Template:" prefix. Note the |highlight= parameter must be included as shown, in order to allow this parameter to be passed through from the wild card standings template.

To create the wild card standings table, use the {{MLB standings}} template as shown in the usage example above. The teams must be listed in the correct standings order. Set the |input= parameter to |input=overallWinLoss, and the |output= parameter to |output=wildCard. Note the |highlight= parameter must be included as shown, in order to allow this parameter to be passed through from the wild card standings template. (For backwards compatibility, the |output= parameter can be set to |output=wildCard2012 for seasons from 2012 to 2021.)

The resulting wildcard standings template can be included in a team season article, such as 2013 Chicago Cubs season, with the |highlight= parameter set to the team name. For example: {{2013 NL Wild Card standings|highlight=Chicago Cubs}}

Support for customizing links

The following parameters are supported to facilitate using this template for standings templates related to organizations other than MLB, and for cases where the default links are insufficient:

If you want the heading in the standings table to link to a specific article, add a |division_link= parameter, set to the name of the target article.
For a given team, if the team season article does not following the format "<year> <team name> <season>" (for instance, if the team name has a disambiguator at the end), specify the required text between "<year>" and "<season>" by adding a |team_links= parameter, with the following format: team_links=<team 1 name>:<team 1 article name>,<team 2 name>:<team 2 article name>
For example: |team_links=New York Giants:New York Giants (PL),Philadelphia Athletics:Philadelphia Athletics (PL)

Examples

Using the {{MLB standings}} template to create a division standings table:

{{MLB standings
|division=National League Central
|year=2016
|seeds={{{seeds|}}}
|highlight={{{highlight|}}}
|Chicago Cubs
|57|24
|46|34
|St. Louis Cardinals
|38|43
|48|33
|Pittsburgh Pirates
|38|42
|40|41
|Milwaukee Brewers
|41|40
|32|49
|Cincinnati Reds
|38|43
|30|51
}}

Resulting output:

v
t
e
National League Central
Team	W	L	Pct.	GB	Home	Road
Chicago Cubs	103	58	.640	—	57‍–‍24	46‍–‍34
St. Louis Cardinals	86	76	.531	17½	38‍–‍43	48‍–‍33
Pittsburgh Pirates	78	83	.484	25	38‍–‍42	40‍–‍41
Milwaukee Brewers	73	89	.451	30½	41‍–‍40	32‍–‍49
Cincinnati Reds	68	94	.420	35½	38‍–‍43	30‍–‍51

Using the {{MLB standings}} template to create a division leaders table:

{{MLB standings
|input=overallWinLoss
|division=Division leaders
|year=2016
|template_name=2016 NL Wild Card standings
|highlight={{{highlight|}}}
|Chicago Cubs
|103|58
|Washington Nationals
|95|67
|Los Angeles Dodgers
|91|71
}}

Resulting output:

v
t
e
Division leaders
Team	W	L	Pct.
Chicago Cubs	103	58	.640
Washington Nationals	95	67	.586
Los Angeles Dodgers	91	71	.562

Using the {{MLB standings}} template to create a wild card standings table:

{{MLB standings
|input=overallWinLoss
|output=wildCard
|year=2022
|template_name=2022 NL Wild Card standings
|highlight={{{highlight|}}}
|New York Mets
|87|75
|San Francisco Giants
|87|75
|St. Louis Cardinals
|86|76
|Miami Marlins
|79|82
|Pittsburgh Pirates
|78|83
|Colorado Rockies
|75|87
|Milwaukee Brewers
|73|89
|Philadelphia Phillies
|71|91
|Arizona Diamondbacks
|69|93
|Atlanta Braves
|68|93
|San Diego Padres
|68|94
|Cincinnati Reds
|68|94
}}

Resulting output:

v
t
e
Wild Card teams
(Top 3 teams qualify for postseason)
Team	W	L	Pct.	GB
New York Mets	87	75	.537	+1
San Francisco Giants	87	75	.537	+1
St. Louis Cardinals	86	76	.531	—
Miami Marlins	79	82	.491	6½
Pittsburgh Pirates	78	83	.484	7½
Colorado Rockies	75	87	.463	11
Milwaukee Brewers	73	89	.451	13
Philadelphia Phillies	71	91	.438	15
Arizona Diamondbacks	69	93	.426	17
Atlanta Braves	68	93	.422	17½
San Diego Padres	68	94	.420	18
Cincinnati Reds	68	94	.420	18