View source for Module:Sandbox/Julius Schwarz/SeatsEUPPs/doc

{{Module rating|<!-- Values: pre-alpha • alpha • beta • release • protected • semiprotected  --  If a rating not needed/relevant, delete this template call -->}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->

== Description ==

This module provides the number or share of seats occupied by [[European political party|European political parties]] in various European institutions. Data is obtained from Wikidata.

Institutions covered are the [[European Parliament]], the [[European Commission]], the [[European Council]], and the [[European Committee of the Regions]].

Parties covered are all European political parties, meaning those duly registered with the [[Authority for European Political Parties and European Political Foundations]].

The module seeks to replace and improve upon:
* [[Template:EUCouncilcountEuropeanParty]], which focuses only on the European Council; and 
* [[Template:SeatsEUPPs]], which does not disaggregate seats by party.

== Usage ==

=== Acronyms ===

The following acronyms are used for institutions:
* European Parliament: EP
* European Commission: EC
* European Council: EUCO
* European Committee of the Regions: COR

The following acronyms are used for European parties:
* [[European People's Party]]: EPP
* [[Party of European Socialists]]: PES
* [[European Conservatives and Reformists Party|European Conservatives and Reformists]]: ECR
* [[Patriots.eu]]: Patriots
* [[Alliance of Liberals and Democrats for Europe Party]]: ALDE
* [[European Green Party]]: EGP
* [[Europe of Sovereign Nations (party)|Europe of Sovereign Nations]]: ESN
* [[European Left Alliance for the People and the Planet]]: ELA
* [[Party of the European Left]]: EL
* [[European Democratic Party]]: EDP
* [[European Free Alliance]]: EFA
* [[European Christian Political Movement]]: ECPM

In addition, four special parameters can be used instead of parties:
* all: for the seats of all European parties combined;
* none: for the seats not occupied by members of European parties;
* ind: for independent politicians on the European Council (only); and
* thisparty: to be used instead of a specific party name when the module is called from the page of a European political party.

In order to return the share of seats instead of their number, "%" or "share" must be added as a third parameter.

Notes: 
* the capitalisation of parameters does not matter; 
* given [[Template:Wikidata#Examples|the cost]] of calling Wikidata when using a specific eID (i.e., not calling Wikidata from a linked Wikipedia page), the special parameter "thisparty" should be used whenever this module is called from the page of a European party.

=== Structure ===

The module must always take one institution as its first argument. The second argument is for European parties or special parameters, and is optional. The third argument is to return the share, instead of the absolute number, and is optional.

* <code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|seats|institution<nowiki>}}</nowiki></code> provides the total number of seats of the institution given in argument;
* <code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|seats|institution|party<nowiki>}}</nowiki></code> provides the number of seats of the European party in the institution given in argument; 
* <code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|seats|institution|all<nowiki>}}</nowiki></code> provides the number of seats of all European parties in the institution given in argument;
* <code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|seats|institution|none<nowiki>}}</nowiki></code> provides the number of seats not occupied by European parties in the institution given in argument;
* <code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|seats|EUCO|ind<nowiki>}}</nowiki></code> provides the number of independent politicians in the European Council (only applicable to the European Council);
* <code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|seats|institution|thisparty<nowiki>}}</nowiki></code> provides the number of seats of the European party from which page the module is called in the institution given in argument; and
* <code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|seats|institution|party|%<nowiki>}}</nowiki></code> provides the share of seats of the European party in the institution given in argument -- this works ''mutatis mutandis'' with the four special parameters.

Note: "%" and "share" can be used interchangeably. 

=== Examples ===

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EP<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EP}}; total number of seats of the European Parliament

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EC|EPP<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EC|EPP}}; number of seats of the EPP in the European Commission

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EUCO|PES|%<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EUCO|PES|%}}; share of seats of the PES in the European Council

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EP|all<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EP|all}}; total number of seats occupied by European parties in the European Parliament

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EC|all|share<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EC|all|share}}; total share of seats occupied by European parties in the European Commission

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|COR|none<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|COR|none}}; number of seats not occupied by European parties in the European Committee of the Regions

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|COR|none|%<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|COR|none|%}}; share of seats not occupied by European parties in the European Committee of the Regions

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EUCO|IND<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EUCO|IND}}; number of seats occupied by independent Heads of State or Government in the European Council

<code><nowiki>{{</nowiki>#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EP|thisparty<nowiki>}}</nowiki></code> → {{#invoke:Sandbox/Julius Schwarz/SeatsEUPPs|main|EP|thisparty}}; number of seats occupied by in the European Parliament by the European party from which page the module is called (here, the module adequately gives out an error message)

<includeonly>{{Sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->

}}</includeonly>

<noinclude>
[[Category:Module documentation pages]]
</noinclude>