Skip to content

Account activation

Members create their own account at /activeren. No admin action, no mass mailing. The opening screen uses the configured club display name in its heading and newsletter guidance. An illustrated list explains that members can view and edit contact details, sign up for volunteer tasks and find their digital membership pass. Icons are decorative; each benefit remains readable as text. The email hint asks for the address that receives club newsletters and is associated with the input through aria-describedby. A separate note explains that parents can choose their own parent account through the activation link. Client-side email validation messages are explicitly Dutch rather than relying on the browser locale.

The activation email introduces Rondo as the club’s online environment and lists contact-detail editing, volunteer-task registration and the digital membership pass. Its subject is Activeer je Rondo-account bij [club], with Welkom bij Rondo van [club] as the heading and no Account eyebrow. The activation steps precede the button; the two-hour validity and advice for unsolicited requests follow it. The existing shared email template supplies the shell and button.

Activation mail uses an explicit From header for ledenadministratie@svawc.nl. Keep this scoped to ActivationService::send_activation_email() so other transactional mail retains its configured sender. The confirmation page shows the submitted email address (HTML-escaped) and configured club name, with conditional wording that is identical for known, unknown and rate-limited addresses. It tells members to check their spam folder, provides an Ander e-mailadres gebruiken link back to /activeren, and links directly to the membership administration through mailto:. Long email addresses wrap within the card on narrow screens.

The public page publishes a 1200×630 Open Graph image from public/images/og-account-activation.png. ActivationPage passes that image to the shared PublicPageChrome header, which emits the Open Graph and Twitter Card image metadata.

RouteDoes
GET /activerenAsk for an email address
POST /activerenMail an activation or Magic Login link, if the address is known
GET /activeren/{token}”Who are you?” — the people on that address
POST /activeren/{token}Create the account, redirect to set a password

Logic lives in Rondo\Users\ActivationService; ActivationPage only routes and renders.

The identity step only asks for a choice when several people are available or a youth member has a parent/guardian option. For one person without a guardian option, it shows “Je maakt een account aan voor [name]” and the Account aanmaken button, submitting the same self:{person_id} identity as a hidden field. This single-person screen is titled Activeer je Rondo-account and explains below the button that password setup comes next. The one-use/next-account hint remains on the multi-choice screen only. The service still validates the selected person against the token on submission.

The picker labels distinguish Voor mezelf from Voor mij als ouder/verzorger. The parent name field appears only for a selected guardian identity; no parent field is rendered when no guardian option exists. The activation pages use a compact branded header, full-width action buttons and spaced choice cards. These styles are scoped to activation so payment page layouts stay unchanged.

Former members are normally excluded from activation. There are two role-based exceptions:

  • a former member with a published, non-former child relationship;
  • a former member who is an active sponsor contact.

Their membership record remains read-only, but their current parent, guardian, or sponsor role still needs an account. ActivationService::is_person_activatable() is the shared eligibility check for public activation and the administrator’s provisionable-person picker.

For every JO16- person in the identity picker, the activation page also offers “Ik ben ouder/verzorger van …”. The parent enters their own full name. Rondo uses the address proven by the activation token and resolves the identity in this order:

  1. A parent already linked to the child with that e-mail address is used immediately. If multiple linked parents share the address, the entered name disambiguates them.
  2. An existing person on the address whose name matches is linked as the parent, provided the child still has a Sportlink parent slot.
  3. If no person matches and a slot is free, Rondo creates the parent person with the entered name and proven e-mail address, links it to the child, and marks the Sportlink parent sync as pending.

The WordPress account is provisioned directly against the resolved or newly created parent. If that parent already has a WordPress account, the activation link is exchanged for a one-time Magic Login URL instead. The child never receives the account in these successful automatic paths.

When automatic parent linking is not safe or possible — for example because both parent slots are already occupied — Rondo preserves the previous fallback: it creates the account against the child and stores a temporary guardian claim. This lets the parent continue while membership administration resolves the identity manually.

The claim is visible under Settings → Beheer → Gebruikers. It does not send a notification email. An existing child-linked account can start the same flow from /vrijwillig; this covers parents who activated before the guardian picker existed.

For a fallback claim, the account stays linked to the child until an administrator selects Accountkoppeling wijzigen. That action moves the user link to the synced parent, refreshes the user’s name, KNVB ID and capabilities, and clears the temporary guardian claim. A target person that already has an account cannot be selected.

Parents are not Sportlink members. They have no KNVB-ID and no birthdate on record, so an email address is the only thing they can be asked for. That would normally be a weak identifier — except:

Activation never grants access directly. It only ever mails a link to the address already on file.

Someone who guesses an address learns nothing, because the page answers identically either way, and receives nothing, because the mail goes to the member. Possession of the mailbox is the credential.

A household mailbox can activate any member on that mailbox. That is intended — it is the family’s own inbox, and it is how a parent activates on behalf of themselves.

  • 32 random bytes, hex-encoded to 64 characters, from random_bytes().
  • Only the SHA-256 is stored (a transient keyed on the hash), so a database read cannot be replayed as a working link.
  • Valid for two hours.
  • Burned on use. One link creates one account. A family activating a second member requests a new link — a deliberate trade of convenience for a smaller blast radius if a link is forwarded.
  • A second transient retains only the token hash, matched email, eligible person IDs, and consumed state for seven days. This lets administrators diagnose a genuine expired or reused link without storing the raw token. Random or guessed token URLs have no context and are never logged.

activate() re-validates everything at the moment of use rather than trusting the picker page: the token must still be live, and the person must still match its address, still be active or have a current parent or sponsor role, and still lack an account. A token for one address cannot activate a person on another.

Administrators see the 50 most recent attributable failures under Settings → Beheer → Gebruikers → Mislukte accountactivaties. Entries contain the time, matched people, proven email address, stable error code, and operator-facing message. The underlying private rondo_activation_log posts are retained for 12 months.

Failures include expired or reused genuine activation links, provisioning errors, invalid choices, and activation-email delivery failures. Repeated refreshes of the same token and error are deduplicated for one hour. Unknown token URLs are excluded to prevent bot traffic from filling the log.

Transient counters, per hour:

LimiterAllowance
Per email address3 requests
Per IP10 requests

The IP limiter is what stops enumeration across many addresses from one host. A rate-limited request renders the normal confirmation — it does not announce that it was throttled.

MagicLoginActivation turns the Magic Login email form into the normal entry point for both login and first-time activation. It intercepts the plugin only after its CAPTCHA, honeypot, and per-user send safeguards have passed, and then applies the activation service’s stricter per-address and per-IP rate limits.

The email address determines the next step:

Matching recordsResult
One non-youth person without an accountProvision the linked WordPress account and send a Magic Login link
One youth person without an accountSend the activation link so the recipient can choose member or guardian
Multiple people without accountsSend the activation link and identity picker
Existing accounts onlySend one branded email with a named Magic Login button per account
Existing and unactivated peopleSend one combined email with named login buttons and an activation button
Unknown address, or former member without a current parent or sponsor roleSend nothing

The plugin remains responsible for Magic Login token creation, validity, and authentication. Rondo never uses the plugin’s generic registration feature because that would bypass person linking, household identities, guardian handling, and role provisioning.

Every valid email submission receives the same neutral confirmation, including unknown and rate-limited addresses. This removes the old “account does not exist” membership oracle.

Password login and emailed Magic Login links preserve the requested redirect_to, including a local OAuth authorization URL and its query parameters. rondo_login_redirect() uses WordPress’s requested-destination argument, covering login-form POSTs as well as GETs. Missing destinations return home, and wp_validate_redirect() rejects unapproved external destinations with home as the fallback. Entrance accounts always return to /lidpas-scanner.

MagicLoginActivation captures and validates the submitted destination before the response ends, queues it with the email address, and passes it through ActivationService when generating named login links. Existing-account links in combined household emails retain it too; activation-picker links keep their existing activation flow. rondo_activation_magic_login_url receives the validated destination as its third argument. Regression tests cover OAuth state retention, unsafe destinations and the entrance-account override.

Successful activation records the exact confirmed mailbox for account switching. The confirmation remains valid across later logins while the address and person-account link remain valid. Named Magic Login links bind proof to the receiving address, including secondary addresses. Removing that address or changing the person-account link revokes the proof. A password login alone cannot create it.

Identical HTML is not enough. Sending the mail costs an API round-trip, so a known address would answer measurably slower than an unknown one. ActivationPage renders its confirmation and flushes the response before dispatching mail. MagicLoginActivation similarly queues the submitted address until WordPress shutdown, calls fastcgi_finish_request() under PHP-FPM, and only then performs the person lookup, provisioning, and mail work. Keep mail and conditional lookup after that response boundary: moving either above it silently reopens the oracle.

It does not send the welcome email. provision( $person_id, $send_welcome = false ) skips it: the member already came from their inbox and is redirected straight to wp-login.php?action=rp to set a password. Only one mail is ever sent.

The second member of a household gets a synthetic user_email as usual — see user provisioning for how that works and why ContactEmailRouter must exist.

Any contactable published person who does not already have an account and is active, a current parent, or an active sponsor contact. Former-member profiles remain read-only after account creation. There is deliberately no requirement to owe a volunteer obligation: a sponsor or a grandparent who wants to help is not turned away. See vrijwilligersplicht for the distinction between owing a duty and being allowed to volunteer.

A person who already has an account is shown “je hebt al een account” with a link to password reset, rather than being silently hidden.