XperienceCommunity.HCaptcha 1.0.1

Xperience hCaptcha

Packages

XperienceCommunity.HCaptcha

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

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.

   <img src="./images/cms-settings-application.jpg" width="600px" alt="CMS Settings application hCaptcha fields" />

3. Add the hCaptcha Form Component to a Form Builder form.

   <img src="./images/form-builder-components-dialog.jpg" width="600px" alt="Form Builder component dialog" />

4. Configure any properties on the captcha component

   <img src="./images/hcaptcha-form-component-properties.jpg" width="600px" alt="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

• hCaptcha

Kentico Xperience

• Form Components