Add notification email

This commit is contained in:
2026-07-05 20:26:56 +02:00
parent 08ae633d01
commit 2f06a8a4f1
5 changed files with 72 additions and 220 deletions
-25
View File
@@ -1,25 +0,0 @@
WordPress plugin for managing Go (Baduk/Weiqi) tournament registrations. Collects player data via frontend forms and exports entries to tournament management systems (Pairgoth, OpenGotha, McMahon, CSV).
**Relevant files:**
- `main.php` - Plugin entry point with WordPress hooks
- `go-form-plugin/go-form-plugin.php` - Core plugin logic (forms, entries, EGD integration, exports)
- `go-form-plugin/database-schema.sql` - MySQL schema for 4 tables (forms, entries, custom_fields, entry_custom_values)
- `go-form-plugin/export/csv.php` - CSV export handler
- `go-form-plugin/export/pairgoth.php` - Pairgoth JSON export handler
- `go-form-plugin/export/opengotha.php` - OpenGotha XML export handler
- `go-form-plugin/export/mcmahon.php` - McMahon XML export handler
- `go-form-plugin/export/mcmahon-help.php` - McMahon documentation/reference
- `go-form-plugin/templates/form-shortcode.php` - Frontend form template
- `go-form-plugin/templates/settings-page.php` - Admin dashboard template
- `go-form-plugin/templates/table.php` - Entries table display
- `README.md` - Full documentation
**Nuances:**
- Ranks stored as integers (0-47): 0-29=30k-1k, 30-38=1d-9d, 39-47=1p-9p
- Rating auto-calculated: `rating = (rank * 100) - 900`
- EGD integration: searches `https://europeangodatabase.eu/EGD/GetPlayerDataByData.php` and `GetPlayerDataByPIN.php`
- Uses WordPress nonces, `manage_options` capability, `$wpdb->prepare()` for security
- Foreign keys with CASCADE delete
## To LLM
Update this file if the changes you have done are worth updating here. The intent of this file is to give you a rough idea of the project, from where you can explore further, if needed.
-182
View File
@@ -2,193 +2,11 @@
A WordPress plugin for managing Go (Baduk/Weiqi) tournament registrations. Collect player information through frontend forms and export entries to popular tournament management systems. 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 ## Installation
1. Upload the `go-form-plugin` folder to your `/wp-content/plugins/` directory 1. Upload the `go-form-plugin` folder to your `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress 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 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 ## Author
Nikola Petrov - nikola@petrovv.com Nikola Petrov - nikola@petrovv.com
## License
MIT License - See LICENSE file for details.
+1
View File
@@ -3,6 +3,7 @@
CREATE TABLE wp_go_form_forms ( CREATE TABLE wp_go_form_forms (
id int NOT NULL AUTO_INCREMENT, id int NOT NULL AUTO_INCREMENT,
name varchar(255) NOT NULL, name varchar(255) NOT NULL,
email varchar(255) DEFAULT NULL,
created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL, created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
PRIMARY KEY (id) PRIMARY KEY (id)
); );
+46 -10
View File
@@ -17,6 +17,7 @@ function go_form_activate()
dbDelta("CREATE TABLE $forms ( dbDelta("CREATE TABLE $forms (
id int NOT NULL AUTO_INCREMENT, id int NOT NULL AUTO_INCREMENT,
name varchar(255) NOT NULL, name varchar(255) NOT NULL,
email varchar(255) DEFAULT NULL,
created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL, created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
PRIMARY KEY (id) PRIMARY KEY (id)
) $charset;"); ) $charset;");
@@ -172,6 +173,7 @@ function go_form_handle_submission()
wp_die('Security check failed'); wp_die('Security check failed');
global $wpdb; global $wpdb;
global $ranks;
if (isset($_POST['form_id'])) { if (isset($_POST['form_id'])) {
$form_id = intval($_POST['form_id']); $form_id = intval($_POST['form_id']);
} else { } else {
@@ -230,16 +232,25 @@ function go_form_handle_submission()
} }
} }
// Send notification email // Send notification email if form has an email configured
// $to = 'nikola@petrovv.com'; $form = go_form_get_form_by_id($form_id);
// $subject = 'New Go Tournament Registration'; if (!empty($form->email)) {
$to = $form->email;
$subject = 'New Go Tournament Registration';
$message = "A new player has signed up:\n\n";
$message .= "Form: {$form->name}\n";
$message .= "Form ID: {$form_id}\n";
$message .= "Name: {$data['first_name']} {$data['last_name']}\n";
$message .= "Country: {$data['country']}\n";
$message .= "Club: {$data['club']}\n";
$message .= "Rank: {$ranks[$data['rank']]}\n";
$message .= "Rating: {$data['rating']}\n";
$message .= "EGD Number: {$data['egd_number']}\n";
$message .= "Date: " . date('Y-m-d H:i:s') . "\n";
// $message = "A new player has signed up:\n\n"; wp_mail($to, $subject, $message);
// $message .= "Form ID: {$form_id}\n"; }
// $message .= "Name: {$data['first_name']} {$data['last_name']}\n";
// wp_mail($to, $subject, $message);
wp_redirect($_SERVER['HTTP_REFERER']); wp_redirect($_SERVER['HTTP_REFERER']);
exit; exit;
@@ -299,7 +310,11 @@ function go_form_create_form()
go_form_admin_action('create_form'); go_form_admin_action('create_form');
if (isset($_POST['form_name']) && !empty($_POST['form_name'])) { if (isset($_POST['form_name']) && !empty($_POST['form_name'])) {
global $wpdb; global $wpdb;
$wpdb->insert("{$wpdb->prefix}go_form_forms", ['name' => sanitize_text_field($_POST['form_name'])]); $form_data = [
'name' => sanitize_text_field($_POST['form_name']),
'email' => isset($_POST['form_email']) ? sanitize_text_field($_POST['form_email']) : ''
];
$wpdb->insert("{$wpdb->prefix}go_form_forms", $form_data);
$new_form_id = $wpdb->insert_id; $new_form_id = $wpdb->insert_id;
$redirect_url = add_query_arg(array('page' => 'go-form-settings', 'form_id' => $new_form_id, 'created' => 1), admin_url('admin.php')); $redirect_url = add_query_arg(array('page' => 'go-form-settings', 'form_id' => $new_form_id, 'created' => 1), admin_url('admin.php'));
wp_redirect($redirect_url); wp_redirect($redirect_url);
@@ -311,6 +326,27 @@ function go_form_create_form()
} }
add_action('admin_post_go_form_create_form', 'go_form_create_form'); add_action('admin_post_go_form_create_form', 'go_form_create_form');
function go_form_update_form()
{
go_form_admin_action('update_form');
if (isset($_POST['form_id']) && isset($_POST['form_name']) && !empty($_POST['form_name'])) {
global $wpdb;
$form_id = intval($_POST['form_id']);
$form_data = [
'name' => sanitize_text_field($_POST['form_name']),
'email' => isset($_POST['form_email']) ? sanitize_text_field($_POST['form_email']) : ''
];
$wpdb->update("{$wpdb->prefix}go_form_forms", $form_data, ['id' => $form_id]);
$redirect_url = add_query_arg(array('page' => 'go-form-settings', 'form_id' => $form_id, 'updated_form' => 1), admin_url('admin.php'));
wp_redirect($redirect_url);
exit;
}
$redirect_url = add_query_arg(array('page' => 'go-form-settings'), admin_url('admin.php'));
wp_redirect($redirect_url);
exit;
}
add_action('admin_post_go_form_update_form', 'go_form_update_form');
function go_form_delete_form() function go_form_delete_form()
{ {
go_form_admin_action('delete_form'); go_form_admin_action('delete_form');
+25 -3
View File
@@ -7,6 +7,8 @@ if (isset($_GET['deleted']))
echo '<div class="notice notice-success"><p>Deleted!</p></div>'; echo '<div class="notice notice-success"><p>Deleted!</p></div>';
if (isset($_GET['created'])) if (isset($_GET['created']))
echo '<div class="notice notice-success"><p>Form created!</p></div>'; echo '<div class="notice notice-success"><p>Form created!</p></div>';
if (isset($_GET['updated_form']))
echo '<div class="notice notice-success"><p>Form updated!</p></div>';
if (isset($_GET['created_field'])) if (isset($_GET['created_field']))
echo '<div class="notice notice-success"><p>Custom field created!</p></div>'; echo '<div class="notice notice-success"><p>Custom field created!</p></div>';
if (isset($_GET['updated_field'])) if (isset($_GET['updated_field']))
@@ -37,9 +39,24 @@ if (isset($_GET['error']) && $_GET['error'] == 'egd_update_failed')
$form = go_form_get_form_by_id($selected_form_id); $form = go_form_get_form_by_id($selected_form_id);
$form_name = $form ? $form->name : 'Unknown Form'; $form_name = $form ? $form->name : 'Unknown Form';
echo "<h3> $form_name</h3>";
// Form info and edit UI
if ($form) {
echo '<div style="margin-bottom:20px; padding:15px; background:#fff; border:1px solid #ddd; border-radius:4px;">';
echo '<form method="post" action="' . admin_url('admin-post.php') . '">';
echo wp_nonce_field('go_form_update_form_action', 'go_form_update_form_nonce', true, false);
echo '<input type="hidden" name="action" value="go_form_update_form">';
echo '<input type="hidden" name="form_id" value="' . esc_attr($selected_form_id) . '">';
echo '<table class="form-table">';
echo '<tr><th><label for="form_name">Form Name:</label></th><td><input type="text" name="form_name" id="form_name" value="' . esc_attr($form->name) . '" required></td></tr>';
echo '<tr><th><label for="form_email">Notification Email:</label></th><td><input type="email" name="form_email" id="form_email" value="' . esc_attr($form->email ?? '') . '" placeholder="Optional email for signup notifications"></td></tr>';
echo '</table>';
echo '<p class="submit"><input type="submit" class="button button-primary" value="Update Form"></p>';
echo '</form>';
echo '</div>';
}
echo '<div style="margin-bottom:15px; display: flex; flex-wrap: wrap; gap: 10px;">'; echo '<div style="margin-bottom:15px; display: flex; flex-wrap: wrap; gap: 10px;">';
action_button('go_form_delete_form', 'Delete Form', 'Delete this form and ALL entries?', $selected_form_id); action_button('go_form_delete_form', 'Delete Form', 'Delete this form and ALL entries?', $selected_form_id);
action_button('go_form_export_csv', 'Export to CSV', 'Confirm Export', $selected_form_id); action_button('go_form_export_csv', 'Export to CSV', 'Confirm Export', $selected_form_id);
action_button('go_form_export_pairgoth', 'Export to Pairgoth', 'Confirm Export', $selected_form_id); action_button('go_form_export_pairgoth', 'Export to Pairgoth', 'Confirm Export', $selected_form_id);
@@ -225,6 +242,7 @@ if (isset($_GET['error']) && $_GET['error'] == 'egd_update_failed')
echo '<input type="hidden" name="action" value="go_form_create_form">'; echo '<input type="hidden" name="action" value="go_form_create_form">';
echo '<table class="form-table">'; echo '<table class="form-table">';
echo '<tr><th><label for="form_name">Form Name:</label></th><td><input type="text" name="form_name" id="form_name" required></td></tr>'; echo '<tr><th><label for="form_name">Form Name:</label></th><td><input type="text" name="form_name" id="form_name" required></td></tr>';
echo '<tr><th><label for="form_email">Notification Email:</label></th><td><input type="email" name="form_email" id="form_email" placeholder="Optional email for signup notifications"></td></tr>';
echo '</table>'; echo '</table>';
echo '<p class="submit"><input type="submit" class="button button-primary" value="Create Form"></p>'; echo '<p class="submit"><input type="submit" class="button button-primary" value="Create Form"></p>';
echo '</form>'; echo '</form>';
@@ -234,7 +252,11 @@ if (isset($_GET['error']) && $_GET['error'] == 'egd_update_failed')
foreach ($forms as $f) { foreach ($forms as $f) {
$url = add_query_arg(array('page' => 'go-form-settings', 'form_id' => $f->id), admin_url('admin.php')); $url = add_query_arg(array('page' => 'go-form-settings', 'form_id' => $f->id), admin_url('admin.php'));
echo '<li><a href="' . esc_url($url) . '">' . esc_html($f->name) . '</a> <span style="color:#888">(ID: ' . esc_html($f->id) . ')</span> - <small>Shortcode: <code>[go_form id=' . esc_html($f->id) . ']</code></small></li>'; echo '<li><a href="' . esc_url($url) . '">' . esc_html($f->name) . '</a> <span style="color:#888">(ID: ' . esc_html($f->id) . ')</span> - <small>Shortcode: <code>[go_form id=' . esc_html($f->id) . ']</code></small>';
if (!empty($f->email)) {
echo ' - <span style="color:#2271b1;">Email: ' . esc_html($f->email) . '</span>';
}
echo '</li>';
} }
echo '</ul>'; echo '</ul>';