Details
-
Project registration
-
Resolution: Done
-
Neutral
-
None
-
ReCaptcha2 Magnolia Module
-
magnolia-recaptcha2
-
-
Git (git.magnolia-cms.com)
-
nl.tricode.magnolia.recaptcha2
Description
Google ReCaptcha2 API module for Magnolia cms.
In this module we provide classes, annotations and form procerssors for easy and fast usage of Google ReCaptcha2 API.
Features
Freemarker macros usage
To use this module, include it in your module dependencies. In freemarker templates you can add recaptcha field by including include "/magnolia-recaptcha2/templates/macros/recaptcha2.ftl" which contains 2 macros:
reCaptchaField - render recaptcha with checkbox. Accept one parameter "callback" that can be used with API callback function name.
reCaptchaInvisible - render invisible recaptcha. Accept one parameter "callback" that can be used with API callback function name.
Validation annotation @ReCaptcha usage
You can use: nl.tricode.magnolia.recaptcha2.validation.ReCaptcha annotation to validate recaptcha in rest calls.
Java class usage
ReCaptcha2 class provides static methods for easy recaptcha response check with api.
Form processors usage
To use it in form, we provide nl.tricode.magnolia.recaptcha2.form.processors.ReCaptcha2FormProcessor form processor which validates recaptcha for submitted form.
Templating functions
Templating functions provides recaptcha site keys are registered under rec2fn and can be used to provide site key to your freemarkers.
Configuration
After instaling module you need to configure API Site and API Secret key. This keys will be provided to you by Google ReCaptcha2 API after registering your site. After you get this keys, place them in Magnolia CMS -> /configuration/modules/magnolia-recaptcha2/config
reCaptchaSecret
reCaptchaSiteKey
Prerequisites
git
java 8
Maven 3
License
Copyright (c) 2015 Tricode and contributors. Released under a GNUv3 license.