Simplify Your Web

Details

Category: Custom reCaptcha

Install the plugin through the Extension Manager of the Joomla administrator's console. It will install the Custom reCaptcha plugin and the Simplify Your Web Extensions library.

Note You can download and install the plugin directly from the Install from Web tab of your website. Type simplifyyourweb in the search box and select Custom reCaptcha.

Starting with version 2.0.0, the extensions library is required for the plugin. It is installed automatically with the plugin. If, for any reason, the library fails to install or update, please download and install manually.

Details

Category: Custom reCaptcha

Before updating, make sure you read the change logs and are aware of potential backward compatibility issues.

Migrating to v2.2 from v2.1.x

There are no backward incompatibilities. The new version can be safely installed over previous versions of the plugin.

Migrating to v2.1 from v2.0.x

There are no backward incompatibilities. The new version can be safely installed over previous versions of the plugin.

Migrating to v2.0 from v1.x

There are no backward incompatibilities. The new version can be safely installed over previous versions of the plugin.

Details

Category: Custom reCaptcha

The reCaptcha widget will not work unless you have registered your domain at Google and acquired site (public) and secret (private) keys.

However, you can test the reCaptchas on a production site with the following test keys:

• site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Note You can now use the test mode rather than entering the test keys manually.

You need to enter those keys in the Custom reCaptcha plugin, under the Mandatory Options tab.

If you were previously using the Joomla! core reCaptcha plugin on your site, the values of the keys should have been transferred automatically to the Custom reCaptcha plugin on install.

Register your site at Google:

Get reCAPTCHA

Warning Keys for version 1 of the widget are not handed out anymore. All keys created by Google are now working for version 2 of the widget only. If you are using version 1 of the widget and want to upgrade to version 2 (no Captcha or invisible), you will need to get new keys for your site.

Details

Category: Custom reCaptcha

Google turned off reCAPTCHA v1 on March 31, 2018. Any calls to the v1 API no longer work.

Fully customize version 1 of the widget, especially when a fully responsive solution is needed for your site. The visitors need to copy the words seen or heard.

Layout	Default The default layout Bootstrap A layout that is Bootstrap-based Icons A layout with icons as links (uses Bootstrap for tooltips) One or more layout(s) that you have created as template override(s), with names different than default or Bootstrap
CSS classes	Classes you want to affect to the outer most layer of the widget
CSS styles	Styles you want to use to improve the look of the widget. Styles will be minimized

Note The audio challenges use Flash. This technology is phasing out of the browsers, therefore your visitors may just see a link to download an mp3 file and never automatically hear the audio file.

How to make the widget responsive

This will mostly depend on the CSS you will use to style the widget.
In order to make the image responsive, you will most likely need to add the following CSS:

[code]#recaptcha_image {
    width: auto !important;
    height: auto!important;
}
#recaptcha_challenge_image {
    max-width: 100%;
}[/code]

Internationalization

The reCaptcha widget will be fully translated IF the Custom reCaptcha plugin supports the language requested (all the Google supported languages for the widget version 1 are available in the plugin).

Troubleshoot

Problem The Bootstrap template's input field is not responsive

Solution You can fix this with CSS, for instance (change the code to fit your template)

[code]@media screen and (max-width: 767px) {
    .g-recaptcha .input-append { width: 60px; }
}[/code]

Details

Category: Custom reCaptcha

The plugin now offers 2 layouts to start with. The default layout (found in the previous versions of the plugin) and a Bootstrap layout. The templates can easily be modified (you may even add your own) by using template overrides.

Go to the template manager.

Create the directory [template]/html/plg_captcha_customrecaptcha

Note Overrides can only be created manually, the Joomla! interface does not allow them to be generated automatically, unlike modules for instance.

On the server, go to plugins/captcha/customrecaptcha/tmpl

Copy the layout file(s) you wish to override (default.php and/or bootstrap.php).

Paste all files into [template]/html/plg_captcha_customrecaptcha. Modify them to your liking.

The files found in [template]/html/plg_captcha_customrecaptcha will have priority over the plugin's default layouts (as long as file names have been unchanged).

Note You can also add your own files with different names, which will be selectable from the plugin's layout parameter.

Details

Category: Custom reCaptcha

Not all elements are 'visible' when the widget is loaded on the page. For instance, when you see an image captcha, all audio elements are missing. Therefore, you have to take care of the visible and invisible elements when you skin the widget (unless you remove some of its functionality).

.g-recaptcha

.recaptcha_isnot_showing_audio

.recaptcha_is_showing_audio

The widget's outer classes

#recaptcha_response_field

The user's response input field

.recaptcha_only_if_image

The link that gives the user the possibility to switch to an audio captcha

.recaptcha_only_if_audio

The link that gives the user the possibility to switch to an image captcha

#recaptcha_image

The image shown or the audio place-holder

.recaptcha_only_if_incorrect_sol

Feedback message when the user's answer is wrong, like Incorrect, please try again

.recaptcha_reload

The link that offers the user the possibility to load a new captcha

.recaptcha_help

The link to get help from Google

#recaptcha_audio_play_again .recaptcha_audio_cant_hear_link

The link that offers to play the sound again

#recaptcha_audio_download .recaptcha_audio_cant_hear_link

The link that offers to download the sound

#recaptcha_privacy .recaptcha_only_if_privacy

The link that goes to Google's privacy and terms of use pages