J3.x

Google ReCaptcha

From Joomla! Documentation

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎Nederlands • ‎svenska
Tutorial
How to set up
Google reCAPTCHA & invisible reCAPTCHA
in Joomla
Joomla! 
3.x

Google introduced a no CAPTCHA reCAPTCHA API in December 2014. The reCAPTCHA plugin, which protects your contact and registration forms against spam, has been updated in Joomla! 3.4.0. While still supporting the old reCAPTCHA 1.0, you can use the reCAPTCHA version 2.0. A significant number of your users can now attest they are human without having to solve a CAPTCHA. Instead with just a single click they’ll confirm they are not a robot!

As of Joomla 3.9, a new plugin CAPTCHA - Invisible reCAPTCHA has been added, allowing to use Invisible reCAPTCHA on your websites. It allows to validate requests in the background, your users don't have to perform any action to validate a form.

Get reCAPTCHA

  • Go to: https://www.google.com/recaptcha
  • Click on the top right button Get reCAPTCHA.
  • Sign in with your Google account. If you don't have one yet, create one.
  • Choose the type of reCAPTCHA you would like to use.
  • Register your new site by filling the necessary fields.

J3.x-Google-ReCaptcha-en.png

Google reCAPTCHA will provide you 2 keys:

  • 1 Site key,
  • 1 Secret key.

Set up Captcha - ReCaptcha Plugin

  • Login to your backend
  • Go to Extensions  Plugins  Captcha - ReCaptcha
  • Edit the plugin:
    • Status: Set to Enable.
    • Version: Choose 2.0.
    • Site key and Secret key: Copy and paste the Site and Secret keys provided by Google reCAPTCHA in their appropriate fields.
    • Theme: Choose one of the 2 available themes.
    • Click Save & Close.

J3.x-Google-ReCaptcha-plugin-en.png

Set up CAPTCHA - Invisible reCAPTCHA Plugin

  • Login to your backend
  • Go to Extensions  Plugins  CAPTCHA - Invisible reCAPTCHA
  • Edit the plugin:
    • Status: Set to Enable.
    • Site key and Secret key: Copy and paste the Site and Secret keys provided by Google reCAPTCHA in their appropriate fields.
    • Badge: Select the position of the badge on your frontend.
    • Tabindex: The tabindex of the challenge. This option can be useful if other elements on your page use tabindex and you want to make the navigation easier. The default value is "0", but you can change it so that your user can focus on the challenge after a certain amount of "tab" hits.
    • Callback: (Optional) JavaScript callback, executed after successful reCAPTCHA response
    • Expired callback: (Optional) JavaScript callback, executed when the reCAPTCHA expired
    • Error callback: (Optional) A JavaScript callback, executed when the reCAPTCHA encounters an error
    • Click Save & Close.

J3.x-Google-Invisible-ReCaptcha-plugin-en.png


Enable CAPTCHA - reCAPTCHA / CAPTCHA - Invisible reCAPTCHA

For Contact forms and the Registration form

  • Go to System  Global Configuration  Site tab
  • Default Captcha: Select CAPTCHA - reCAPTCHA or CAPTCHA - Invisible reCAPTCHA.
  • Click Save & Close.

J3.x-Google-ReCaptcha-Global-Configuration-en.png

J3.x-Google-Invisible-ReCaptcha-Global-Configuration-en.png

For the Registration form only

  • Go to Users  Manage
  • Click on the Options button at the top right and select the User Options tab.
  • In the Captcha option, choose one of the following:
    • None Selected: This setting ignores the Default Captcha setting in Global Configuration. Use it when you want ReCAPTCHA in the Contact forms but not in the Registration form.
    • Captcha - ReCaptcha / Captcha - Invisible ReCaptcha: Only needed if the Default Captcha in the Global Configuration is set to None Selected but you want the ReCAPTCHA in the Registration form only, and not in the contact forms.
  • Click Save & Close.

You can now use the ReCaptcha in your forms! Don't forget to test your ReCaptcha to ensure it is working correctly!

J3.x-Google-ReCaptcha-in-a-Form-en.png

J3.x-Google-Invisible-ReCaptcha-in-a-Form-en.png