Skip to content

wiredviews/xperience-cloudflare-turnstile

Repository files navigation

Xperience Cloudflare Turnstile

GitHub Actions CI: Build

Publish Packages to NuGet

Cloudflare Turnstile is a privacy-preserving alternative to traditional captchas that can be used independently of any of Cloudflare's other products and services. Xperience Cloudflare Turnstile integrates Turnstile's visitor validation into Kentico Xperience 13.0 Form Builder forms.

You can take advantage of Turnstile and stop bothering your visitors with a CAPTCHA even without being on the Cloudflare network. While we make it as easy as possible to use our network, we don't want this to be a barrier to improving privacy and user experience. - source

Packages

XperienceCommunity.Cloudflare.Turnstile

NuGet Package

Kentico Xperience 13.0.66 (or higher) ASP.NET Core 6.0+ Form Component that adds Cloudflare Turnstile "captcha alternative" validation to Form Builder forms.

XperienceCommunity.Cloudflare.Turnstile.CMS

NuGet Package

Kentico Xperience 13.0.66 (or higher) CMS installation module that adds Cloudflare Turnstile settings keys to the Settings application.

How to Use?

  1. Install the XperienceCommunity.Cloudflare.Turnstile NuGet package in your ASP.NET Core 6.0+ application:

    dotnet add package XperienceCommunity.Cloudflare.Turnstile
  2. Install the XperienceCommunity.Cloudflare.Turnstile.CMS NuGet package in your CMS application:

    dotnet add package XperienceCommunity.Cloudflare.Turnstile.CMS

Usage

  1. Add a registration for the TurnstileInstallerModule in your CMSApp project:

    using XperienceCommunity.Cloudflare.Turnstile.CMS
    
    [assembly: RegisterModule(typeof(TurnstileInstallerModule))]
    
    namespace CMSApp.Configuration
    {
       public class DependencyRegistrations
       {
    
       }
    }

    On application startup, custom CMS settings will be added to the Settings application

  2. Set the settings keys in the CMS Settings application with the values provided in your Cloudflare Dashboard.

    CMS Settings application Turnstile fields
  3. Add the Cloudflare Turnstile Form Component to a Form Builder form.

    Form Builder component dialog
  4. Configure any properties on the Turnstile component

    Turnstile Form Component properties
  5. Load the form on your live site and test out the form submission! 💪

Contributions

If you discover a problem, please open an issue.

If you would like contribute to the code or documentation, please open a pull request.

References

Cloudflare Turnstile

Related

Kentico Xperience

About

Kentico Xperience Cloudflare Turnstile Form Component

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors