Joget DX 8 Stable Released
The stable release for Joget DX 8 is now available, with a focus on UX and Governance.
Invisible reCAPTCHA Form Element Plugin is used to protect forms developed in Joget DX from spams or abuse from malicious automated bots that are programmed to enter false or irrelevant information into a form, while being as transparent as possible to legitimate users of the platform.
About reCAPTCHA
reCAPTCHA is a free Google service with the acronym of "Completely Automated Public Turing test to tell Computers and Humans Apart".
It can identify whether a form is submitted by a real human or a bot.
For more information about reCAPTCHA, see: https://www.google.com/recaptcha/about/.
You can follow the steps below, or refer to Manage Plugins to read more about managing plugins:
In the Form Builder, open up any Form that you wish to implement this feature for.
Search the Form Element Palette for the Invisible reCAPTCHA element under the Marketplace section.
Drag and drop this element into your Form.
Click on the element in your form and the Edit Invisible reCAPTCHA panel appears (on the right hand side).
In the Edit Invisible reCAPTCHA configuration, you are required to insert the information for the following fields:
Your ID can be any meaningful name you want (e.g.: invisible_recaptcha).
The next section will explain how to generate the required reCAPTCHA site key and reCAPTCHA secret key for this plugin.
You can follow the steps below, or refer to this related guide online:
Give your Label a meaningful name (e.g.: recaptcha_test)
For the reCAPTCHA Type, select reCAPTCHA v2 > Invisible reCAPTCHA badge
Under Domains, put the domain name that your Joget DX instance is hosted on.
Setting a domain name
If you are using Joget DX on a local computer for development purposes, you can put "localhost" as your domain name.
Copy the generated reCAPTCHA site keys and reCAPTCHA secret keys, and paste them into their respective fields in the Edit Invisible reCAPTCHA configuration.
Remember to click Apply Change and save the form.
Important reCAPTCHA keys
Try submitting the form where you added the Invisible reCAPTCHA plugin.
If the bottom right corner of your form shows the protected by reCAPTCHA pop-up, it means that the Invisible reCAPTCHA plugin is working as intended.
Edit Invisible reCAPTCHA: Other configurations
What if the Invisible reCAPTCHA plugin is not working as intended?
You can refer to Custom error text and Debug mode sections.
Tip: Hover on the tooltips (? icon) in Edit Invisible reCAPTCHA configuration to read what each configuration properties mean.
Custom error text is designed to be shown to end-users when there is a plugin validation error.
image here...
Without using the Custom error text configuration property, the top left corner of your Form will only indicate the "Validation Error" message when plugin validation error occurs.
An error message as such does not explain much on what the validation problem is, therefore Custom error text can be used to elaborate the validation problem to end-users.
To produce a meaningful error message, you should first understand what a plugin validation error is.
To replicate an error as such is very simple, you only have to provide an invalid reCAPTCHA secret key in the Edit Invisible reCAPTCHA configuration.
Replicating the plugin validation error
Let's say, a given valid key "67BKQ13rTNaL376" is made invalid by having one letter changed to a different letter.
For example, the 3rd character "B" is changed to "U", you will now get an invalid key "67UKQ13rTNaL376".
By using this invalid key "67UKQ13rTNaL376" as your reCAPTCHA secret key, a plugin validation error will occur.
image here..
Enabling Debug mode allows error messages to be printed out for end-users to see.
image here..
Form Type | Reason |
---|---|