J3.x

Difference between revisions of "Google ReCaptcha"

From Joomla! Documentation

(Several markup and capitalization changes.)
 
Line 2: Line 2:
 
{{Top portal heading|color=white-bkgd|icon=magic|icon-color=#5091cd|size=3x|text-color=#333|title=<translate><!--T:1-->
 
{{Top portal heading|color=white-bkgd|icon=magic|icon-color=#5091cd|size=3x|text-color=#333|title=<translate><!--T:1-->
 
Tutorial<br />
 
Tutorial<br />
How to set up <br />Google reCAPTCHA & invisible reCAPTCHA <br />in Joomla</translate>}}
+
How to set up<br />Google reCAPTCHA & Invisible reCAPTCHA<br />in Joomla</translate>}}
 
<noinclude>{{Joomla version|version=3.x}}</noinclude>
 
<noinclude>{{Joomla version|version=3.x}}</noinclude>
  
Line 8: Line 8:
 
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!</translate>
 
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!</translate>
  
<translate><!--T:39--> As of Joomla 3.9, a new plugin '''CAPTCHA - Invisible reCAPTCHA''' has been added, allowing you to use Invisible reCAPTCHA on your Websites. It allows you to validate requests in the background. Your users don't have to perform any action to validate a form.</translate>
+
<translate><!--T:39--> As of Joomla 3.9, a new plugin '''CAPTCHA - Invisible reCAPTCHA''' has been added, allowing you to use Invisible reCAPTCHA on your websites. It allows you to validate requests in the background. Your users don't have to perform any action to validate a form.</translate>
  
 
<translate>
 
<translate>
Line 19: Line 19:
 
*Click on the top right button '''Admin Console''' or '''Get ReCaptcha'''.</translate>
 
*Click on the top right button '''Admin Console''' or '''Get ReCaptcha'''.</translate>
 
<translate><!--T:6-->
 
<translate><!--T:6-->
*Sign in with your Google account. If you don't have one yet, create one.</translate>
+
*Sign in with your Google account. If you don't have one, create one.</translate>
 
*<translate><!--T:40--> Choose the type of reCAPTCHA you would like to use. Prefer the reCAPTCHA V3 type.</translate>
 
*<translate><!--T:40--> Choose the type of reCAPTCHA you would like to use. Prefer the reCAPTCHA V3 type.</translate>
 
<translate><!--T:7-->
 
<translate><!--T:7-->
*Register your new site by filling the necessary fields.</translate>  
+
*Register your new site by filling the necessary fields.</translate>
  
 
<translate>
 
<translate>
Line 38: Line 38:
  
 
<translate>
 
<translate>
==Set up Captcha== <!--T:57-->
+
==Set Up Captcha== <!--T:57-->
 
</translate>
 
</translate>
  
Line 47: Line 47:
  
 
<translate>
 
<translate>
===Set up Captcha - reCAPTCHA Plugin (V2 Only)=== <!--T:12-->
+
===Set Up Captcha - reCAPTCHA Plugin (V2 Only)=== <!--T:12-->
 
</translate>
 
</translate>
 
<translate><!--T:13-->
 
<translate><!--T:13-->
* Log into your Website's Administrator.</translate>
+
* Log into your website's Administrator.</translate>
 
<translate><!--T:14-->
 
<translate><!--T:14-->
* Go to '''Extensions'''{{rarr}}'''Plugins'''{{rarr}}'''CAPTCHA - reCAPTCHA'''</translate>
+
* Go to {{rarr|Extensions,Plugins,CAPTCHA - reCAPTCHA}}</translate>
 
<translate><!--T:15-->
 
<translate><!--T:15-->
 
* Edit the plugin:</translate>
 
* Edit the plugin:</translate>
 
<translate><!--T:16-->
 
<translate><!--T:16-->
**'''Status:''' Set to ''Enable''.</translate>
+
**'''Status''' Set to ''Enable''.</translate>
 
<translate><!--T:17-->
 
<translate><!--T:17-->
**'''Version:''' Choose ''2.0''.</translate>
+
**'''Version''' Choose ''2.0''.</translate>
 
<translate><!--T:18-->
 
<translate><!--T:18-->
**'''Site key''' and '''Secret key''': Copy and paste the Site and Secret keys provided by Google reCAPTCHA into their appropriate fields.</translate>
+
**'''Site key''' and '''Secret key''' Copy and paste the Site and Secret keys provided by Google reCAPTCHA into their appropriate fields.</translate>
 
<translate><!--T:19-->
 
<translate><!--T:19-->
**'''Theme''': Choose one of the 2 available themes.</translate>
+
**'''Theme''' Choose one of the two available themes.</translate>
 
<translate><!--T:20-->
 
<translate><!--T:20-->
**Click '''Save & Close'''.</translate>
+
**Click ''Save & Close''.</translate>
  
 
[[Image:J3.x-Google-ReCaptcha-plugin-<translate><!--T:21-->
 
[[Image:J3.x-Google-ReCaptcha-plugin-<translate><!--T:21-->
Line 70: Line 70:
  
 
<translate>
 
<translate>
===Set Up CAPTCHA - Invisible reCAPTCHA Plugin=== <!--T:41-->  
+
===Set Up CAPTCHA - Invisible reCAPTCHA Plugin=== <!--T:41-->
 
</translate>
 
</translate>
 
<translate>
 
<translate>
 
<!--T:42-->
 
<!--T:42-->
* Login to your Website's Administrator.</translate>
+
* Login to your website's Administrator.</translate>
 
<translate>
 
<translate>
 
<!--T:43-->
 
<!--T:43-->
* Go to '''Extensions'''{{rarr}}'''Plugins'''{{rarr}}'''CAPTCHA - Invisible reCAPTCHA'''</translate>
+
* Go to {{rarr|Extensions,Plugins,CAPTCHA - Invisible reCAPTCHA}}</translate>
 
<translate>
 
<translate>
 
<!--T:44-->
 
<!--T:44-->
Line 86: Line 86:
 
<translate>
 
<translate>
 
<!--T:46-->
 
<!--T:46-->
**'''Site key''' and '''Secret key''': Copy and paste the Site and Secret keys provided by Google reCAPTCHA into their appropriate fields.</translate>
+
**'''Site key''' and '''Secret key''' Copy and paste the Site and Secret keys provided by Google reCAPTCHA into their appropriate fields.</translate>
 
<translate>
 
<translate>
 
<!--T:47-->
 
<!--T:47-->
**'''Badge''': Select the position of the badge on your front end.</translate>
+
**'''Badge''' Select the position of the badge on your front end.</translate>
 
<translate>
 
<translate>
 
<!--T:48-->
 
<!--T:48-->
**'''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.</translate>
+
**'''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.</translate>
**<translate><!--T:49--> '''Callback''': (Optional) JavaScript callback, executed after successful reCAPTCHA response</translate>
+
**<translate><!--T:49--> '''Callback''' (Optional) JavaScript callback, executed after successful reCAPTCHA response</translate>
**<translate><!--T:50--> '''Expired callback''': (Optional) JavaScript callback, executed when the reCAPTCHA expired</translate>
+
**<translate><!--T:50--> '''Expired callback''' (Optional) JavaScript callback, executed when the reCAPTCHA expired</translate>
**<translate><!--T:51--> '''Error callback''': (Optional) A JavaScript callback, executed when the reCAPTCHA encounters an error</translate>
+
**<translate><!--T:51--> '''Error callback''' (Optional) A JavaScript callback, executed when the reCAPTCHA encounters an error</translate>
**<translate><!--T:52--> Click '''Save & Close'''.</translate>
+
**<translate><!--T:52--> Click ''Save & Close''.</translate>
  
 
[[Image:J3.x-Google-Invisible-ReCaptcha-plugin-<translate><!--T:53-->
 
[[Image:J3.x-Google-Invisible-ReCaptcha-plugin-<translate><!--T:53-->
Line 102: Line 102:
  
 
<translate>
 
<translate>
 
 
== Enable CAPTCHA - reCAPTCHA or CAPTCHA - Invisible reCAPTCHA== <!--T:22-->
 
== Enable CAPTCHA - reCAPTCHA or CAPTCHA - Invisible reCAPTCHA== <!--T:22-->
 
</translate>
 
</translate>
 
<translate>
 
<translate>
===For Contact Forms and the Registration Form=== <!--T:23-->
+
===For Contact and Registration Form=== <!--T:23-->
</translate>  
+
</translate>
 
<translate><!--T:24-->
 
<translate><!--T:24-->
* Go to '''System'''{{rarr}}'''Global Configuration'''{{rarr}}'''Site''' tab</translate>
+
* Go to {{rarr|System,Global Configuration,Site}} tab</translate>
 
<translate><!--T:25-->
 
<translate><!--T:25-->
*'''Default Captcha''': Select ''CAPTCHA - reCAPTCHA'' or ''CAPTCHA - Invisible reCAPTCHA''.</translate>
+
*'''Default Captcha''' Select ''CAPTCHA - reCAPTCHA'' or ''CAPTCHA - Invisible reCAPTCHA''.</translate>
 
<translate><!--T:26-->
 
<translate><!--T:26-->
*Click '''Save & Close'''.</translate>
+
*Click ''Save & Close''.</translate>
  
 
[[Image:J3.x-Google-ReCaptcha-Global-Configuration-<translate><!--T:27-->
 
[[Image:J3.x-Google-ReCaptcha-Global-Configuration-<translate><!--T:27-->
Line 129: Line 128:
 
<translate>
 
<translate>
 
<!--T:60-->
 
<!--T:60-->
*Go to ''Components''{{rarr}}''Contacts''{{rarr}}''Options''{{rarr}}''Form'' tab{{rarr}}''Allow Captcha on Contact''.
+
* Go to {{rarr|Components,Contacts,Options,Form tab,Allow Captcha on Contact}}.
*Select ''Use Global...''.
+
* Select ''Use Global''
*Save and Close.
+
* Select ''Save and Close''
 
</translate>
 
</translate>
  
Line 138: Line 137:
 
</translate>
 
</translate>
 
<translate><!--T:29-->
 
<translate><!--T:29-->
*Go to '''Users'''{{rarr}}'''Manage'''</translate>
+
* Go to {{rarr|Users,Manage}}</translate>
 
<translate><!--T:30-->
 
<translate><!--T:30-->
*Click on the '''Options''' button at the top right and select the '''User Options''' tab.</translate>
+
* Click on the ''Options'' button at the top right and select the ''User Options'' tab.</translate>
 
<translate><!--T:31-->
 
<translate><!--T:31-->
*In the '''Captcha''' option, choose one of the following:</translate>
+
* In the ''CAPTCHA'' option, choose one of the following:</translate>
 
<translate><!--T:32-->
 
<translate><!--T:32-->
**''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.</translate>
+
** ''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.</translate>
 
<translate><!--T:34-->
 
<translate><!--T:34-->
**''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.</translate>
+
** ''CAPTCHA - reCAPTCHA''/''CAPTCHA - Invisible reCAPTCHA'': Only needed if the default CAPTCHA in ''Global Configuration'' is set to ''None Selected'' but you want the reCAPTCHA in the Registration form only, and not in the contact forms.</translate>
 
<translate><!--T:35-->
 
<translate><!--T:35-->
*Click '''Save & Close'''.</translate>
+
* Click ''Save & Close''.</translate>
+
 
 
<translate><!--T:36-->
 
<translate><!--T:36-->
You can now use the reCAPTCHA in your forms!
+
You can now use the reCAPTCHA in your forms.
Don't forget to test your reCAPTCHA to ensure it is working correctly!</translate>
+
Test your reCAPTCHA to ensure it is working correctly.</translate>
  
 
[[Image:J3.x-Google-ReCaptcha-in-a-Form-<translate><!--T:37-->
 
[[Image:J3.x-Google-ReCaptcha-in-a-Form-<translate><!--T:37-->

Latest revision as of 14:50, 26 November 2022

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎italiano • ‎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 you to use Invisible reCAPTCHA on your websites. It allows you to validate requests in the background. Your users don't have to perform any action to validate a form.

Get reCAPTCHA[edit]

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

For additional guidance in choosing the type of reCAPTCHA, visit Google's Guide page, Choosing the type of reCAPTCHA.

Google reCAPTCHA will provide you two keys:

  • One Site key
  • One Secret key

Set Up Captcha[edit]

Choose one of the reCAPTCHA types below.

Set Up Captcha - reCAPTCHA Plugin (V2 Only)[edit]

  • Log into your website's Administrator.
  • 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 into their appropriate fields.
    • Theme Choose one of the two available themes.
    • Click Save & Close.

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

Set Up CAPTCHA - Invisible reCAPTCHA Plugin[edit]

  • Login to your website's Administrator.
  • 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 into their appropriate fields.
    • Badge Select the position of the badge on your front end.
    • 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 or CAPTCHA - Invisible reCAPTCHA[edit]

For Contact and Registration Form[edit]

  • 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

Edit the Contact Form Options Setting

  • Go to Components  Contacts  Options  Form tab  Allow Captcha on Contact.
  • Select Use Global
  • Select Save and Close

For the Registration Form Only[edit]

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