Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Your ID can be any meaningful name you want (e.g.: invisible invisible_recaptcha).

The next section will explain how to generate the required reCAPTCHA site key and reCAPTCHA secret key for this plugin.

...

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

    Info
    titleSetting 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

...

Info
titleEdit Invisible reCAPTCHA: Other configurations

What if the Invisible reCAPTCHA plugin is not working as intended?

  • Custom error text is returned when there is a plugin validation error
  • Debug mode can be enabled to help app designers indicate what the problem or error is

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

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 Whenever the plugin validation error occurs, the top left corner of your Form will only indicate the "Validation Error" message . However, an error message as such is 

...

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.

Info
titleReplicating 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..

Debug mode

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

image here..

Availability of the plugin

...