Content deleted Content added
S.A. Julio (talk | contribs) update documentation |
S.A. Julio (talk | contribs) add |
||
(31 intermediate revisions by 3 users not shown) | |||
Line 1:
{{Module rating|beta<!-- Values: pre-alpha • alpha • beta • release • protected • semiprotected -- If a rating not needed/relevant, delete this template call -->}}
{{Lua|Module:Arguments|Module:Yesno}}
{{Uses TemplateStyles|Template:Screen reader-only/styles.css|Module:Sports series/styles.css}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
This is a module for generating match results for a sports series, such as a [[two-legged tie]]. However, the module can support single-leg ties up to an unlimited number of legs. The template supports domestic and international
== Usage ==
Line 9 ⟶ 11:
For two-legged ties in international club football, seven parameters are expected to be passed for each row. This includes each club's name and national association country name/code, the aggregate score and the score of both legs.
<
|
}}</
===
For two-legged ties in national team or domestic club football, five parameters are expected to be passed for each row. This includes each club's name, the aggregate score and the score of both legs. The parameter {{para|flag|n}} must be passed to disable the country flag parameter.
<
|
}}</
== Examples ==
Line 37 ⟶ 26:
=== International club football ===
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}</
; Output
Line 48 ⟶ 37:
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}
=== Domestic club football ===
; Usage
<
|[[Valencia CF|Valencia]]|3–3
|[[Atlético Madrid]]|2–5|[[Sevilla FC|Sevilla]]|1–2|1–3
|[[RCD Espanyol|Espanyol]]|1–2|[[FC Barcelona|Barcelona]]|1–0|0–2
|[[CD Leganés|Leganés]]|2–2 ([[Away goals rule|a]])|[[Real Madrid CF|Real Madrid]]|0–1|2–1
}}</
; Output
{{#invoke:Sports series|main|flag=n
|[[Valencia CF|Valencia]]|3–3
|[[Atlético Madrid]]|2–5|[[Sevilla FC|Sevilla]]|1–2|1–3
|[[RCD Espanyol|Espanyol]]|1–2|[[FC Barcelona|Barcelona]]|1–0|0–2
Line 69 ⟶ 58:
}}
===
; Usage
<
|{{fb-rt|UKR}}|3–1|{{fb|SVN}}|2–0|1–1
|{{fb-rt|SWE}}|4–3|{{fb|DEN}}|2–1|2–2
|{{fb-rt|BIH}}|1–3|{{fb|IRL}}|1–1|0–2
|{{fb-rt|NOR}}|1–3|{{fb|HUN}}|0–1|1–2
}}</
; Output
{{#invoke:Sports series|main|
|{{fb-rt|UKR}}|3–1|{{fb|SVN}}|2–0|1–1
|{{fb-rt|SWE}}|4–3|{{fb|DEN}}|2–1|2–2
|{{fb-rt|BIH}}|1–3|{{fb|IRL}}|1–1|0–2
|{{fb-rt|NOR}}|1–3|{{fb|HUN}}|0–1|1–2
}}
== Parameter list ==
Below is a full list of
{| class="wikitable" style="width:
|-
! Parameter name
! Description
! Type
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|flag}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|legs}}
==== Example 1 ====
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|6–8|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1|2–2|0–1|2–2
|[[Atlético Madrid]]|ESP|10–11|[[Borussia Dortmund]]|GER|2–1|2–4|2–1|2–4|2–1
|[[Real Madrid CF|Real Madrid]]|ESP|11–11
|[[Paris Saint-Germain
}}</
; Output
Line 148 ⟶ 108:
|[[Arsenal F.C.|Arsenal]]|ENG|6–8|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1|2–2|0–1|2–2
|[[Atlético Madrid]]|ESP|10–11|[[Borussia Dortmund]]|GER|2–1|2–4|2–1|2–4|2–1
|[[Real Madrid CF|Real Madrid]]|ESP|11–11
|[[Paris Saint-Germain
}}
==== Example 2 ====
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}</
; Output
Line 165 ⟶ 125:
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}
|Number
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|bold_winner}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|color_winner}}
When this parameter is enabled for single-leg ties, the score cell of any draws will be automatically given a background color of {{bg|#FFFFBB|yellow (#FFFFBB)}}.
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|generate_links}}
|To enable, set to a positive value (e.g. y, yes, 1). Automatically generates wikilinks around match scores, linking to anchors in the format of "[Team 1] v [Team 2]" for the first leg and single-leg ties, and "[Team 2] v [Team 1]" for the second leg. If the first and/or second team from a tie is missing, the text within the anchor will default to "Team 1" and/or "Team 2", respectively. A link will be placed around the match score (or match date for future fixtures), excluding any text in parentheses, unless a link is already present around the score, in which case no change will be made.
This feature is intended to complement the automatic anchor generation feature of {{tl|Football box}}. On that template, anchors are automatically generated for articles with "group" or "knockout" in the title, as well as templates using the parameter {{para|id|auto}}.
==== Example 3 ====
; Usage
<syntaxhighlight lang="mediawiki">{{#invoke:Sports series|main|generate_links=y
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4 (4–3 p)|[[Manchester City F.C.|Manchester City]]|ENG|3–3|1–1 (aet)
|[[Paris Saint-Germain FC|Paris Saint-Germain]]|FRA|6–4|[[FC Barcelona|Barcelona]]|ESP|2–3|4–1
}}</syntaxhighlight>
; Output
{{#invoke:Sports series|main|generate_links=y
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4 (4–3 p)|[[Manchester City F.C.|Manchester City]]|ENG|3–3|1–1 (aet)
|[[Paris Saint-Germain FC|Paris Saint-Germain]]|FRA|6–4|[[FC Barcelona|Barcelona]]|ESP|2–3|4–1
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|matches_style}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|solid_cell}}
|When set to a positive value (e.g. y, yes, 1), any leg cells with a value of <code>null</code> will be given a background color of {{bg|#BBBBBB|grey (#BBBBBB)}}.
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|small_text}}
|Automatically enabled by default. To disable, set to a negative value (e.g. n, no, 0). The module automatically generates small text (85% font size) for legs (or the score column for single-leg ties) when no match score is present, and no small text exists in the cell already. This is to allow for the proper formatting of future matches, which typically lists the date of the fixture in a reduced font size. Small text is not applied to any references, notes or superscripts present.
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|collapsed}}
==== Example
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
}}</
; Output
Line 209 ⟶ 207:
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|center_table}}
|To enable, set to a positive value (e.g. y, yes, 1). If set, it centers the wikitable horizontally across the page. Does not work if {{para|collapsed}} is set.
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|caption}}
==== Example
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
}}</
; Output
Line 229 ⟶ 233:
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|title}}
==== Example
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
}}</
; Output
Line 249 ⟶ 253:
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|id}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|section}}
For example, if the article "Example" has this module placed in between {{xtag|onlyinclude|p}} tags with {{para|section|First round}}, then the table can be transcluded to other articles using <code><nowiki>{{:Example|transcludesection=First round}}</nowiki></code>.
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|nowrap}}
|
To enable nowrap for the entire table, set to a positive value (e.g. y, yes, 1).
To disable nowrap for the cells that it is included for by default, set to a negative value (e.g. n, no, 0).
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|
|Number
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|flag_size}}
|Modifies the size of the flags to a specific pixel count. The size is specified in pixels: <code>'''''Width''''' px</code> or <code>x '''''Height''''' px</code> or <code>'''''Width''''' x '''''Height''''' px</code>. This scales the image to be no greater than the given width or height, keeping its aspect ratio. For more information, see [[Wikipedia:Extended image syntax]]. The trailing "px" text is optional. By default, the size is controlled by the [[Wikipedia:WikiProject Flag Template|flag icon or country data templates]], but is usually <code>23x15px</code>.
|Number
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|show_country}}
|When set to a specific country name or code, only rows containing a team with that accompanying country name/code will be displayed in the final output. For example, if {{para|show_country|GER}}, rows only containing teams with the accompanying country code of "GER" (for Germany) will be displayed. Nothing will occur if {{para|flag|n}} is also set. Any custom headings within the table (set via {{para|heading''N''}}) will be suppressed when {{para|show_country}} is used.
This feature is useful when transcluding content to country-related articles, for example [[2024–25 in German football]]. However, note that if the module is being transcluded via [[Help:Labeled section transclusion|labeled section transclusion]], template parameters cannot be passed, and therefore this parameter would not work.
==== Example 7 ====
; Usage
<syntaxhighlight lang="mediawiki">{{#invoke:Sports series|main|show_country=ENG
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4 (4–3 p)|[[Manchester City F.C.|Manchester City]]|ENG|3–3|1–1 (aet)
|[[Paris Saint-Germain FC|Paris Saint-Germain]]|FRA|6–4|[[FC Barcelona|Barcelona]]|ESP|2–3|4–1
}}</syntaxhighlight>
; Output
{{#invoke:Sports series|main|show_country=ENG
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4 (4–3 p)|[[Manchester City F.C.|Manchester City]]|ENG|3–3|1–1 (aet)
|[[Paris Saint-Germain FC|Paris Saint-Germain]]|FRA|6–4|[[FC Barcelona|Barcelona]]|ESP|2–3|4–1
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|fill_blanks}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|team_width}}
|Number
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|score_width}}
|Number
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|away_goals}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|team1}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|team2}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|h_a}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|aggregate}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|leg''N''}}
==== Example
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}</
; Output
Line 343 ⟶ 383:
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|leg_prefix}}
==== Example
; Usage
<
|[[Golden State Warriors]]|3–4|[[Cleveland Cavaliers]]|104–89|110–77|90–120|108–97|97–112|101–115|89–93
}}</
; Output
Line 365 ⟶ 405:
}}
==== Example
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}</
; Output
Line 378 ⟶ 418:
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|leg_suffix}}
==== Example
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}</
; Output
Line 402 ⟶ 442:
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4
|[[Paris Saint-Germain
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|heading''N''}}
==== Example
; Usage
<
|{{fb-rt|POL}}|5–1|{{fb|EST}}
|{{fb-rt|WAL}}|4–1|{{fb|FIN}}
|{{fb-rt|WAL}}|0–0
}}</
; Output
{{#invoke:Sports series|main|
|{{fb-rt|POL}}|5–1|{{fb|EST}}
|{{fb-rt|WAL}}|4–1|{{fb|FIN}}
|{{fb-rt|WAL}}|0–0
}}
|String
|
|style="text-align:center;vertical-align:top"|{{TOC tab|note_group}}
|Determines the group that will be used for the notes. Can be either a custom-named group (e.g. {{para|note_group|nb}} will generate {{dummy ref|nb 1}}, {{dummy ref|nb 2}}, etc.), or a predefined group (options are <code>lower-alpha</code> (default), <code>upper-alpha</code>, <code>lower-roman</code>, <code>upper-roman</code> and <code>lower-greek</code>). For more information, see [[H:PREGROUP]]. The predefined group <code>decimal</code> is also valid, but this will render the same as a standard reference.
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|note_list}}
|When set to a positive value (e.g. y, yes, 1), a list of notes will be forced to display, with the group based on the value of {{para|note_group}} (<code>lower-alpha</code> by default). This is <u>not necessary</u> for standard note usage, as a note list will always be displayed when notes are created integrally through via the respective parameters. This is primarily useful if the module does not contain any notes, but you want to display notes below the table from elsewhere above on the page.
When set to a negative value (e.g. n, no, 0), no list of notes will be generated below the module. This is useful if it is desired to display the note list elsewhere below on the page.
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|note_agg_''N''}}
|Creates a footnote after the aggregate score of the ''N''th row of the table (excluding header rows). The parameter can contain either the contents of the note, or a reference to another note.
Notes can be reused across different rows and different types of notes (aggregate or leg). To reuse a note, set the value to the identifier of the original note (e.g., <code>agg_1</code> to reuse the aggregate note of row 1, or <code>leg2_5</code> to reuse the second leg note of row 5).
A list of all the notes will then be generated in the table footer.
If the value of the note parameter begins with a reference, footnote or superscript, it will be directly prepended to the aggregate score without creating a separate note. These cannot be reused like standard notes. This is useful if it is desired to use an outside note system, or reference a note that exists elsewhere on the page.
==== Example 13 ====
; Usage
<
|{{fb-rt|POL}}|5–1|{{fb|EST}}
|{{fb-rt|WAL}}|4–1|{{fb|FIN}}
|{{fb-rt|WAL}}|0–0 (aet) (4–5 p)|{{fb|POL}}
|note_agg_1=Played behind closed doors
|note_agg_3=agg_1
}}</syntaxhighlight>
; Output
{{#invoke:Sports series|main|
|{{fb-rt|POL}}|5–1|{{fb|EST}}
|{{fb-rt|WAL}}|4–1|{{fb|FIN}}
|{{fb-rt|WAL}}|0–0 (aet) (4–5 p)|{{fb|POL}}
|note_agg_1=Played behind closed doors
|note_agg_3=agg_1
}}
|String
|-
|style="text-align:center;vertical-align:top"|{{TOC tab|note_leg''X''_''N''}}
|Creates a footnote after the Xth leg score of the ''N''th row of the table (excluding header rows). The parameter can contain either the contents of the note, or a reference to another note.
Notes can be reused across different rows and different types of notes (aggregate or leg). To reuse a note, set the value to the identifier of the original note (e.g., <code>leg2_5</code> to reuse the second leg note of row 5, or <code>agg_1</code> to reuse the aggregate note of row 1).
A list of all the notes will then be generated in the table footer.
If the value of the note parameter begins with a reference, footnote or superscript, it will be directly prepended to the aggregate score without creating a separate note. These cannot be reused like standard notes. This is useful if it is desired to use an outside note system, or reference a note that exists elsewhere on the page.
==== Example 14 ====
; Usage
<
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4 (4–3 p)|[[Manchester City F.C.|Manchester City]]|ENG|3–3|1–1 (aet)
|'''[[Paris Saint-Germain FC|Paris Saint-Germain]]'''|FRA|w/o|[[FC Barcelona|Barcelona]]|ESP|2–3|Canc.
|note_leg1_2=Played behind closed doors.
|note_agg_4=Paris Saint-Germain were awarded a walkover victory after Barcelona refused to play the second leg.
|note_leg2_4=agg_4
}}</syntaxhighlight>
; Output
{{#invoke:Sports series|main
|[[Arsenal F.C.|Arsenal]]|ENG|2–3|[[FC Bayern Munich|Bayern Munich]]|GER|2–2|0–1
|[[Atlético Madrid]]|ESP|4–5|[[Borussia Dortmund]]|GER|2–1|2–4
|[[Real Madrid CF|Real Madrid]]|ESP|4–4 (4–3 p)|[[Manchester City F.C.|Manchester City]]|ENG|3–3|1–1 (aet)
|'''[[Paris Saint-Germain FC|Paris Saint-Germain]]'''|FRA|[[Walkover|w/o]]|[[FC Barcelona|Barcelona]]|ESP|2–3|Canc.
|note_leg1_2=Played behind closed doors.
|note_agg_4=Paris Saint-Germain were awarded a walkover victory after Barcelona refused to play the second leg.
|note_leg2_4=agg_4
}}
|String
|}
== Other features/notes ==
Please note that in order to display a row in the table, at least one cell of said row must have value that is not empty or whitespace (this includes the note parameters for the aggregate and leg score columns). Otherwise, the module will not create a row for that line and all others below it.
=== Team country codes ===
The country codes supplied for each club are by default wrapped into {{tl|fbaicon}}, based on Wikipedia's [[Wikipedia:WikiProject Flag Template|country data]] system of templates, and displayed next to each team.
=== Leg and aggregate scores ===
For the legs and aggregate scores, all incorrect types of dashes (such as a [[hyphen]], [[em dash]] or [[minus sign]]) will be converted to an [[en dash]] (–). This does not apply to dashes contained in the article title/section anchor portion of wikilinks. These cells will also have [[Help:Table#Nowrap|nowrap]] applied to them, as long as two or more sets of parentheses are not present.
In addition, the module will also automatically convert certain text (as it relates to how matches were decided) to wikilinks. The following are supported:
* <code>(X–Y p)</code>, <code>(X–Y pen)</code> or <code>(X–Y pso)</code> {{arrow}} <code><nowiki>(X–Y [[Penalty shoot-out (association football)|p]])</nowiki></code>
* <code>(aet)</code> or <code>(a.e.t.)</code> {{arrow}} <code><nowiki>([[Overtime (sports)#Association football|a.e.t.]])</nowiki></code>
* <code>(a)</code> or <code>(agr)</code> {{arrow}} <code><nowiki>([[Away goals rule|a]])</nowiki></code>
* <code>(w/o)</code> or <code>(w.o.)</code> {{arrow}} <code><nowiki>([[Walkover|w/o]])</nowiki></code>
; Usage
<pre>{{#invoke:Sports series|main|flag=n
|[[Valencia CF|Valencia]]|3-3 (3-2 p)|[[Deportivo Alavés|Alavés]]|2-1|1-2 (aet)
|[[CD Leganés|Leganés]]|2-2 (a)|[[Real Madrid CF|Real Madrid]]|0-1|2-1
}}</pre>
; Output
{{#invoke:Sports series|main|
|[[Valencia CF|Valencia]]|3-3 (3-2 p)|[[Deportivo Alavés|Alavés]]|2-1|1-2 (aet)
|[[CD Leganés|Leganés]]|2-2 (a)|[[Real Madrid CF|Real Madrid]]|0-1|2-1
}}
=== Null/nil leg scores ===
If a cell of one of the leg scores contains only <code>null</code>, the cell will only contain an [[em dash]] (—). If {{para|generate_links|y}}, then this em dash will be linked. However, if {{para|solid_cell|y}}, then the cell will be left empty and given a background color of {{bg|#BBBBBB|grey (#BBBBBB)}}.
If a cell of one of the leg scores contains only <code>nil</code>, the cell will not be generated.
These features are useful for rounds of competitions that have an inconsistent number of legs, for example competitions that have a possible [[Replay (sports)|replay]] or play-off match after two legs.
; Usage 1 (for null)
<pre>{{#invoke:Sports series|main
|[[İstanbul Başakşehir F.K.|İstanbul Başakşehir]]|TUR|1–3|[[F.C. Copenhagen|Copenhagen]]|DEN|1–0|0–3
|[[Olympiacos F.C.|Olympiacos]]|GRE|1–2|[[Wolverhampton Wanderers F.C.|Wolverhampton Wanderers]]|ENG|1–1|0–1
|[[Rangers F.C.|Rangers]]|SCO|1–4|[[Bayer 04 Leverkusen|Bayer Leverkusen]]|GER|1–3|0–1
|[[VfL Wolfsburg]]|GER|1–5|[[FC Shakhtar Donetsk|Shakhtar Donetsk]]|UKR|1–2|0–3
|[[Inter Milan]]|ITA|2–0|[[Getafe CF|Getafe]]|ESP|null|null
|[[Sevilla FC|Sevilla]]|ESP|2–0|[[AS Roma|Roma]]|ITA|null|null
|[[Eintracht Frankfurt]]|GER|0–4|[[FC Basel|Basel]]|SUI|0–3|0–1
|[[LASK]]|AUT|1–7|[[Manchester United F.C.|Manchester United]]|ENG|0–5|1–2
}}</pre>
; Output
{{#invoke:Sports series|main
|[[İstanbul Başakşehir F.K.|İstanbul Başakşehir]]|TUR|1–3|[[F.C. Copenhagen|Copenhagen]]|DEN|1–0|0–3
|[[Olympiacos F.C.|Olympiacos]]|GRE|1–2|[[Wolverhampton Wanderers F.C.|Wolverhampton Wanderers]]|ENG|1–1|0–1
|[[Rangers F.C.|Rangers]]|SCO|1–4|[[Bayer 04 Leverkusen|Bayer Leverkusen]]|GER|1–3|0–1
|[[VfL Wolfsburg]]|GER|1–5|[[FC Shakhtar Donetsk|Shakhtar Donetsk]]|UKR|1–2|0–3
|[[Inter Milan]]|ITA|2–0|[[Getafe CF|Getafe]]|ESP|null|null
|[[Sevilla FC|Sevilla]]|ESP|2–0|[[AS Roma|Roma]]|ITA|null|null
|[[Eintracht Frankfurt]]|GER|0–4|[[FC Basel|Basel]]|SUI|0–3|0–1
|[[LASK]]|AUT|1–7|[[Manchester United F.C.|Manchester United]]|ENG|0–5|1–2
}}
; Usage 2 (for null, {{para|solid_cell|y}})
<pre>{{#invoke:Sports series|main|solid_cell=y
|[[İstanbul Başakşehir F.K.|İstanbul Başakşehir]]|TUR|1–3|[[F.C. Copenhagen|Copenhagen]]|DEN|1–0|0–3
|[[Olympiacos F.C.|Olympiacos]]|GRE|1–2|[[Wolverhampton Wanderers F.C.|Wolverhampton Wanderers]]|ENG|1–1|0–1
|[[Rangers F.C.|Rangers]]|SCO|1–4|[[Bayer 04 Leverkusen|Bayer Leverkusen]]|GER|1–3|0–1
|[[VfL Wolfsburg]]|GER|1–5|[[FC Shakhtar Donetsk|Shakhtar Donetsk]]|UKR|1–2|0–3
|[[Inter Milan]]|ITA|2–0|[[Getafe CF|Getafe]]|ESP|null|null
|[[Sevilla FC|Sevilla]]|ESP|2–0|[[AS Roma|Roma]]|ITA|null|null
|[[Eintracht Frankfurt]]|GER|0–4|[[FC Basel|Basel]]|SUI|0–3|0–1
|[[LASK]]|AUT|1–7|[[Manchester United F.C.|Manchester United]]|ENG|0–5|1–2
}}</pre>
; Output 2 (for null, {{para|solid_cell|y}})
|[[İstanbul Başakşehir F.K.|İstanbul Başakşehir]]|TUR|1–3|[[F.C. Copenhagen|Copenhagen]]|DEN|1–0|0–3
|[[Olympiacos F.C.|Olympiacos]]|GRE|1–2|[[Wolverhampton Wanderers F.C.|Wolverhampton Wanderers]]|ENG|1–1|0–1
|[[Rangers F.C.|Rangers]]|SCO|1–4|[[Bayer 04 Leverkusen|Bayer Leverkusen]]|GER|1–3|0–1
|[[VfL Wolfsburg]]|GER|1–5|[[FC Shakhtar Donetsk|Shakhtar Donetsk]]|UKR|1–2|0–3
|[[Inter Milan]]|ITA|2–0|[[Getafe CF|Getafe]]|ESP|null|null
|[[Sevilla FC|Sevilla]]|ESP|2–0|[[AS Roma|Roma]]|ITA|null|null
|[[Eintracht Frankfurt]]|GER|0–4|[[FC Basel|Basel]]|SUI|0–3|0–1
|[[LASK]]|AUT|1–7|[[Manchester United F.C.|Manchester United]]|ENG|0–5|1–2
}}
; Usage 3 (for nil)
<pre>{{#invoke:Sports series|main|flag=n|legs=3|leg3=Play-off
|{{fb-rt|LUX}}|5–6|{{fb|DEN}}|3–3|2–2|0–1
|{{fb-rt|ESP|1945}}|7–1|{{fb|IRL}}|5–1|2–0|nil
|{{fb-rt|FRA}}|2–5|{{fb|HUN}}|1–3|1–2|nil
|{{fb-rt|SWE}}|2–4|{{fb|URS}}|1–1|1–3|nil
}}</pre>
; Output
{{#invoke:Sports series|main|
|{{fb-rt|LUX}}|5–6|{{fb|DEN}}|3–3|2–2|0–1
|{{fb-rt|ESP|1945}}|7–1|{{fb|IRL}}|5–1|2–0|nil
|{{fb-rt|FRA}}|2–5|{{fb|HUN}}|1–3|1–2|nil
|{{fb-rt|SWE}}|2–4|{{fb|URS}}|1–1|1–3|nil
}}
=== Simplified anchor links ===
Pages utilizing this module often include a wikilink with an [[WP:ANCHOR|anchor]] to the scores of the legs of a tie, linking to full match summaries.
Typically, when using anchored wikilinks, the page title can be omitted if the anchor appears on the same page. However, such links generally do not function properly when transcluded to other articles.
However, for this module, if any parameter contains an anchored wikilink that omits the page title (for example, <code><nowiki>[[#A vs B|2–2]]</nowiki></code>), the module will automatically insert the page title during transclusion to ensure proper linking. For proper functionality, the "sports series" module code must originate from the same page that contains the anchors.
=== Quasi-parameters ===
==== Plus sign (+) for country codes/flag variants ====
To allow for the use of flag variants, this module supports within the country code parameter the use of a plus sign (+) in between the country name/code and the name of the flag variant.
; Usage
<pre>{{#invoke:Sports series|main
|[[Atlético Madrid]]|ESP+1945|4–5|[[Borussia Dortmund]]|GER+empire|2–1|2–4
}}</pre>
; Output
{{#invoke:Sports series|main
|[[Atlético Madrid]]|ESP+1945|4–5|[[Borussia Dortmund]]|GER+empire|2–1|2–4
}}
==== Three apostrophes (<nowiki>'''</nowiki>) for manual bolding ====
While the template automatically bolds winning teams (unless {{para|bold_winner|n}}), in some situations the module will be unable to determine the winner. Or, some users may find it undesirable to have the module bold the winner automatically. In these cases, manual bolding can be used to indicate the winning team of a tie. This
This may be used in conjunction with the [[#Two apostrophes ('') for manual coloring|below method]] by using five apostrophes on either side of a team to bold and color the cell.
Line 537 ⟶ 686:
; Usage 1
<pre>{{#invoke:Sports series|main|
|{{fb-rt|LUX}}|5–6|'''{{fb|DEN}}'''|3–3|2–3
|'''{{fb-rt|ESP}}'''|7–1|{{fb|IRL}}|5–1|2–0
|{{fb-rt|FRA}}|2–5|'''{{fb|HUN}}'''|1–3|1–2
|{{fb-rt|SWE}}|2–4|'''{{fb|NOR}}'''|1–1|1–3
}}</pre>
; Output 1
{{#invoke:Sports series|main|
|{{fb-rt|LUX}}|5–6|'''{{fb|DEN}}'''|3–3|2–3
|'''{{fb-rt|ESP}}'''|7–1|{{fb|IRL}}|5–1|2–0
|{{fb-rt|FRA}}|2–5|'''{{fb|HUN}}'''|1–3|1–2
|{{fb-rt|SWE}}|2–4|'''{{fb|NOR}}'''|1–1|1–3
}}
; Usage 2 (third row overrides automatic bolding)
<pre>{{#invoke:Sports series|main|
|{{fb-rt|SWE}}|2–4|{{fb|NOR}}|1–1|1–3
|{{fb-rt|LUX}}|5–5 ([[Away goals rule|a]])|'''{{fb|DEN}}'''|3–3|2–2
|{{fb-rt|ESP}}|7–1|'''{{fb|IRL}}'''|5–1|2–0
}}</pre>
; Output 2 (third row overrides automatic bolding
{{#invoke:Sports series|main|
|{{fb-rt|SWE}}|2–4|{{fb|NOR}}|1–1|1–3
|{{fb-rt|LUX}}|5–5 ([[Away goals rule|a]])|'''{{fb|DEN}}'''|3–3|2–2
|{{fb-rt|ESP}}|7–1|'''{{fb|IRL}}'''|5–1|2–0
}}
==== Two apostrophes (<nowiki>''</nowiki>) for manual coloring ====
While the template allows for automatic coloring of the cells of winning teams via {{para|color_winner|y}}, in some situations (such as matches tied on away goals) the module will be unable to determine the winner. Or, some users may find it undesirable to use {{para|color_winner}} to color the winner automatically. In these cases, manual coloring can be used to indicate the winning team of a tie. This
This may be used in conjunction with the [[#Three apostrophes (''') for manual bolding|above method]] by using five apostrophes on either side of a team to color and bold the cell.
Line 576 ⟶ 725:
; Usage 1
<pre>{{#invoke:Sports series|main|
|{{fbw-rt|LUX}}|5–6|''{{fbw|DEN}}''|3–3|2–3
|''{{fbw-rt|ESP}}''|7–1|{{fbw|IRL}}|5–1|2–0
|{{fbw-rt|FRA}}|2–5|''{{fbw|HUN}}''|1–3|1–2
|{{fbw-rt|SWE}}|2–4|''{{fbw|NOR}}''|1–1|1–3
}}</pre>
; Output 1
{{#invoke:Sports series|main|
|{{fbw-rt|LUX}}|5–6|''{{fbw|DEN}}''|3–3|2–3
|''{{fbw-rt|ESP}}''|7–1|{{fbw|IRL}}|5–1|2–0
|{{fbw-rt|FRA}}|2–5|''{{fbw|HUN}}''|1–3|1–2
|{{fbw-rt|SWE}}|2–4|''{{fbw|NOR}}''|1–1|1–3
}}
; Usage 2 (third row overrides automatic coloring)
<pre>{{#invoke:Sports series|main|
|{{fbw-rt|SWE}}|2–4|{{fbw|NOR}}|1–1|1–3
|{{fbw-rt|LUX}}|5–5 ([[Away goals rule|a]])|''{{fbw|DEN}}''|3–3|2–2
|{{fbw-rt|ESP}}|7–1|''{{fbw|IRL}}''|5–1|2–0
}}</pre>
; Output 2 (third row overrides automatic coloring)
{{#invoke:Sports series|main|
|{{fbw-rt|SWE}}|2–4|{{fbw|NOR}}|1–1|1–3
|{{fbw-rt|LUX}}|5–5 ([[Away goals rule|a]])|''{{fbw|DEN}}''|3–3|2–2
|{{fbw-rt|ESP}}|7–1|''{{fbw|IRL}}''|5–1|2–0
}}
; Usage 3
<pre>{{#invoke:Sports series|main|
|{{fbw-rt|LUX}}|5–6|''{{fbw|DEN}}''
|''{{fbw-rt|ESP}}''|7–1|{{fbw|IRL}}
|{{fbw-rt|FRA}}|''2–2''|{{fbw|HUN}}
}}</pre>
; Output 3
{{#invoke:Sports series|main|
|{{fbw-rt|LUX}}|5–6|''{{fbw|DEN}}''
|''{{fbw-rt|ESP}}''|7–1|{{fbw|IRL}}
|{{fbw-rt|FRA}}|''2–2''|{{fbw|HUN}}
}}
|