reCAPTCHA

reCAPTCHA is a Vanilla extension that adds reCAPTCHA validation to a forum's membership application form. A new user applicant must answer the reCAPTCHA challenge correctly or the application will not be submitted.

Table of Contents


Installing and Enabling reCAPTCHA

In order for Vanilla to recognize an extension, it must be contained within its own directory within the extensions directory. So, once you have downloaded and unzipped the reCAPTCHA files, you can then place the folder containing the default.php file into your installation of Vanilla. The path to reCAPTCHA's default.php file should look like this:

/path/to/vanilla/extensions/reCAPTCHA/default.php

Once this is complete, you can enable reCAPTCHA through the "Manage Extensions" form on the settings tab in Vanilla.


Configuration Settings

The easiest way to change reCAPTCHA's settings is to install and enable Set List. Once you enable Set List, forum administrators will see a link to reCAPTCHA in the side panel of the Vanilla settings page.

If you choose not to install Set List, you can change reCAPTCHA's settings in the Vanilla conf/settings.php file.

$Configuration['reCAPTCHA.ApplyForm']
If this setting is removed or set to "0", your forum will work normally. If it is set to "1", reCAPTCHA validation is enabled and a new user applicant must correctly answer a reCAPTCHA challenge or the application will be rejected.
$Configuration['reCAPTCHA.PublicKey']
$Configuration['reCAPTCHA.PrivateKey']
You must have a public key and a private key to use reCAPTCHA. If you do not have these keys, you can sign up at recaptcha.net and get them.
$Configuration['reCAPTCHA.Theme']
The theme used for the reCAPTCHA interface. This setting is the same for all users. Valid settings are: 'white', 'red', 'blackglass' and 'clean'.
$Configuration['reCAPTCHA.Language']
The language used in the reCAPTCHA interface. This setting is the same for all users. Valid settigns are: 'en', 'nl', 'fr', 'de', 'pt', 'ru', 'es' and 'tr'.

Vanilla Themes

Theme developers take note: The reCAPTCHA box is a bit large (about 320x140 pixels). If you need to tweak the application form in your theme to make everything fit, add a reCAPTCHA.css file in your theme's styles directory. This style sheet will be added automatically at the end of the style sheet list only when reCAPTCHA validation is being used.


Development

reCAPTCHA was written by squirrel. Inspired by Dinoboff's CAPTCHA extension. Part of the Vanilla Friends project.