Introduction

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.

Installing the plugin in Joget DX

You can follow the steps below, or refer to Manage Plugins to read more about managing plugins:

1. Download invisible-recaptcha-field-7.0.0.jar into your computer
2. In the Joget DX platform, go to System Settings > Manage Plugins > Upload Plugin
3. Click on Choose File, select the .jar file you just downloaded, and click Upload

Using the plugin in a Form

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:

• ID
• reCAPTCHA site key
• reCAPTCHA secret key

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.

Generating important keys for the plugin

You can follow the steps below, or refer to this related guide online:

1. Go to https://www.google.com/recaptcha/about/
2. Click on v3 Admin Console at the navigation bar

3. Give your Label a meaningful name (e.g.: recaptcha_test)

4. For the reCAPTCHA Type, select reCAPTCHA v2 > Invisible reCAPTCHA badge

5. 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.

6. Tick Accept the reCAPTCHA Terms of Service
7. Click Submit

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.

Testing out the plugin

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.

Custom error text

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.

image here..

Debug mode

Enabling Debug mode allows error messages to be printed out for end-users to see.

image here..

Availability of the plugin