As of reCaptcha v1.2.1 an API was added which plugins must now use to enable support. Plugin Integration for reCAPTCHA is now controlled in the Plugins own Configuration and not the reCAPTCHA configuration.
Geeklog's reCAPTCHA plugin supports both reCAPTCHA v2 and Invisible reCAPTCHA. Both will require you to setup on the Google reCAPTCHA website (https://www.google.com/recaptcha/admin/create). You will need to create an account and add your site and create a site key and a secret key to be able to use the free service.
reCAPTCHA v2 requires the user to click a checkbox indicating the user is not a robot. This will either pass the user immediately (with No CAPTCHA) or challenge them to validate whether or not they are human.
Unlike reCAPTCHA v2, 'Invisible reCAPTCHA' does not require the user to click on a checkbox, instead it is invoked directly when the user clicks on an existing button on your site. By default only the most suspicious traffic will be prompted to solve a captcha. To alter this behavior edit your site security preference under advanced settings on the Google reCAPTCHA website.
For more information on the different reCAPTCHA types please go to https://developers.google.com/recaptcha/docs/versions.
Variable | Default Value | Description |
---|---|---|
site_key | (empty) | reCAPTCHA API Site Key. If you don't have one, please go to https://www.google.com/recaptcha/admin/create and sign up. |
secret_key | (empty) | reCAPTCHA API Secret Key. If you don't have one, please go to https://www.google.com/recaptcha/admin/create and sign up. |
invisible_site_key | (empty) | Invisible reCAPTCHA API Site Key. If you don't have one, please go to https://www.google.com/recaptcha/admin/create and sign up. |
invisible_secret_key | (empty) | Invisible reCAPTCHA API Secret Key. If you don't have one, please go to https://www.google.com/recaptcha/admin/create and sign up. |
logging | No | If you set this to Yes, reCAPTCHA plugin will log invalid reCAPTCHA attempts into the log file (recaptcha.log). |
anonymous_only | No | If you set this to Yes, reCAPTCHA will be shown to anonymous users only. |
remoteusers | No | If you set this to Yes, reCAPTCHA will be forced upon all Remote Users. |
Variable | Default Value | Description |
---|---|---|
enable_comment | reCAPTCHA v2 | If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for comments. If set to invisible reCAPTCHA, the invisible version will be used. |
enable_contact | reCAPTCHA v2 | If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for contact. If set to invisible reCAPTCHA, the invisible version will be used. |
enable_emailstory | reCAPTCHA v2 | If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for emailing a article. If set to invisible reCAPTCHA, the invisible version will be used. |
enable_registration | reCAPTCHA v2 | If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for user registration. If set to invisible reCAPTCHA, the invisible version will be used. |
enable_story | reCAPTCHA v2 | If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for submitting a article. If set to invisible reCAPTCHA, the invisible version will be used. |
enable_getpassword | reCAPTCHA v2 | If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for Forget Password Form. If set to invisible reCAPTCHA, the invisible version will be used. |
enable_loginform | reCAPTCHA v2 | If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for Login Form. If set to invisible reCAPTCHA, the invisible version will be used. Important: If any type of CAPTCHA is enabled for the user login you must disable Read Access for Anonymous users for the User Functions block. The Block Name is "user_block" and you can find the permission under Access Rights on the Block Editor form. The reason for this is because this block will display a mini login form that does not support reCAPTCHA and therefore will always fail to login the user from it. Do not disable this block completely as the User Functions block is needed once users are logged in. You should then make sure the login menu element is enabled in the Geeklog Configuration so users can find out how to access the full page login form. |