Download the PHP package wuxejian/filament-registration without Composer

Filament Registration

A Filament v5 plugin that wires up Filament-native user registration with pluggable captcha (Cloudflare Turnstile, Google reCAPTCHA v3) and configurable default-role assignment.

Filament has built-in ->registration() support, but the default flow is just name/email/password — no captcha, no role assignment, no event bridge for hosts that listen on Laravel's Registered event. This plugin fills those gaps as a drop-in replacement that still uses Filament's documented hooks (no register() reimplementation, no internal copy-paste).

Features

• Filament-native register page that extends \Filament\Auth\Pages\Register. Login ↔ register cross-linking works for free.
• Pluggable captcha pipeline: Cloudflare Turnstile, Google reCAPTCHA v3, or none. Settings managed through a Filament admin page; secrets are encrypted at rest.
• Default-role assignment with a graceful fallback: if the configured role doesn't exist, registration still succeeds and a warning is logged (so a misconfig doesn't lose all signups).
• Honeypot field + pre-captcha throttle protect the captcha vendor from amplification.
• Laravel Illuminate\Auth\Events\Registered is fired alongside Filament's own Filament\Auth\Events\Registered event, so listeners written for Laravel's event keep working.
• Container-bound redirect response so hosts can swap the post-registration redirect (e.g. send new users into an onboarding flow) without subclassing the page.

Installation

Add to your panel provider:

Both ->registration(Register::class) and ->plugin(FilamentRegistrationPlugin::make()) are required and not interchangeable. ->registration() with no argument uses Filament's default page; the captcha and role assignment only run when the explicit class is wired.

Optional: enable Filament's built-in email verification with ->emailVerification(). The plugin defers to it — when the panel requires verification, Filament sends the verification email; when it doesn't, new users are pre-marked verified.

Configuration

Captcha settings come from two layers, with the higher one winning:

1. Database (managed via the Admin UI at Settings → Registration) — what the plugin shows in the form, with the secret encrypted at rest.
2. Environment variables — useful for keeping secrets out of source control and per-environment overrides (e.g. test keys in staging, real keys in prod).

The captcha provider is detected from whichever layer wins; you don't need to wire each provider individually.

Environment variables

All optional. The plugin works fully through the Admin UI without any of these set.

Example .env for production with Cloudflare Turnstile:

The Admin UI's "Secret key status" indicator reads ✓ Configured when either layer (DB or env) supplies a secret. So if your secret lives in .env, you can leave the form's secret field blank — the form treats blank as "keep current".

Authorization for the settings page

By default the page is accessible to any user who can reach the panel (i.e. anyone who passes the panel's auth middleware). The plugin doesn't ship a built-in permission gate because Filament users have very different auth setups (some use Shield, some Bouncer, some plain canAccess(), some panel-level middleware). Pick whichever fits your app:

Using TallCMS + Multisite plugin? (zero config)

If you're running TallCMS with the Multisite plugin (the SaaS-style site-builder mode), install the tallcms/registration bridge plugin and you're done — the bridge gives you the full SaaS signup flow out of the box:

• Default role site_owner (with TallCMS's role-aware policy scoping so each new user only sees their own sites)
• Onboarding redirect into the Multisite Template Gallery for new users
• Default site-plan assignment so quotas apply from day one
• Themed login + register pages that match your active TallCMS theme
• 301 redirect from the legacy /register URL to the Filament-native page

No subclassing, no canAccess() override — TallCMS Multisite handles it. Read more at tallcms.com.

Using TallCMS without Multisite?

The bridge plugin is mostly Multisite-coupled (its onboarding redirect and site-plan assignment both no-op without the Multisite plugin). For a vanilla TallCMS install, skip the bridge and use this plugin directly:

On gating the settings page: TallCMS's panel already requires authenticated admin access (canAccessPanel()), so unless you want a stricter gate (e.g. "only super_admin can edit captcha keys, not editor or author"), you don't need to add anything else. If you do want that stricter cut, see the Shield subclass recipe below — note that Shield can't auto-discover this page (it's a vendor class without HasPageShield), so the subclass is the canonical wire-up; no shield:generate magic alternative exists.

Filament Shield users {#filament-shield-users}

Subclass the page and add the trait, then point your panel at the subclass:

Then run php artisan shield:generate --page=RegistrationSettings --panel=<id> once and grant the resulting View:RegistrationSettings permission to roles via the Shield UI.

Plain canAccess() users

Subclass and override:

Optional dependency note: role assignment via defaultRole(...) requires spatie/laravel-permission (suggested in composer.json). Hosts without Spatie permissions get role assignment as a no-op — no fatal error, the user is still created.

Customising the post-register redirect

Bind a custom response in your service provider:

Your concrete just needs to implement RegistrationResponse (which extends Responsable) and return a RedirectResponse from toResponse().

Behaviour notes

• Honeypot: a non-empty honeypot field returns a validation error, not a fake-success page. Bots see the form bounce; humans never trigger it.
• Throttling: pre-captcha throttle is 30 attempts per IP per minute (protects the captcha vendor). Filament's built-in throttle (2 attempts per minute, 2 per email per minute) covers the post-validation case.
• Email verification: defers to Filament's ->emailVerification() panel method. No custom verification view is shipped.

Compatibility

• PHP 8.2+
• Filament v5+
• spatie/laravel-permission v6+ (for role assignment)

License

MIT.