Frequently asked questions¶
About the plugin¶
Is it in the WordPress.org plugin directory?¶
No. It is licensed to clubs directly and distributed as a release zip from its repository. That also means there is no automatic update channel — see Updating.
Will it work for my club?¶
It will fit an English grassroots football club without much argument, because it is built around how one works: date-of-birth squads with a squad secretary each, FA Numbers as the identity of a member, and a season everyone re-confirms. With English FA it also imports the FA Club Player Report and keeps the club's FA team registrations.
The further your club is from that shape, the more the vocabulary will grate. Nothing in it is sport-specific beyond the FA integration, but nothing in it is generic either.
Does it work on WordPress multisite?¶
It is a single-site plugin and has not been built or tested against a network. Nothing obviously prevents it, but treat that as untested rather than supported.
What happens to my data if I remove the plugin?¶
Deactivating keeps everything. Deleting the plugin from the Plugins screen runs its uninstall script, which drops every table it created — members, guardians, squads, seasons, registrations, payments and both logs. Back up first. See Deactivating and uninstalling.
Access and accounts¶
Do parents need a WordPress account?¶
No. Parents never get a WordPress account, and never see the admin. They sign in to the club's
account page at /account/ instead: they enter the email address the club holds for them and are
sent a sign-in link, which works once and lasts an hour. Once in, they can save a passkey on their
device so the next visit needs no email. A session lasts 30 days from the last visit.
Signed in, a parent sees their children at the club, with each child's registration and payment status for the active season and a link to register or set up payment where one is still needed. Companion plugins can add links there too, such as English FA's match invitations.
Confirming a season, setting up a payment and requesting a replacement link still work through the private links emailed to them, without signing in. The Account sign-in link email has to be switched on (Club Management → Email Settings → Emails) before anyone can sign in.
How many people can be a club admin?¶
As many as you like. They need an existing WordPress account, added under Club Management → Settings → Club Admins; every WordPress administrator is one automatically.
Can a squad secretary see other squads?¶
Not other squads, but they can see more than the members already in their own. A secretary can also open, read-only, any member who is eligible for one of their squads (the date of birth and squad type match), including that member's guardians' names, email addresses and mobile numbers. They also see waiting-list sign-ups suggested for their squads, with the parent's contact details, and can convert those or email the parent.
They cannot edit a member's record; corrections go to a club admin. The scoping is enforced in the plugin itself, not by hiding menu items, so editing a URL by hand does not get round it.
Can one person run two squads?¶
Yes. Put the same email address in the Squad secretary field on each squad. To hand a squad over, change that address.
Seasons and registration¶
What does "active season" actually change?¶
The registration form, the payments screens and most reporting default to it. You can pin the
registration form to a specific season with season_id if you need to run two at once — see
Shortcodes.
A parent has three children. Do they get three emails?¶
One. The approval link covers every child that parent has at the club, and the confirmation email lists all of the confirmed children together. This is deliberate: parents with several children are the ones most likely to give up on a form.
Can I confirm a member myself?¶
Yes, if you are a club admin. Record the parent's answer on the season's page (Club Management → Seasons → the season), for the parent who telephones rather than clicks. A squad secretary cannot record a yes or no: they can send the member's guardian the registration email from the squad page, and pass anything a parent tells them to a club admin.
A parent lost their link and it has expired¶
Point them at the page carrying [cpm_registration_request]. They can get a fresh link by email
address, or by giving the child's FA Number and date of birth. Either way the link is emailed to the
address the club holds; the FA Number route shows that address partly hidden so the parent knows
which inbox to check, and asks them to contact their squad admin if it is out of date.
Payments¶
Do I have to use GoCardless?¶
No. Everything else in the plugin works without it, and you can record offline payments against a member by hand. Without a GoCardless account you simply never open the payments settings.
Why is the money split into a registration fee and instalments?¶
Because that is how most clubs charge: something up front to secure the place, then the rest spread out. The plugin uses GoCardless Instant Bank Pay for the up-front fee and a Direct Debit mandate for the instalment plan, and tracks them separately because they fail separately.
Families join at different times of the year. Do I need a product for each?¶
No — set the product's Pricing to A monthly sub, counted from each member’s registration date. You give it a monthly amount, the day of the month it is collected on, and the date the subs run to (Subs run to), and the plugin works out the number of payments for each member from the day the club took them on. A family joining in November pays for the months that are left; one who joined in August pays for all of them, at the same monthly rate, off the same product. The product's total is not known up front, which is why the products list shows it as Varies by member.
The number of payments is settled by the registration date, not by when the parent gets round to setting the Direct Debit up — they are never quietly charged less for being slow.
A parent set their Direct Debit up weeks late. What happens to the months they missed?¶
Whatever the product's Missed months setting says. A Direct Debit cannot collect a date that has already gone, so a family taken on in September whose parent completes setup in late November has three subs that can no longer be taken on the day they fell due. All four options collect the same total; they differ in when, and in what the parent sees on their statement:
| Setting | What the family pays |
|---|---|
| Don’t collect them — start late and run on past the end date | Nothing extra. The whole run shifts to start at the next collection day and finishes a few months past the plan's end date. Same amount every month; the club waits longest. |
| Collect them at once, as soon as the Direct Debit allows | One larger debit on the earliest date the Direct Debit allows, then the rest as normal. Fastest, and the only option whose first debit does not land on the collection day. |
| Collect them at once, on the first collection day | The same larger debit, but riding on the first collectable collection day — so every debit for every family still lands on the same day of the month. |
| Spread them across the months that are left | Every remaining debit goes up by a share of what is owed. Nothing looks like a surprise; the money arrives over the rest of the plan. |
GoCardless notifies the parent in advance of every amount it is going to take, so a catch-up debit is never a shock on the day — but it is still the largest thing a family will see, which is why the default is not to collect arrears at all.
One squad pays different fees. Do I need a second product?¶
No — add a squad override on the existing product. See One squad paying something different.
Can I stop one member's instalments without stopping everyone's?¶
Yes. Instalment plans are listed individually and stopped one at a time.
Email¶
Why does bulk email go through a queue?¶
So a large send cannot time out. Messages are queued and drained in batches by a background job, with progress reported as it goes. It also means a site with no working cron will queue mail and never send it — see Troubleshooting.
Does every guardian get their own copy?¶
Yes. There is no shared To or CC line, and a parent with several children gets one email rather than one per child.
How long are emails kept?¶
Sent email is kept in the Email Log for 90 days and pruned automatically. The processing queue keeps finished rows for three days. Both are filterable — see Hooks and filters.
Can club email come from a real person rather than noreply@?¶
That is what Club Mailer is for: each volunteer with a WordPress account connects their own Outlook or Gmail mailbox and tagged messages go out as them, landing in their own Sent Items.
Running the site¶
Does it need cron?¶
Yes, in practice. The email queue, the payment emails to parents, the closing of unused payment
setup links, the log pruning and English FA's match invitation emails are all scheduled jobs.
WP-Cron is enough on a site with steady traffic; a quiet site is better off with a real cron job
calling wp-cron.php.
English FA's fixtures and results are the exception: they are not collected by a scheduled job on the site at all. Its collector, on a separate machine, pushes them in on its own schedule.
Is there a WP-CLI interface?¶
Some. Squads can be created and their secretaries set from the command line, and there are demo
data generators for development and staging (wp cpm generate, and wp ccp generate for Card
Payment). See WP-CLI commands.
Can I put demo data on a staging site?¶
Yes — wp cpm generate all builds a realistic dataset, wp cpm generate players adds just players
to the seasons and squads you have already set up, and wp cpm generate reset removes exactly what
they created. It refuses to run in a production environment, so it cannot touch a live club's
site. Details in WP-CLI commands.
Can another plugin add to the Squads screen?¶
Yes. Three actions and a filter let another plugin add panels and headline cards to Club Management → Squads, the plugin's home screen, without either plugin knowing about the other. See Hooks and filters.