Using CAPTCHA v2 check box

There are multiple types of Captcha -Recaptcha. The original type, v1 which presented a "distorted" set of characters, has been shut down since March 2018.
Presently jDownloads v3.9 supports Joomla! Captcha-Recaptcha type v2. Here we will just describe the standard v2 type which will present a   Captcha09 box which is known as the 'check box' type. There are two further v2 types, the ' invisible badge' type and the 'Android' type.  At the time of writing these other two types have not ben verified with jDownloads.  To add to the situation the latest Cattcha-Recaptcha is the v3 type verifies using a score; it is also known as an 'invisible' type! This has also not been tested.

This note gives advice on the steps needed to include and use the v2 'check box' type in jDownloads.

As a preliminary you will need to have a Google account - see link, which opens in a new tab/window  https://accounts.google.com
If you already have an account the link will take you to the sign in page.

There are three steps to implement the v2 'check box' Recaptcha as noted below.
  1. Getting the Captcha 'keys' from Google.
  2. Setting up the standard Joomla! Captcha-ReCaptcha Plugin.
  3. Enabling use in jDownloads.
However before detailing these steps we present below examples of the v2  check box type Captcha-ReCaptcha working in jDownloads.
The first point to note is that the Captcha sequence appears in the jDownloads Summary view.  When you have requested that a User Group may only download after using a Captcha then the Summary view will always apear, even if you have not selected it in the Configuration.

So after clicking on the Download Button, or perhaps the Download title then depending on your configuration the Details View may appear with its Download Button.

One way or another you will eventually get a Summary view as shown opposite.  As the instructions say just click in the box opposite the text "I'm not a robot".

Captcha01A
After a short delay whilst the 'keys' are checked then usually a 'green tick' will appear in place of the white box.

Usually the Continue button will  become properly enabled so that when you click on 'Continue' it will activate the download sequence you have selected in the jD Configuration. But sometimes the user is requested to take a 'pictorial' challenge.
Captcha01B
 

In these cases an image with several sub-images in it, as in the first image opposite, is shown.

In this example the supplementary question was to "Select all the drinks".

In this example there were two relevant sub-images.  Both were clicked and this produced the appropriate 'tick marks' on the image to the far right.

The verify button was then clicked and this then initiated the download.

  Captcha06A Captcha07A

There is an exception when the Captcha does not appear even if you have set it up to appear.

This is when the specific Download requires a Password.

In this case the need for a password is deemed more significant than a Captcha so the Captcha is bypassed.

What happens next depends on whether or not the password matches.
Captcha08

Getting the Captcha keys

The most challenging part, especially for a novice, is getting the Captcha keys from Google.  There are two 'keys' required that will be used by the Joomla! Captcha-Recaptcha plugin.
These are the Site Key and the Secret Key.  Each key is typically 40 or so characters long.
Note: In this example we will be using keys that are totally fictitious and meaningless. If you use them they will not work!

As noted earlier the first step is to create a Google account if you do not already have one, and of course to login.  The next step is to go to the Google ReCaptcha site https://www.google.com/recaptcha/admin  The principle objective here is to register your site for Captcha keys.

When using the above link then you will initially be taken to the login page. After logging in you are taken directly to the "Register a new site" page.

The label field was entered as Devel,
reCapture v2 and 'tickbox' type were selected.
The domain was set to "www.mydomain.com" which is obviously replaced with your domain.  If you are using say an XAMPP site on you PC then set localhost as the domain.

Obviously one must tick the box accepting the Terms of Service.

It is probably useful, but not necessary, to use the same email as the one used for Joomla!

After filling, the form looks like the picture on the far right. Note you can add multiple domains.

Finally click on Submit.

recaptcha v2 09 recaptcha v2 10

This will now show the site and secret keys like those shown opposite.  There are various other bits and instructions  that have not been shown here.

We only need to copy the two actual keys for use in the Joomla! Captca-reCaptcha plugin.

It is probably a good idea to copy and paste then into a text file so you can then paste into the Catcha-reCaptcha plugin as described below.
recaptcha v2 16
If you go back later then use the settings recaptcha v2 18 to get to the keys or use recaptcha v2 19 to add another site.  With more than one site you first have to select the site. recaptcha v2 17

Configure the Joomla! Captcha - reCaptcha Plugin And User Manager Options

Using the Extensions Plugin Manager select and open the Captcha - reCaptcha Plugin, not the Captcha - invisible reCaptcha one.
recaptcha v2 11


After ensuring the plugin is published (enabled) then copy the Site and Secret keys into the relevant fields.

Also ensure you select Version 2.0

With the Theme set and the Size set then the remaining plugin specific setup  fields may be left blank.

Access would normally be left as Public as jDownloads controls when the Captcha- reCapture is visible.

recaptcha v2 12
The next step is to go to the Options in the Joomla! User Manager and
set CAPTCHA-reCAPTCHA as the new user default. recaptcha v2 13
Also set the Default Captcha in the Joomla! Global Configuration - Site tab. recaptcha v2 14

Enabling use in jDownloads
jDownloads allows selection of which User Groups (UGs) will or will not need to use a Captcha sequence through the User Groups Settings.
Each User Group is treated independently, and there is no implied parent or inheritance.  So for example if you set Captcha-reCaptcha for just the Public User Group then Registered users will not have to respond to a Captcha 'test'.

In User Groups Settings then for each User Group that you decide should respond to a Captcha set the View Captcha field in the Group Settings tab to Yes.

The default setting for this field is No so the creation of any other User Group will not have Captcha set.

recaptcha v2 15
To repeat, the administrator has to positively set the View Captcha field to Yes to enable Captcha-ReCaptcha for each UG required to use a Captcha sequence.
It may be necessary to exit from the Joomla! admin and clear your browsers cache before the Captcha takes effect for the first time.

ColinM, July 2019 updated November 2019.

Print Email

This site uses cookies. By continuing to browse the site, you are agreeing to our use of cookies.