Download the PHP package coderflex/filament-turnstile without Composer

Filament Turnstile

Filament Turnstile is an essential plugin designed to seamlessly integrate Cloudflare's turnstile into your applications.

This plugin uses Laravel Turnstile under the hood. For detailed information, explore the Laravel Turnstile README.

Installation

Install the package via Composer:

For users still on Filament V2, install the package using:

Turnstile Keys

To utilize Cloudflare Turnstile, obtain your SiteKey and SecretKey from your Cloudflare Dashboard.

Refer to the documentation for detailed instructions.

After generating the keys, include them in your .env file using the following format:

For testing purposes, you can use Dummy site keys and secret keys provided by Cloudflare.

Usage

Utilizing this plugin is incredibly straightforward. In your form, incorporate the following code:

For a list of supported languages, refer to the supported languages section.

The Turnstile field offers various options; you can learn more about them in the Cloudflare configuration section.

Turnstile Events

The Turnstile package provides events that you can leverage to manage the behavior of the captcha in various scenarios.

Reset Event

The reset-captcha event allows you to programmatically reset the captcha challenge. This can be useful when you want to:

• Clear the challenge after a successful form submission: This ensures a fresh captcha for the next user.
• Reset the challenge upon validation errors: Prevents users from being stuck with a previously solved captcha after encountering errors during form submission.

Dispatching the Reset Event:

There are two primary ways to dispatch the reset-captcha event:

1. Using onValidationError Method:

Filament provides the onValidationError method within your form's Livewire component. This method is automatically triggered whenever form validation fails. Here's how to utilize it:

In this example, the reset-captcha event is dispatched upon validation errors, ensuring the captcha is reset for the user's next attempt.

2. Manual Dispatching:

For scenarios where resetting the captcha is not directly tied to validation, you can manually dispatch the event using Filament's event dispatcher:

Using Reset Event in Login Page:

To automatically reset the captcha on a failed login attempt in your login form's Livewire component, leverage the throwFailureValidationException method:

By throwing a validation exception with appropriate error messages, you trigger the onValidationError method, which in turn dispatches the reset-captcha event, effectively resetting the captcha for the next login attempt.

Real-Life Example:

To implement the Turnstile captcha with the Login page in Filament, follow these steps:

Create a new App/Filament/Pages/Auth/Login.php class:

Then, override the login() method in your PanelProvider (e.g., AdminPanelProvider):

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Oussama
• All Contributors

License

The MIT License (MIT). Please see the License File for more information.