Skip to content

wiredviews/xperience-hcaptcha

Repository files navigation

Xperience hCaptcha

GitHub Actions CI: Build

Publish Packages to NuGet

Packages

XperienceCommunity.HCaptcha

NuGet Package

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

XperienceCommunity.HCaptcha.CMS

NuGet Package

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

How to Use?

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

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

    dotnet add package XperienceCommunity.HCaptcha.CMS

Usage

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

    using XperienceCommunity.HCaptcha.CMS
    
    [assembly: RegisterModule(typeof(HCaptchaInstallerModule))]
    
    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 hCaptcha Dashboard.

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

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

    hCaptcha Form Component properties
  5. Load the form on your live site to see the captcha! 💪

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

Kentico Xperience