Swiss Tourney WordPress Plugin
Swiss Tourney is a WordPress Plugin I’ve been working on for awhile. It’s been a trial and error (mostly errors). I dubbed this as good enough and wanted to release it to the public – so please try it out and give me your thoughts. I do not intend to make Swiss Tourney into something elaborate, as that’s too time-consuming. I intend to make it as lightweight and easy to use as possible – I hope I’ve achieved that.
This is a swiss-style pairing algorithm where users sign up/register (either with active Player ID numbers or have the system generate one for them), email addresses for notification purposes, and their full name. The administrator will then lock the number of players and auto-generate the pairings.
Installing the WordPress Plugin
- Upload the plugin files to the
/wp-content/plugins/swiss-tourney/directory, or install via the WordPress plugins screen. - Activate the plugin through the ‘Plugins‘ screen in WordPress.
- Create a page and insert the desired shortcodes.
You can download the plugin for free at my GitHub.
Shortcodes
[swiss_register tournament="1"] — Player registration form
[swiss_standings tournament="1"] — Show standings (auto-detects latest round)
[swiss_pairings tournament="1"] — Show pairings (auto-detects latest round)
[swiss_countdown tournament="1"] — Show countdown timer for current roundIf no tournament ID is specified, the active tournament will be used.
Creating a Tournament
Creating a new Tournament for players is as easy as entering the name of the tournament, and entering the number of desired rounds.
Existing Tournaments
If there is an existing tournament that has been used previously – the admin can set that as active. After setting it as active, you can click Manage Rounds to initiate pairings.
Alternatively, you can also Delete Tournaments that you no longer use.
Registration Form
The Registration will be displayed on the frontend once a Tournament has been created and selected as “Set Active“.
Each player are required to fill out the First Name, Last Name.
Email Address is optional, but if entered, an email is sent out to players on who their next round pairing is.
Player ID is also optional. If not filled out, a generated one will be filled out for that player (please note they’re not official IDs if associated to an official game).
Note: Registration Forms are closed once a tournament start.
Countdown Timer
The Countdown Timer allows the admin to start, stop, or reset the countdown timer for the active tournament.
Round Pairing & Results
Round Pairing & Results is where the admin can enter the results of the match rounds.
Results that can be selected from the dropdown:
- A Wins (Player A wins)
- B Wins (Player B wins)
- Draw (both choose to neither win/lose by the time the timer runs out)
Please make sure to click “Save Results” after entering the results to update the current player list so it can total the number of points for each player.
Players
On the backend, the admin has the ability to view the current list of players with an option to Drop specific players. This is if a player chooses to Drop from the current, active tournament.
It also lists the current total points and their Win/Loss/Draw throughout the tournament.
Lock & Generate Pairing
This will load the next round.
By entering the Round Number and clicking on “Lock & Generate Pairings” it will initiate and update the front page with the latest pairings.
Closing Remarks for Swiss Tourney Plugin
This is my very first plugin. So I understand that there may still be existing bugs and improvements to be made. If there are any, I hope there will be others out there to point out what can minimally be done for improvements and not just point out massive changes that are meant for large groups of tournament players. This plugin’s focus is for smaller, personal groups and not pro-level institutions.
For other articles on the site, look here.