reCAPTCHA Types

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

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.

Invisible reCAPTCHA

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.

reCAPTCHA® Plugin Configuration

System

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.

Integration

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_forum reCAPTCHA v2 If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for the Forum plugin. 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_mediagallery reCAPTCHA v2 If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for the Mediagallery plugin. invisible reCAPTCHA is currently not supported by the Mediagallery plugin.
enable_rating reCAPTCHA v2 If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for the Rating plugin. invisible reCAPTCHA is currently not supported by the Rating plugin.
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_calendar reCAPTCHA v2 If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for the Calendar plugin. If set to invisible reCAPTCHA, the invisible version will be used.
enable_links reCAPTCHA v2 If you set this to reCAPTCHA v2, reCAPTCHA (version 2) will be enabled for the Links plugin. 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.