Template:MMP election box/doc

This page is the documentation for MMP election box templates, currently used for New Zealand general elections (since 1996) and elections to the Scottish Parliament (since 1999).

These Election box templates are for displaying a list of candidates and results for an electorate in an MMP election. They contain examples of code that wiki-editors can copy and paste (and edit) to produce the tables shown below. The entries are sorted by descending candidate vote, and then by party vote:

2007 Scottish Parliament election: Kilmarnock and Loudoun
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%
	SNP	Willie Coffey		14,297	42.8	+6.6	12,147	36.31	+9.03
	Labour	N Margaret Jamieson		12,955	38.8	-1.4	12,146	36.31	-0.93
style="background-color: Template:Scottish Conservatives/meta/color; width: 5px;" |	Conservative	Janette McAlpine		4,127	12.3	+1.9	3,894	11.64	+0.22
style="background-color: Template:Scottish Liberal Democrats/meta/color; width: 5px;" |	[[Scottish Liberal Democrats|Template:Scottish Liberal Democrats/meta/shortname]]	Ron Aitken		2,056	6.2	+1.2	1,643	4.91	-1.02
style="background-color: Template:Scottish Greens/meta/color; width: 5px;" |	[[Scottish Greens|Template:Scottish Greens/meta/shortname]]						820	2.45	-1.89
style="background-color: Template:Scottish Senior Citizens Unity Party/meta/color; width: 5px;" |	[[Scottish Senior Citizens Unity Party|Template:Scottish Senior Citizens Unity Party/meta/shortname]]						721	2.16	-2.08
style="background-color: Template:Solidarity (Scotland)/meta/color; width: 5px;" |	[[Solidarity (Scotland)|Template:Solidarity (Scotland)/meta/shortname]]						430	1.29	+1.29
style="background-color: Template:British National Party/meta/color; width: 5px;" |	BNP						400	1.20	+1.20
style="background-color: Template:Scottish Christian Party/meta/color; width: 5px;" |	[[Scottish Christian Party|Template:Scottish Christian Party/meta/shortname]]						258	0.77	+0.77
style="background-color: Template:Socialist Labour Party (UK)/meta/color; width: 5px;" |	[[Socialist Labour Party (UK)|Template:Socialist Labour Party (UK)/meta/shortname]]						240	0.72	-0.96
	Publican Party						159	0.47	+0.47
style="background-color: Template:Scottish Socialist Party/meta/color; width: 5px;" |	[[Scottish Socialist Party|Template:Scottish Socialist Party/meta/shortname]]						155	0.46	-5.22
style="background-color: Template:Christian Peoples Alliance/meta/color; width: 5px;" |	[[Christian Peoples Alliance|Template:Christian Peoples Alliance/meta/shortname]]						140	0.41	+0.41
	NHSFirst						119	0.36	+0.36
style="background-color: Template:UK Independence Party/meta/color; width: 5px;" |	[[UK Independence Party|Template:UK Independence Party/meta/shortname]]						94	0.28	+0.06
style="background-color: Template:Scottish Unionist Party (1986)/meta/color; width: 5px;" |	[[Scottish Unionist Party (1986)|Template:Scottish Unionist Party (1986)/meta/shortname]]						83	0.25	-0.15
Informal votes				1,018			1,004
Total Valid votes				33,435			33,449
Turnout				34,453	56.68	+4.75
	SNP gain from Labour		Majority	1,342	4.0	+0.16

Template coding for MMP elections

Table heading

All tables start with:

{{MMP election box begin
|title=[[Election name|Election type (year)]]: Electorate name<ref>Reference webpage</ref>
}}

Example

{{MMP election box begin |title=[[New Zealand general election, 2008|General election, 2008]]: [[Electorate name]]<ref>[http://www.electionresults.org.nz/electionresults_2008/electorate-1.html election result Auckland Central 2008]</ref>}}

Which gives

General election, 2008: Template:NZ electorate link[1]
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%

Winning candidate

Then either incumbent or candidate wins:

{{MMP election box incumbent win|
|party = Party Name
|candidate = [[Candidate name]]
|votes = 
|percentage = 
|change = 
|party votes = 
|party percent = 
|party change = 
}}

{{MMP election box candidate win|
|party = Party Name
|candidate = [[Candidate name]]
|votes = 
|percentage = 
|change = 
|party votes = 
|party percent = 
|party change = 
}}

General Election 2008: Template:NZ electorate link
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%
	Labour	Y Candidate Name

General Election 2008: Botany
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%
	National	Candidate Name

Losing candidates

Followed by losing candidates - who currently fall into six types:

• Incumbent loses but is elected as list MP
• Incumbent loses and is not elected as list MP
• Candidate loses but is elected as list MP
• Candidate loses and in not elected as list MP
• Non-registered or local party candidate loses
• Historic party candidate loses

Independents use the independent template below. For non-registered parties use {{MMP election box local party candidate}}.
For historic MMP parties that don't have assigned colors or shortnames (i.e. those with no meta/color or meta/shortname pages) use {{MMP election box historic party candidate}}. In New Zealand this only applies to minor parties from the 1996 and 1999 elections that became defunct before the 2002 election.
For list-only registered parties (i.e. without a candidate) use the party only or historic party only templates.

Incumbents

{{MMP election box incumbent lose list|
|party = Party Name
|candidate = [[Candidate Name]]
|votes = 
|percentage = 
|change = 
|party votes = 
|party percent = 
|party change = 
}}

{{MMP election box incumbent lose|
|party = Party Name
|candidate = [[Candidate Name]]
|votes = 
|percentage = 
|change = 
|party votes = 
|party percent = 
|party change = 
}}

Candidates, registered parties & Independents

{{MMP election box candidate list|
|party = Party Name
|candidate = [[Candidate Name]]
|votes = 
|percentage = 
|change = 
|party votes = 
|party percent = 
|party change = 
}}

{{MMP election box candidate lose|
|party = 
|candidate = [[Candidate Name]]
|votes = 
|percentage = 
|change = 
|party votes = 
|party percent = 
|party change = 
}}

{{MMP election box independent|
|candidate = Candidate Name
|votes = 
|percentage = 
|change = 
}}

Miscellaneous candidates

{{MMP election box local party candidate|
|color = Color #value or Name
|party = Party Name
|candidate = [[Candidate Name]]
|votes = 
|percentage = 
|change = 
}}

{{MMP election box historic party candidate|
|color = Color #value or Name
|party = Party Name
|candidate = [[Candidate Name]]
|votes = 
|percentage = 
|change = 
|party votes = 
|party percent = 
|party change = 
}}

Example

General election, 1996: Auckland East
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%
	Labour	John A. Lee
	Liberal	N Arthur Myers
	Independent	John Smith
	Nimby Party	A. Citizen
	Forgotten Party (1996)	Candy Date

Parties without electorate candidates

For parties that are not contesting the electorate vote, but only the party vote, use the following:

{{MMP election box party only|
|party = Party Name
|party votes = 
|party percent = 
|party change = 
}}

Example

General election, 1996: Auckland East
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%
	Labour	John A. Lee
	Liberal	N Arthur Myers
	Independent	John Smith
	Destiny

Miscellaneous candidates/parties without meta data

{{MMP election box historic party only|
|party = Party Name
|color = Color #value or Name
|party votes = 
|party percent = 
|party change = 
}}

Total votes

Voting is tallied in three tables; informal votes, total votes and turnout

{{MMP election box informal vote|
|votes = 
|party votes = 
}}

{{MMP election box total vote|
|votes = 
|party votes = 
}}

{{MMP election box turnout|
|turnout = 
|percentage = 
|change = 
}}

If you don't find turnout, don't worry, just don't use the template.

General election, 2008: Auckland East
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%
	Labour	Y Candidate Name
Informal votes				450			225
Total Valid votes				19,000			19,500
Turnout				19,562	68.25	+0.65

Seat's status and majority

The seat's status is either hold (party retains control of seat), gain (party gains seat from incumbent party), or win (party wins new seat). Majority is expressed as both a total and a percentage, and as a percentage change (swing) from previous election.

{{MMP election box majority hold|
|winner = Party Name
|votes = 
|percent = 
|change =
}}

{{MMP election box majority gain|
|winner = Party Name
|loser = Party Name
|votes = 
|percent = 
|change = 
}}

{{MMP election box majority win|
|winner = Party Name
|votes = 
|percent =
}}

General election, 2008: Auckland East
Notes:		Blue background denotes the winner of the electorate vote. Pink background denotes a candidate elected from their party list. Yellow background denotes an electorate win by a list member, or other incumbent. A Y or N denotes status of any incumbent, win or lose respectively.
Party		Candidate		Votes	%	±%	Party votes	%	±%
	Labour	Y Candidate Name
Informal votes				450			225
Total Valid votes				19,000			19,500
	Labour hold		Majority

Template list

• {{MMP election box begin}}
• {{MMP election box incumbent win}}
• {{MMP election box incumbent lose}}
• {{MMP election box incumbent list}}
• {{MMP election box other incumbent win}}
• {{MMP election box candidate win}}
• {{MMP election box candidate list}}
• {{MMP election box candidate lose}}
• {{MMP election box local party candidate}}
• {{MMP election box historic party candidate}}
• {{MMP election box independent}}
• {{MMP election box party only}}
• {{MMP election box historic party only}}
• {{MMP election box informal vote}}
• {{MMP election box total vote}}
• {{MMP election box turnout}}
• {{MMP election box majority hold}}
• {{MMP election box majority gain}}
• {{MMP election box majority win}}

See also

{{MMP by-election box}}
Index of New Zealand political party meta attributes
Index of United Kingdom political parties meta attributes