Using CAPTCHA v2 check box
Presently jDownloads v4.x supports Joomla! Captcha-Recaptcha type v2. Here we will just describe the standard v2 type which will present a box which is also 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 been verified with jDownloads. To add to the situation the latest Captcha-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 - use link https://accounts.google.com (opens in a new window/tab). 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.
- Getting the Captcha 'keys' from Google.
- Setting up the standard Joomla! Captcha-ReCaptcha Plugin.
- Enabling use in jDownloads.
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.
Very occaisionally the Continue button aimage with a green.tick will appear. But usually you are requested to solve a 'picture' puzzle.
In these cases an image with several sub-images in it is shown.
In this example the supplementary question was to "select all squares with pedestrian crossings".
There were three relevant sub-images. All were clicked and this produced the appropriate 'tick marks' on the image as shown opposite on the far right.
The verify button was then clicked and this then allowed the download.
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.
Getting the Captcha keys
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 (opens in a new window/tab). The principle objective here is to register your site for Captcha keys.
When using the 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 domain was set to "www.mydomain.com" which is obviously replaced with your domain. Note you can add multiple domains.
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.
Finally click on Submit.
After filling, the form looks like the picture on the far right.
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.
Captcha - reCaptcha Plugin
Also ensure you select Version 2.0.
.Note the keys shown are invalid!!
Access would normally be left as 'Public' as jDownloads controls when the Captcha- reCapture is visible.
User Manager Options
Enabling use in jDownloads
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'.
The default setting for this field is No so the other User Groups will not have Captcha set.
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 August 2020, June 2023.