- What Laravel and Filament versions does this package support?
- The package is designed for Laravel 10.x+ and Filament 3.x. Check the package’s `composer.json` or release notes for exact version ranges, as newer Filament updates may require adjustments. If your Filament version isn’t listed, you may need to fork or extend the package for compatibility.
- Can I use this with Laravel Fortify, Breeze, or Jetstream?
- Yes, this package integrates with Laravel’s authentication stacks (Fortify, Breeze, Jetstream) by extending their registration workflows. It won’t replace them but enhances them with Filament UI and CAPTCHA. Ensure your auth stack’s registration logic aligns with the package’s hooks for smooth operation.
- How do I configure Cloudflare Turnstile or Google reCAPTCHA v3?
- Configuration is handled via the package’s published config file (run `php artisan vendor:publish`). Add your Cloudflare Turnstile site key or Google reCAPTCHA v3 API keys, then set the preferred CAPTCHA provider. The package handles validation and verification automatically.
- What if I need a different CAPTCHA provider like hCaptcha?
- The package supports pluggable CAPTCHA providers, but hCaptcha isn’t included out of the box. You’d need to create a custom provider class implementing the package’s `CaptchaService` contract, then bind it in the service provider. Check the package’s source for the interface requirements.
- How do I assign dynamic roles instead of static defaults?
- The package allows role assignment via a `roleResolver` closure in the config. For dynamic logic (e.g., based on user input or external APIs), override the resolver in your `AuthServiceProvider` or use Filament’s hooks to modify the registration process before role assignment.
- Does this package support localization for multi-language registration forms?
- Localization depends on Filament’s underlying form components. If your Filament setup supports localization (e.g., via Laravel’s `trans` helper or packages like `spatie/laravel-translatable`), the registration form will inherit those features. Test with your preferred language files to confirm.
- Will this add significant latency due to CAPTCHA verification?
- CAPTCHA verification is asynchronous by default, but latency depends on the provider’s API response times. Cloudflare Turnstile is generally faster than Google reCAPTCHA v3. The package doesn’t cache CAPTCHA results, but you can extend it to cache failed attempts or use a queue for non-critical workflows.
- How do I customize the registration form fields or validation rules?
- Use Filament’s form customization features. Extend the package’s registration form class or override it entirely in your `AppServiceProvider`. For validation, modify the `rules` array in the config or use Laravel’s validation hooks to add custom logic.
- Are there audit logs for registration events like failed attempts?
- The package doesn’t include built-in audit logging, but you can integrate it with Laravel’s logging or packages like `spatie/laravel-activitylog`. Listen to the package’s events (e.g., `RegistrationAttempted`) in your `EventServiceProvider` to log actions.
- What alternatives exist if this package doesn’t fit my needs?
- For Filament-based registration, consider `filament/spatie-laravel-permission` for role management or `filament/filament-forms` for custom forms. For Laravel-only solutions, explore `laravel/breeze` (with manual CAPTCHA) or `spatie/laravel-registration`. If you need OAuth, `socialiteproviders` integrates with Laravel’s auth.