Description
Photo Competition Manager provides everything photography clubs need to run professional competitions online:
Core Features
- Member Management – Maintain active rosters, assign grades, track member status, and bulk import/update via CSV
- Competition Setup – Create competitions from a competition type, which brings its own categories, submission quotas and scoring, with results grouped by the club’s grades
- Secure Submissions – Members upload via magic-link authentication with automatic file validation, resizing, and quota enforcement
- Flexible Voting – Members vote with emailed voting links or a shared password, or external judges score the images with their own private links. A full-screen slideshow shows the images on club nights
- Results Display – Full results tables with filtering, responsive top-3 podium displays, and customizable member name visibility
- Email Notifications – Automated emails for upload confirmations, voting invitations, results announcements, and custom templates with merge tags
- Setup Wizard – One-click page creation for upload, voting, results, and top-3 displays with pre-configured shortcodes
Advanced Capabilities
- Competition Types – Run more than one kind of competition, such as the monthly club competition and an annual cup, one at a time. Each type has its own categories, default settings and names for the club’s grades. A competition is open to everyone in its type, or only to the entrants you pick
- External Judging – Let invited judges score a competition instead of the members. Judges get a private link, Voting Controls shows who has scored, and each image’s total is the sum of the judges’ scores
- Interclub Competitions – Make a type’s entrants clubs. Each club enters a panel of images per category with each photographer named, with optional substitutes and a limit per photographer. Admins can disqualify entries and promote substitutes, and the results rank the clubs in each grade
- Voting Controls – Open/close voting by category, manage voter tokens, track submission and voting status per competition
- Results Analytics – View score distributions, voting participation, and competition statistics from the admin dashboard
- Recorded Results – Results are fixed when they’re published or the competition closes, so deleting a member or changing a grade later doesn’t rewrite past competitions
- Export Tools – Export results, votes and the list of entrants to CSV, and download the original images as a ZIP
- Privacy Tools – Members and judges are covered by WordPress’s Export Personal Data and Erase Personal Data tools, the privacy policy guide gets suggested text, and you choose how long logs are kept
- Repository Pattern – All data stored in dedicated database tables for performance, portability, and clean separation from WordPress content
Five Shortcodes, Unlimited Possibilities
[competition_upload]– Member upload form with quota tracking[competition_voting]– Interactive voting interface with live validation[competition_slideshow]– Full-screen presentation mode for club meetings[competition_results]– Complete results table with grade and category filtering[competition_top3]– Responsive podium display showcasing winners
Perfect for photography clubs, camera clubs, photo societies, and any organization running regular image competitions.
Captures d’écran










Installation
Quick Start
- Install via the Plugins screen on your WordPress site.
- Activate the plugin through Plugins Installed Plugins
- Navigate to Competitions Setup Wizard to auto-create pages with shortcodes
- Go to Competitions Settings to set the club’s grades, email and page addresses
- Go to Competitions Competition Types to set the categories, quotas and scoring. The plugin starts with one type, « Individual ». Add more only if you run different kinds of competition
- Add your members via Competitions Members (supports bulk CSV import)
- Create your first competition and start accepting submissions!
Manual Page Setup
If you prefer manual control, create pages with these shortcodes:
[competition_upload]– Member submission form[competition_voting]– Voting interface (voting links, password, or judges’ links)[competition_slideshow]– Full-screen slideshow for in-person voting[competition_results]– Complete results table[competition_top3]– Podium-style top 3 display
Shortcode Attributes
competition="slug"– Show a specific competition (results, top 3 and slideshow). The upload and voting pages always use the open competitioncategory="slug"– The category to show (slideshow, where it’s required)hide_names="1"– Leave out member names, and in interclub competitions the photographers, clubs and club standings (results only)
Building From Source
This plugin includes compiled JavaScript and CSS assets. The complete source code is available on GitHub:
https://github.com/donnchawp/photo-competition-manager
Source files are located in the assets/src/ directory. To build the assets:
- Navigate to the assets directory:
cd assets - Install dependencies:
npm install - For development (watch mode):
npm run dev - For production build:
npm run build
The plugin uses @wordpress/scripts for building and bundling assets. All source code can be reviewed, modified, and rebuilt from the repository.
Local Development
Run make up to launch the WordPress environment with Mailpit email capture at http://localhost:8026.
FAQ
-
How do members submit their photos?
-
Members receive a magic-link email with a unique upload URL. No passwords or login required. They simply click the link, select their category, and upload their images. The system automatically validates file types, dimensions, and enforces submission quotas.
-
Can I customize the voting system?
-
Yes. Each competition picks who scores it on its Settings tab:
1. Voting links – Members enter their email address on the voting page and get their own voting link
2. Password – Share a single password with all voters, for example at a club meeting while the slideshow runs
3. Judges – Invited judges score every image with their own private links, and members can’t vote -
How does external judging work?
-
Add the judges on Competitions Judges. They aren’t members and get none of the member emails. On the competition’s Settings tab, set « Who scores » to Judges and pick its judges. Each judge has a private link, which you can email with the Judge link email or open on the night. A judge scores every image in the open category from the competition’s score list, and Voting Controls shows which judges have scored. An image’s total is the sum of the judges’ scores.
-
What are competition types?
-
A competition type holds a kind of competition’s categories, default upload, voting and slideshow settings, and its own names for the club’s grades, for example « Cup » for Advanced. Every site starts with one type, « Individual », and with one type there’s nothing to choose. Add types on Competitions Competition Types when you run more than one kind of competition. Members are tagged with the types they enter, and a competition is open to everyone in its type or only to the entrants you pick from the type’s members on its Entrants tab.
-
Can clubs compete against each other?
-
Yes. Tick « Entrants are clubs » on a competition type. Each club is added as a member tagged with the type and enters a panel of images in each category, naming the photographer of every image. The type can allow substitutes and limit how many images one photographer has in a panel. On the Submissions screen an admin can disqualify an entry and promote a substitute. The results show each image as « Photographer — Club » and rank the clubs in each grade by each panel’s total and overall.
-
How do email notifications work?
-
The plugin sends automated emails for key events:
* Upload confirmations when members submit images
* Voting invitations with unique links or passwords
* Results announcements when competition closes
* Custom templates with merge tags (member names, competition titles, links, etc.)Configure and customize all templates from Competitions Email Templates. Each email sends the text that screen shows. Upload links, voting links and results emails always send. The voting opened and submission confirmed notifications are off until you switch them on.
Emails going to many members (upload links, voting opened, results, and results links) are sent 5 at a time by the admin page you sent them from, so a big send can’t time out a single request. The page shows progress while they go out, so keep it open until it says they’ve been sent. If you leave early, a notice on every admin page says where it stopped, with links to carry on without emailing anyone twice or to discard the rest. To change the batch size, define
CLUB_COMPETE_EMAIL_BATCH_SIZEinwp-config.php. -
Can I customize categories and grades per competition?
-
Categories, yes. Set the default categories, quotas, and scoring for each competition type in Competitions Competition Types. A new competition starts with its type’s, and can override them on its Settings tab without affecting future competitions.
Grades are set once for the club in Competitions Settings, and every competition uses them. A competition type can give them its own names. Renaming a grade renames it in every competition’s results, past ones included.
-
What if someone loses their magic link or voting token?
-
For uploads: Use the Upload Link action on the member’s row in Competitions Members to copy their link or send it again.
For voting: The member enters their email address on the voting page again. The new link replaces the earlier one.
-
Can I hide member names in the results?
-
Yes. The « competition_results » shortcode has an optional « hide_names » parameter. Set that to 1 to hide the names. In an interclub competition it also leaves out the photographers, clubs and club standings.
-
Does it work on mobile devices?
-
Yes! All shortcodes are fully responsive and tested on mobile devices. The top-3 podium display, voting interface, and upload forms adapt beautifully to small screens.
-
Where do uploaded images get stored?
-
Images are stored in
/wp-content/uploads/competitions/{competition-slug}/{category-slug}/. The plugin validates uploads and makes resized copies and thumbnails. The resized copies lose the photographer’s name from their EXIF, IPTC and XMP data, The voting page and slideshow load images by entry ID, so the file name, which includes the member’s name, never reaches voters. The originals keep their data. -
Can I export competition data?
-
Yes. Visit Competitions Export to download:
* The votes (CSV), with a row for each voter
* The members who uploaded, with their image IDs (CSV)
* The original images (ZIP), optionally deleting them afterwards to save spaceThe Results screen also downloads a competition’s results as a CSV.
-
How does the plugin handle members’ personal data?
-
Members and judges are included in Tools Export Personal Data and Tools Erase Personal Data. Erasing a member deletes their record, entries, links and log entries, and their votes still count without their name. Settings Privacy Policy Guide has suggested text saying what the club holds and why. Choose how long logs are kept in Competitions Settings. By default they’re kept forever.
Avis
Contributeurs & développeurs
« Photo Competition Manager » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
ContributeursTraduisez « Photo Competition Manager » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Historique des changements
0.4.0
-
Before you upgrade
- Back up the database first. The update runs eleven database upgrades (versions 1 to 11) on the first request after it’s installed.
- The upgrade puts every competition into a new competition type called « Individual », which holds the club’s current categories and upload, voting and slideshow settings. Every member is tagged with it and every competition stays open to all members, so nothing changes until you add a second type. Those settings move from Settings to the new Competition Types screen.
- Rolling back to 0.3.0 after upgrading loses the competition workflow state: whether uploads are closed or results published, and which voting stage each category has reached. 0.4.0 keeps it in its own database column, which 0.3.0 doesn’t read.
- On a site where members vote with emailed links, a member who asked for a link more than once has several. The upgrade keeps one per category, the one holding their ballot if they voted, and deletes the others along with any second ballot cast with them. It logs how many votes each competition lost.
- On sites installed before November 2025 the upgrade rebuilds the upload links’ database index so a member can have only one upload link per competition. A member who somehow has two keeps the earlier one, and the later emailed link stops working.
- The upgrade records the results of every competition whose results are published, or that has closed or been archived, from the entries and votes as they are when it runs. Entries already deleted, and members deleted before the upgrade, stay missing from those results.
-
Competitions
- Only one competition can be open at a time, with a new Close Competition action
- Competitions close at their close date, and overlapping dates are refused
- Setting an open competition’s close date to today in the edit form closes it when you save, and saving the form without changing the day keeps the time it closed
- Competitions use the club’s grade list, and the club’s categories when they have none of their own
- Voting Controls, Results and Submissions act on the current competition
- Archived competitions offer only what works on them: Restore, Reset Voting and Delete. Edit and Generate Results Link, which ended in « Competition not found », and the greyed Send Upload Emails are gone
-
Uploads and entries
- The upload page says why an upload or delete was refused, instead of « Upload failed. Please try again. »
- A file over the server’s upload limit is reported as too big, on the upload form and in batch upload
- When the server’s upload limit is lower than the competition’s, the upload page shows the server’s and refuses larger files with that figure
- The upload limit takes the server’s
post_max_sizeinto account too, and an upload over it is reported as too big instead of « Category assignments are required. » or no message at all - Drag-and-drop upload sends one image at a time, so a large selection no longer fails as a whole
- Drag-and-drop upload says an image is too big when the web server in front of WordPress refuses it, and stops after the first image if the upload link is refused
- When some images in a drag-and-drop batch fail, the page no longer reloads and hides the failures. The list stays on screen with a « Show my entries » button, and the images that went in leave the selection
- Moving entries between categories happens all at once or not at all
- A category takes no new entries once voting has started in it, or once it has votes
- Uploads can’t reopen once any category’s voting has started. Reset that category first
- An image is never saved or moved onto another entry’s file
- Deleting a competition or a member deletes their entry files too
- Originals are discarded one at a time and exported at full size
- An entry whose file is missing shows « Image unavailable », and the slideshow skips it
- Deleting a submission works in in-app browsers
- The upload page’s messages can be translated
- Drag-and-drop upload’s messages can be translated too, and say « 1 image » or « 2 images » instead of « image(s) »
- The voting page’s vote counter and missing-votes messages, and the upload page’s category-change messages, can be translated too, and say « 1 image » or « 2 images » instead of « image(s) »
- Drag-and-drop upload no longer says the quotas are full when images are added in a second go and there is room for them
- Drag-and-drop upload no longer hangs on « Uploading… » when one of the member’s categories was already full before the page loaded. It offers only the categories with room left
- A drag-and-drop batch’s summary is green only when every image went in. A batch where nothing went in says « No images were uploaded. » as an error, a mixed batch shows as a notice, and screen readers announce the outcome and any upload error
- Success and error messages on the upload, voting and results pages use darker text, so they’re easier to read
- The Submissions screen shows the submitted photos first, then the Submission Status table. With no submissions, the notice comes first and the table still shows who has opened their upload link
-
Voting
- A ballot counts only the category’s images, and each voter gets one ballot
- A ballot is stored whole or not at all: if it can’t be saved, the voter is asked to try again instead of being thanked with votes missing
- The voting link a member asks for has its own Voting Link email template, with every merge tag filled in
- The « Check If Voting Is Open » button keeps the voting token
- The page redirects after a ballot is cast, so reloading it doesn’t send the ballot again, and a second ballot shows one notice instead of two
- The voter’s name and the voting password are remembered on classic themes too
- An unanswered score is no longer counted as 0, and a score that isn’t in the list is refused with a message
- A ballot sent with an expired voting link says so, instead of being ignored
- Asking for a voting link again sends a link that works. It replaces the earlier one, and a member who has already voted is told so
- The voting page and the slideshow load images from an address made from the entry’s number, so a member’s name in the file name never reaches the browser
- Resized entry images and thumbnails lose the photographer’s name from their EXIF, IPTC and XMP data when they’re uploaded, and are turned upright first. The original keeps its data
-
External judging
- A competition can be scored by judges instead of members: set « Who scores » to Judges on the competition’s Settings tab
- A new Judges screen keeps each judge’s name and email. Judges aren’t members and get none of the member emails
- Pick a competition’s judges on its Settings tab. Each judge gets a private link, which you can email to them with the new Judge link email or copy and open on the night. It works only while the judge is picked and a category is open
- Judges score every image in the open category from the competition’s score list, and an image’s total is the sum of their scores
- Members can’t vote in a judged competition. They don’t get the Voting Opened email, and the upload email’s new
{voting_info}tag is left empty. A customised upload email that names the voting page in its own words still does, so before running a judged competition replace that text with{voting_info} - The detailed results email shows only an image’s total and position in a judged competition. Admins can still see each judge’s score on the Results screen and in the votes CSV, where each judge is named
- Voting Controls shows which judges have scored the open category, and its steps say the judges are scoring instead of the members voting
- Deleting a judge, or erasing them with Tools > Erase Personal Data, removes their name and email and every log entry about them. Their scores still count
-
Competition types
- A new Competition Types screen. Each type has its own categories, default upload, voting and slideshow settings, and can give the club’s grades its own names, for example Advanced shown as « Cup »
- A type can leave out some of the club’s grades: untick « Used by this type » on its form. Members in a grade it doesn’t use can’t enter or vote in its competitions, and the add and edit member forms explain how each type names and uses the grades. Results still show every grade that has entries
- Settings keeps only what’s club-wide: grades, email, page addresses, the voting form layout and log retention
- A new competition picks its type and starts with that type’s categories and settings. With only one type there’s nothing to pick. The type can be changed until the competition has entries, and changing it copies the new type’s settings
- Members are tagged with the types they enter. With one type this happens automatically. With more, the Members screen has a Types column, a type filter and bulk add or remove, CSV import takes a
typescolumn (the sixth column in a file without a header row), the sample CSV shows it, the import says how many new members it left without a type, and members with no type are flagged - A competition is open to everyone in its type, or to selected entrants only. Add entrants from the type’s members on the competition’s Entrants tab, for example once they’ve paid, or create a new member and enter them in one go, which adds them to the type. Only members of the type can be entered, and in an interclub competition the tab talks about clubs. An entrant added while uploads are open is sent their upload link. Who may enter can’t change once voting starts or the competition closes
- Only members who may enter a competition get its upload links and reminders, can use the upload page, or can upload through the REST API. In a selected-entrants competition only entrants can ask for a voting link
- The Voting Opened email and « Email results to all members » go to the competition type’s members
- Results pages, Top 3, emails and exports show the type’s grade names. Admin screens show both, for example « Cup (Advanced) »
- A competition title can include
{grade}, for example « SACC {grade} 2026 ». Each entrant sees their own grade’s name on their upload page and in their emails, and everywhere else shows the grade names joined, for example « SACC Cup / SACC Shield 2026 » - The Upload Confirmation email’s
{member_grade}shows the grade’s name instead of its slug
-
Interclub competitions
- A competition type can make its entrants clubs: tick « Entrants are clubs » on the type. Each club enters a panel of images in each category, and a panel holds as many images as the category’s quota
- Every image in an interclub competition names its photographer. The upload page, drag-and-drop upload, the REST API and the admin upload form all ask for it
- A type can take substitutes, extra images that can replace a disqualified one, and can limit how many images one photographer has in a panel. Substitutes don’t count towards that limit, and names match ignoring case and surrounding spaces
- The upload page lists each image’s photographer and marks its substitutes. When a panel has all its entries but room for a substitute, it says so and points to the Substitute box
- On the Submissions screen an admin can disqualify an entry, promote a substitute, reinstate a disqualified entry, or make an entry a substitute. A disqualified entry leaves the ballot and the results, and its votes stay but no longer count. The club still sees it on its upload page
- An entry can be disqualified until the competition’s results are recorded. The other changes follow the rules for adding an entry: only before the category’s voting starts, while it has no votes, and within the panel’s rules. Every change is logged
- Existing entries are entered, with no photographer
- Results show each image’s photographer with the club’s name, as « Photographer — Club », on the results page and the Top 3. The Results screen gives them their own Photographer and Club columns, and the results CSV adds a Photographer column
- Club standings rank each grade’s clubs by each panel’s total and by their overall total, with tied clubs sharing a place. A club that skipped a panel another club in its grade entered gets no overall place. The results page and the Results screen show the standings, and each club’s results email shows its own panels and place, such as « place 2 of 5 »
- A results page with
hide_namesleaves out photographers, clubs and the standings - An admin can correct or clear an entry’s photographer on the Submissions screen at any time, even after the results are recorded
- Each image in an interclub competition has its own number in its category, so a club’s images don’t share one. Regenerate Random Numbers shuffles them, and isn’t allowed once voting has started or while the competition has votes
-
Results
- Tied entries share a position in the results email
- The results CSV is ranked within each grade and category
- The votes CSV gives each voter who voted with a link their own row, labelled by their link (« Token #5 »). Before, they all shared one blank row and some of their votes were lost
- The votes CSV gives each of a member’s images in a category its own column, named with its file, such as « Image #7a (sunset.jpg) ». Before, only one of them had a column and the other’s votes were missing. The voting page and slideshow list a member’s images in the same order as the CSV
- The results and Top 3 pages show the latest published results, without vote counts
- The results table stacks into cards on mobile
- The detailed results email uses the email template system
- Results are recorded when they’re published, or the first time they’re needed after the competition closes. Deleting a member, removing an entry or changing a member’s grade afterwards moves nobody, and a deleted member’s entries show as « Former member » in their place, without an image
- Results can’t be hidden once the competition has closed. To correct them, move the close date into the future, then hide and publish them again
- Results hidden when the competition closes or is archived are recorded afresh the next time they’re needed, so votes cast and fixes made while they were hidden count
- Email Results and the results link to all members wait until results are shown or the competition has closed, so everyone is told the recorded positions. The committee’s link can still go first
- The Recalculate Scores button is gone: nothing used the score it saved
-
Members and email
- Upload and voting links are no longer sent to deactivated members, whose email addresses are now marked
- Bulk member emails go out in batches, and stopped email jobs show on every admin page
- Editors can use the Email Templates page
- Every email sends the text the Email Templates page shows, even on a site that has never saved it
- The Email Templates page stores only the templates you edit, so the rest pick up improved default text in later versions. Edited templates are marked « Edited », and Restore default fills in the default text for you to read and save. Templates saved before 0.4.0 are kept as they were: use Restore default on each one to pick up the new default text
- Only the Voting Opened and Submission Confirmed notifications can be switched off. Upload links, voting links and results emails always send
- Names and links are escaped in emails, and the detailed results table is no longer reformatted
- A site name with an ampersand or quotes appears as typed in email subjects, not as
& - The submission confirmation counts the image just uploaded
- Each sent email is logged under its kind of email and against its competition
- Saving the club settings no longer reassigns member grades, and every way of saving a member requires a club grade
- Every email, the Members and Submissions screens and the upload reminder link the voting, upload and results pages by one rule: the competition’s page, then the club’s, then a published page holding the plugin’s shortcode. Upload links are no longer built on the home page or a guessed address when no upload page is found; sending one says why instead
- Opening voting with the Voting Opened notification on but no voting page still opens voting, and tells the admin that members weren’t emailed
- The Voting Opened email links the competition’s own voting page ahead of the one in Settings. Competitions keep a copy of the page links from when they were created, so to change an existing competition’s link, edit the competition
- Deleting a member also deletes their upload and voting links and every log entry about them. The votes they cast still count, without their name. Tools > Erase Personal Data deletes a member the same way, found by their email address
- Tools > Export Personal Data includes what the plugin holds about a member: their record, entries, recorded results, the votes they cast and the emails sent to them. Settings > Privacy > Policy Guide suggests text saying what the club holds and why
-
Errors and logging
- Category change refusals return 400, 403 or 404 instead of 500
- Database errors and server paths are no longer shown to members; category change failures are logged as
category_change_failed - Originals that couldn’t be deleted are logged as
original_not_deleted - Clubs can choose how long logs are kept, in a new Logs section of Settings, and older log entries are deleted once a day. By default logs are kept forever, as before, so upgrading deletes nothing. The Logs screen says how long they’re kept
- Uninstalling removes email jobs, transients and cron events
-
Compatibility
- Requires WordPress 6.5
- Tested up to WordPress 7.1
0.3.0
- Fix fatal error on activation due to missing Admin_Dependencies class in release package
- Results Sharing — Share competition results via a secret link before making them public
- New « Generate Results Link » action on the Competitions page
- « Send to Committee » and « Send to All Members » buttons on the Results Dashboard
- Share link bypasses results visibility and resolves to the correct competition
- Committee Members — Mark members as committee via admin or CSV import
- Confirmation dialogs on hash regeneration and email sending to prevent accidental actions
0.2.0
-
Voting Controls Redesign
- Streamlined voting controls page with improved layout
- Added focus panel for managing individual categories
- Clear « Voting is Open/Closed » status headings
- Extended slideshow duration options (5s to 30s) with 20s default
-
Member Management
- New toggle button on Members page to enable/disable uploads
-
Results & Scoring
- Proper tie handling in admin results and scoring calculations
- Scores now stored as totals per category for accuracy
- Grades displayed in results emails and thumbnails
-
Exports
- Improved vote and uploader exports with category separation
- Aligned export columns across categories for better spreadsheet compatibility
-
Email
- Site name now prefixed to all email subjects for clarity
-
Bug Fixes
- Delete associated votes when deleting an image
- Normalized all times to UTC
- Proper cleanup of physical files and attachment posts on deletion
-
Compatibility
- Tested up to WordPress 6.9
0.1.0
-
Core Features
- Member management with CSV bulk import/export
- Competition creation with custom categories, grades, and scoring
- Magic-link authentication for secure member uploads
- Three voting modes: token-based, password-protected, and slideshow
- Full results tables and responsive top-3 podium displays
-
Admin Interface
- Setup wizard for automatic page creation
- Voting controls dashboard with category management
- Submission tracking and quota enforcement
- Results analytics and statistics
- CSV export for all competition data
-
Email System
- Automated upload confirmations
- Voting invitation emails with tokens
- Results announcement notifications
- Customizable templates with merge tags
- Template enable/disable controls
-
Frontend Shortcodes
[competition_upload]– Member submission form[competition_voting]– Interactive voting interface[competition_slideshow]– Full-screen presentation mode[competition_results]– Complete results table[competition_top3]– Responsive podium display
-
Technical
- Repository pattern with dedicated database tables
- Automatic image resizing and thumbnail generation
- Mobile-responsive frontend styles
- WordPress coding standards compliance
- PHPUnit test coverage for core functionality