WordPress plugin that helps photography clubs run recurring competitions, collect submissions, and manage voting.

• Clone the repository, then install PHP dependencies via composer install.
• From assets/, run npm install to set up the JavaScript toolchain.
• Start the local WordPress environment with npx @wordpress/env start and activate the plugin from the WordPress dashboard.

The plugin provides four main shortcodes for displaying competition functionality on your WordPress site.

1. Upload Form - [competition_upload]

• Allows members to upload images for the active competition
• Features: email verification, optional password gate, category selection, automatic image processing

2. Voting Interface - [competition_voting competition="slug"]

• Displays mobile-optimized voting interface for submitted images
• Features: position-based scoring, voter name collection, optional password gate, real-time validation

3. Complete Results - [competition_results] or [competition_results competition="slug"]

• Shows all competition results grouped by category and grade, sorted by score
• Parameters: competition (optional, defaults to most recent), hide_names (optional, hides member names)
• Features: category grouping, grade sub-grouping, responsive tables, clickable thumbnails

4. Top 3 Podium - [competition_top3] or [competition_top3 competition="slug"]

• Displays top 3 winners per grade in podium-style layout
• Features: category/grade grouping, gold/silver/bronze styling, responsive design

// Upload and voting
[competition_upload]
[competition_voting]
[competition_voting competition="october-2025"]

// Results for most recent competition
[competition_results]
[competition_top3]

// Results for specific competition
[competition_results competition="october-2025"]
[competition_top3 competition="october-2025"]

// Anonymous results (hide member names)
[competition_results hide_names="true"]

For detailed implementation guides, styling options, and troubleshooting, see SHORTCODE_USAGE.md.

Import multiple members at once using a CSV file. Access the import form from the Members admin page.

The importer supports two CSV formats:

Format 1: With Header Row (Recommended)

name,email,grade,active
"John Doe",john.doe@example.com,Beginner,1
"Jane Smith",jane.smith@example.com,Advanced,yes
"Bob Johnson",bob.johnson@example.com,Intermediate,0

Format 2: Without Header Row

John Doe,john.doe@example.com
Jane Smith,jane.smith@example.com
Bob Johnson,bob.johnson@example.com

Columns:

• Column 1: name - Member's full name (required)
• Column 2: email - Member's email address (required, must be valid and unique)
• Column 3: grade - Member's grade/skill level (optional)
• Column 4: active - Member status (optional: 1/yes/true/active = active, anything else = inactive)

• New Members: Email doesn't exist → new member created
• Existing Members: Email exists → member information updated
• Validation: Each row validated for required fields and email format
• Error Handling: Invalid rows skipped with detailed error messages

Download a sample CSV template from the Members admin page.

• Shortcode Usage: See SHORTCODE_USAGE.md for detailed examples and implementation guides

• Use npm run dev inside assets/ to watch and rebuild JS/CSS bundles; npm run build outputs minified assets.
• Run backend tests with composer test (PHPUnit) and lint PHP using composer lint.
• Execute JavaScript tests via npm run test:js inside assets/.
• The WordPress dashboard exposes a Competitions overview (with quick create/edit/archive flows) and a Members list sourced from custom tables; verify these pages after activating the plugin.
• The admin Submissions view lets you filter uploads by competition and member to audit entries quickly.

Open issues or feature requests using GitHub Issues, and include environment details plus reproduction steps. For security disclosures, reach maintainers through the private channels listed in the organization profile.