Overview
This sample walks through a typical election, from setting up menus through to declaring winners. Every stage is controlled by the dates and times the administrator sets in the component's configuration options, so nothing happens until those dates are reached.
Assumptions
Nominations
- Any member can nominate any other member, or themselves.
- A nomination made by someone other than the nominee must be accepted or rejected by the nominee.
- Nominations can only be made once the nominations open date/time has passed.
- Nominations cannot be made once the voting booths are open.
- The administrator can choose whether an individual may be nominated for more than one position.
Voting
- By default, each membership (user login record) has one vote.
- The administrator can allow a user more than one vote by setting it in that user's custom fields.
Proxy Voting
- A proxy must be registered in advance: the principal voter registers another member as their delegate.
- Each member can register only one delegate.
- A delegate cannot pass the proxy on by registering a proxy of their own.
- When a delegate votes, their vote is duplicated on behalf of the principal voter.
- Both the principal voter and the delegate are notified when a proxy is registered.
Election Timeline
- Nominations open: members can nominate and nominees can accept or reject.
- Voting booths open: nominations close and voting begins.
- Voting booths close: no further votes can be cast.
- Winners declared: the administrator finalises the results.
Setting Up Menu Items
Menu Items give members access to each part of the process. Suggested items are:
- AGM Nominations: points to the list of nominations. Most of the voting process is managed from here.
- Roles & Responsibilities: points to the list of positions. Each position record can link to an article describing the duties of that role.
- Register a Proxy: lets a member delegate their vote to another member.
- List of Voters (optional): shows who has voted, but not who they voted for.
The Process
1. Nominations
The nominations list shows every member nominated for a position. If a nomination was made by someone other than the nominee, it appears in red text until the nominee accepts it. If the nominee rejects it, the nomination is removed from the list.
2. Voting
Once the Voting Booth Open date has passed, the green Add Nomination button is replaced by a yellow Cast Your Vote button. After a member casts their vote, the button disappears. If that member is registered as a proxy for another member, their vote is also recorded for the principal voter, as if the principal had voted themselves.
When the Voting Booth Close date has passed, the voting button disappears for everyone.
3. Declaring Winners
Users with permission to manage the election see a red Declare Winners button. When the administrator clicks it:
- the nominee with the most votes is saved to each position record;
- the position records are archived; and
- duplicate records are created for the next election, including a new Election Year category.
4. Resolving a Tie
If two or more nominees for a position finish with equal votes, the administrator casts a deciding vote to resolve the draw.