Club Competition Manager

A WordPress plugin for managing chess competition pairings, standings, and results for Schaakclub Santpoort.

Features

• Live competition viewer with standings and player stats
• Admin interface for round management, pairing generation, and result entry
• Keizer and round-robin pairing, with manual override
• KNSB rating integration (Dutch chess federation)
• Member accounts and invitations, separate from WordPress users
• Email notifications for invites, password resets and absences

Requirements

• WordPress 5.0+
• PHP 8.2+
• MySQL 5.7+
• Composer (for dependency management)

Installation

Build a zip with bin/package.sh and upload it in wp-admin under Plugins → Add New → Upload Plugin, choosing "Replace current with uploaded". Migrations run on plugins_loaded, so there is nothing to run afterwards.

Development

Setup

git clone <repo-url> /path/to/club-competition-plugin
cd /path/to/club-competition-plugin
composer install
npm install

Build Frontend

npm run build

Local Testing

dev/docker-compose.yml brings up WordPress, MySQL and Mailpit. Run PHP tooling (phpunit, phpstan, php-cs-fixer) inside that container — it has the PHP version production runs.

Architecture

• PHP Backend: Symfony components for validation, DI and CSRF
• Database: MySQL with Doctrine DBAL
• REST API: WordPress REST API with custom endpoints
• Frontend: React-based viewer and admin interface, one bundle
• Email: WordPress wp_mail integration

Tech Stack

License

GPL-2.0-or-later

Author

Paulo Moreno

Snapshots