Skip to content

Troubleshooting

Symptoms in the order they tend to come up, with the check that settles each one quickly.

Email

Nothing sends at all

Work down this list; it is almost always the first item.

  1. Is From Email set? Club Management → Email Settings → Sending. The plugin refuses to send until it has one, and it must be an address your provider will send as.
  2. Is logging-only mode still on? Same screen. In logging-only mode every email is recorded in the Email Log and redirected to a single test address. The log will look busy and healthy while no parent has received anything.
  3. Does a test send work? Email Settings → Sending → Send test email. Save the settings first — the test uses what is stored, not what is on screen.
  4. Is WP-Cron running? Bulk sends are queued and drained in the background. On a site with DISABLE_WP_CRON set and no real cron job, mail queues and never leaves.

Bulk sends queue but never arrive

The queue is drained by a scheduled job. If the site has WP-Cron disabled without a system cron replacing it, nothing drains it.

# What is scheduled, and when it is next due
wp cron event list | grep cpm

# Force the queue to drain now
wp cron event run cpm_process_email_queue

The right fix is a real cron job hitting wp-cron.php every few minutes. Processed queue rows are pruned after three days, so an old backlog will not be sitting there to inspect.

Emails send but bounce

Club Management → Email Settings → Email Log records every send, and — if you are on Elastic Email with the feedback webhook configured — every bounce and spam complaint reported afterwards. A bounced address also raises an Undelivered warning against the season registration rows it affects, which is how you tell "the parent is ignoring us" apart from "we have the wrong address".

If bounces never appear, the webhook is not wired up: paste the URL from Settings → Club Mailer → Site-wide sending into Elastic Email under Settings → Notifications, and enable Bounce/Error and Complaints. If the admin screens say Elastic Email sending has moved to Club Mailer, Club Mailer is not active (or is out of date), and mail is going out through default WordPress mail.

In order of likelihood: the address on the guardian record is wrong (check the Email Log for a bounce), the mail is in their spam folder, or they have it and did not recognise it. Rather than resending blind, point them at the page carrying [cpm_registration_request] — they can request a fresh link themselves, by email address or by the child's FA Number and date of birth.

Access

A squad secretary cannot see their squad

The link between a squad and its secretary is the email address, not a WordPress role. Three things all have to be true:

  1. The person has a WordPress account on the site.
  2. That account's email exactly matches the Squad secretary field on the squad.
  3. They are signed in as that account.

The address is stored lower-cased and compared that way, so capitalisation is not the problem — a different address is. Check the squad's detail page, and check the account's email under Users.

A club admin cannot see Payments or Settings

Club admins are granted on Club Management → Settings → Club Admins, and the account has to exist first. Any WordPress administrator is a club admin automatically; anyone else needs adding explicitly. Squad secretaries never see Seasons, Settings, Payments, Guardians, Import or the club-wide email screens — that is by design, not a permissions fault.

Members and importing

The import did not place a child in a squad

Imports never place anyone in a squad by date of birth. The club's own spreadsheet (Members → Import Members) takes each member's squad from its Squad column only; a row with a blank, unknown or ineligible squad imports the member without one, and the upload result says so. The FA Club Player Report import (English FA) does not set squads at all.

To place the members who came in without a squad, use Club Management → Actions, which lists each of them as "Put … in a squad", or the Eligible members already in the club list on the squad's own page. A squad's date-of-birth range decides which members are suggested there.

The import created a second copy of a member

Members are matched on FA Number, and the club's own spreadsheet also matches on name and date of birth when there is no FA Number, so a re-import updates the existing record. A duplicate usually means the two rows carry different FA Numbers, or different spellings of the name — for example one was added by hand before the FA report caught up, or the child appears in the report twice with a corrected number.

Members → Find Duplicates surfaces likely pairs and merges them. Merge before payment history accumulates against both records.

A child left the club and keeps reappearing

Use Left the Club on their member page rather than deleting them. A delete only lasts until the next import puts them back.

Payments

A member is stuck at "Awaiting bank"

That status means the guardian has done their part and GoCardless has not yet confirmed. It resolves on its own — unless the plugin is not hearing from GoCardless at all, which looks identical.

Check Payments → Settings: the GoCardless webhook URL shown there (/wp-json/cpm/v1/gc-webhook) has to be registered in the GoCardless dashboard, and the site has to be reachable over HTTPS from the public internet. If every member is stuck rather than one, the webhook is the cause.

Payments → GoCardless Events is a searchable log of every webhook event the plugin has received. An empty log confirms it.

Payments → Not Set Up lists exactly this, and can chase them. Bear in mind a setup email the club sends goes to the member's payment contact — if that is set to a guardian who does not deal with the money, the link is arriving at the wrong parent. Check it on the guardian record.

A guardian can also start the payment themselves from the registration page; they then pay as themselves, whoever is flagged. Receipts and other payment emails still go to the payment contact.

The figures do not match GoCardless

The Payments screens include a reconciliation view for exactly this. Offline payments recorded in the plugin will never appear in GoCardless, which accounts for most differences.

Public pages

The registration page shows the request form instead

That is the intended fallback: someone reached the page signed out, or their emailed link is more than 24 hours old. Every registration link works for a day. The parent can ask for a fresh one on the same page, or sign in on the account page with a passkey. It exists so a parent hits a way forward rather than a dead end.

The sign-up form emails nobody

Three emails are involved, all on Club Management → Email Settings → Emails under Waiting-list sign-ups: the Club secretary notification, the Squad secretary notification to each matching squad's secretary, and the No suitable squad alert for a child matching no squad. Each has to be switched on, and the club secretary notification and the no suitable squad alert also need a To address before they can send. A blank address is easy to miss, and then out-of-range sign-ups are silent.

A shortcode renders as text

The shortcode is on a page WordPress is not running shortcodes on — usually a block or template that outputs raw content. Put it in an ordinary paragraph or a shortcode block on a normal page.

English FA

English FA does not fetch anything from FA Full-Time itself, and has no scheduled job for it. A separate collector (tools/pi-sync, usually on a Raspberry Pi on the club's broadband) asks the site which leagues to collect, fetches each league's Full-Time code snippet in a headless browser, and pushes the result to the site. Teams are not added by hand: any team in the collected matches whose name contains the Club name in English FA → Settings is one of the club's.

Fixtures stopped updating, or never arrived

Open English FA → Leagues. Each league shows when it was last collected. There is no "sync now" button, because the site cannot run a code snippet itself.

  • A league that has never been collected usually means the collector is not running, or cannot sign in. Check the collector machine (its fulltime-sync.timer and the service's log), and that its application password still exists under Users → Profile → Application Passwords for a user who can manage English FA.
  • A league whose last collection is old means the collector has stopped. Same checks.
  • A league that collects but holds no matches may simply have nothing scheduled yet; an empty collection is not treated as an error. If matches should be there, check the fixtures and results snippet codes against Full-Time's Media → Code Snippets.

A team of ours is missing

Once a league has collected, its screen lists the team names its matches mention. Compare that list with the Club name in English FA → Settings. It is almost always a spelling difference, or the team plays in a league system you have not added on English FA → Leagues.

Club Mailer

The connect button is missing from a member's profile

Members are only offered a provider the site admin has configured. Fill in the Entra or Google credentials on Settings → Club Mailer and the button appears.

The provider rejects the redirect URI

Both causes are environmental rather than plugin faults:

  • Pretty permalinks are off. The redirect URI is a clean, query-free URL. Set Settings → Permalinks to anything but "Plain".
  • The site is on http://. Entra and Google both refuse a non-HTTPS redirect URI for a web app; bare localhost is the only exception.

The settings screen prints the exact URI each provider needs pasted into it. Paste it, do not retype it.

Still stuck

The User guide covers every screen in detail, and most screens explain their own edge cases in place — the payments section in particular spends a lot of words on states that look wrong and are not.