Add README and LICENSE

README.md

@@ -0,0 +1,115 @@
+# Go Form Plugin
+
+A WordPress plugin for managing Go (Baduk/Weiqi) tournament registrations. Collect player information through frontend forms and export entries to popular tournament management systems.
+
+## 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, and export entries
+
+## Installation
+
+1. Upload the `go-form-plugin` folder to your `/wp-content/plugins/` directory
+2. Activate the plugin through the 'Plugins' menu in WordPress
+3. 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
+- **Manage Forms** - View all forms with their shortcodes
+- **View Entries** - See all submissions for a form
+- **Delete Entries** - Remove individual registrations
+- **Delete Forms** - Remove a form and all its entries (cannot delete default form)
+- **Export Data** - Download entries in various tournament formats
+
+### 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 two tables:
+
+- `wp_go_form_forms` - Stores form definitions
+- `wp_go_form_entries` - Stores all player registrations
+
+Both tables are automatically removed when the plugin is uninstalled.
+
+## 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) |
+| Email | No | Email address |
+| EGD Number | No | European Go Database PIN |
+| Comment | No | Additional notes |
+
+## Hooks
+
+### Actions
+
+- `admin_post_go_form_handle_submission` - Form submission handler
+- `admin_post_go_form_delete_entry` - Delete entry handler
+- `admin_post_go_form_create_form` - Create form handler
+- `admin_post_go_form_delete_form` - Delete form handler
+- `admin_post_go_form_export_csv` - CSV export handler
+- `admin_post_go_form_export_pairgoth` - Pairgoth export handler
+- `admin_post_go_form_export_opengotha` - OpenGotha export handler
+- `admin_post_go_form_export_mcmahon` - McMahon export handler
+
+## Security
+
+- All forms use WordPress nonces for CSRF protection
+- Admin actions require `manage_options` capability
+- All input is sanitized using WordPress sanitization functions
+- Direct file access is blocked
+
+## Author
+
+Nikola Petrov