A WordPress plugin for managing Go (Baduk/Weiqi) tournament registrations. Collect player information through frontend forms and export entries to popular tournament management systems.

Version: 0.05

Features

Frontend Registration Form with shortcode support
EGD Database Integration - Search and auto-fill player data from the European Go Database
Rank Selection - Dropdown with ranks from 30k to 9p
Automatic Rating Calculation - Auto-computes rating from rank when needed
Multiple Export Formats - CSV, Pairgoth (JSON), OpenGotha (XML), McMahon (XML)
Multi-Form Support - Create and manage multiple registration forms
Admin Dashboard - View, delete, export entries, and manage forms
Custom Fields - Add unlimited custom fields (text, email, textarea, select, checkbox) to forms
Entry Editing - Edit existing registrations from admin panel
EGD Data Sync - Batch update rank and rating from EGD for all entries with EGD numbers
Responsive Design - Frontend form with grid layout

Installation

Upload the go-form-plugin folder to your /wp-content/plugins/ directory
Activate the plugin through the 'Plugins' menu in WordPress
A default form is automatically created on activation

Usage

Displaying a Form

Use the shortcode to display a registration form on any page or post:

[go_form id=1]

Replace 1 with your form ID. Find form IDs in the admin settings page.

Admin Settings

Navigate to Go Form in the WordPress admin menu to:

Create Forms - Add new registration forms with names
Manage Forms - View all forms with their shortcodes and IDs
View Entries - See all submissions for a form in a sortable table
Edit Entries - Modify existing player registrations
Delete Entries - Remove individual registrations
Delete Forms - Remove a form and all its entries (cascading delete)
Export Data - Download entries in various tournament formats
Manage Custom Fields - Add, edit, and delete custom fields per form
EGD Data Sync - Update rank and rating from EGD for all entries with EGD numbers

EGD Search

Players can click the "Search EGD" button on the frontend form to look up their information in the European Go Database. This auto-fills:

First Name
Last Name
Country
Club
Rank
EGD Number
Rating

Export Formats

Format	File Extension	Description
CSV	`.csv`	Standard spreadsheet format
Pairgoth	`.tour`	JSON format for Pairgoth pairing system
OpenGotha	`.xml`	XML format for OpenGotha tournament manager
McMahon	`.xml`	XML format for McMahon tournament system

Database

The plugin creates four tables:

wp_go_form_forms - Stores form definitions (id, name, created_at)
wp_go_form_entries - Stores all player registrations with Go-specific fields
wp_go_form_custom_fields - Stores custom field definitions per form
wp_go_form_entry_custom_values - Stores custom field values for each entry

All tables use foreign keys with CASCADE delete and are automatically removed when the plugin is uninstalled.

Rank System

Ranks are stored as integers (0-47) mapping to:

0-29: 30k to 1k
30-38: 1d to 9d
39-47: 1p to 9p

Rating auto-calculation: rating = (rank * 100) - 900

Requirements

WordPress 5.0 or higher
PHP 7.4 or higher
MySQL 5.6 or higher

Fields Collected

Field	Required	Description
First Name	Yes	Player's first name
Last Name	Yes	Player's last name
Country	Yes	Country code (2-3 letters)
Club	Yes	Club name
Rank	Yes	Go rank (30k to 9p)
Rating	No	EGD rating (auto-calculated from rank if missing)
EGD Number	No	European Go Database PIN

Hooks

Actions

Form Handling:

admin_post_go_form_handle_submission - Frontend form submission handler
admin_post_go_form_update_entry - Update entry from admin panel

Form Management:

admin_post_go_form_create_form - Create new form
admin_post_go_form_delete_form - Delete form and all its entries

Entry Management:

admin_post_go_form_delete_entry - Delete single entry

Custom Fields:

admin_post_go_form_create_custom_field - Create custom field
admin_post_go_form_update_custom_field - Update custom field
admin_post_go_form_delete_custom_field - Delete custom field

EGD Integration:

admin_post_go_form_update_egd_data - Batch update entries from EGD database

Export:

admin_post_go_form_export_csv - CSV export handler
admin_post_go_form_export_pairgoth - Pairgoth JSON export handler
admin_post_go_form_export_opengotha - OpenGotha XML export handler
admin_post_go_form_export_mcmahon - McMahon XML export handler

Filters

None currently available.

Custom Fields

Each form can have unlimited custom fields with the following types:

Type	Description	Options
`text`	Single line text input	-
`email`	Email address input with validation	-
`textarea`	Multi-line text input	-
`select`	Dropdown selection	Comma-separated options
`checkbox`	Checkbox (yes/no)	-

Custom Field Settings

Public - Display on frontend form
Required - Mandatory field
Full Width - Display outside the grid layout

Security

All forms use WordPress nonces for CSRF protection
Admin actions require manage_options capability
All input is sanitized using WordPress sanitization functions (sanitize_text_field, sanitize_textarea_field, intval)
Direct file access is blocked with ABSPATH check
Database operations use $wpdb->prepare() for SQL injection prevention

API Integration

European Go Database (EGD)

The plugin integrates with the European Go Database for player data:

Search API: https://europeangodatabase.eu/EGD/GetPlayerDataByData.php?lastname=X&name=Y
Player Data API: https://europeangodatabase.eu/EGD/GetPlayerDataByPIN.php?pin=XXXX

Fields retrieved from EGD:

Name, Last Name
Country Code
Club
Grade (rank text)
Grade_n (rank numeric)
Gor (rating)
Pin_Player (EGD PIN)

Author

Nikola Petrov - nikola@petrovv.com

License

MIT License - See LICENSE file for details.