|
1
|
reCAPTCHA for Drupal
|
|
2
|
====================
|
|
3
|
|
|
4
|
The reCAPTCHA module uses the reCAPTCHA web service to
|
|
5
|
improve the CAPTCHA system and protect email addresses. For
|
|
6
|
more information on what reCAPTCHA is, please visit:
|
|
7
|
https://www.google.com/recaptcha
|
|
8
|
|
|
9
|
|
|
10
|
DEPENDENCIES
|
|
11
|
------------
|
|
12
|
|
|
13
|
* reCAPTCHA depends on the CAPTCHA module.
|
|
14
|
https://drupal.org/project/captcha
|
|
15
|
* Some people have found that they also need to use jQuery Update module.
|
|
16
|
https://drupal.org/project/jquery_update
|
|
17
|
|
|
18
|
|
|
19
|
CONFIGURATION
|
|
20
|
-------------
|
|
21
|
|
|
22
|
1. Enable reCAPTCHA and CAPTCHA modules in:
|
|
23
|
admin/modules
|
|
24
|
|
|
25
|
2. You'll now find a reCAPTCHA tab in the CAPTCHA
|
|
26
|
administration page available at:
|
|
27
|
admin/config/people/captcha/recaptcha
|
|
28
|
|
|
29
|
3. Register for a public and private reCAPTCHA key at:
|
|
30
|
https://www.google.com/recaptcha/whyrecaptcha
|
|
31
|
|
|
32
|
4. Input the keys into the reCAPTCHA settings. The rest of
|
|
33
|
the settings should be fine as their defaults.
|
|
34
|
|
|
35
|
5. Visit the Captcha administration page and set where you
|
|
36
|
want the reCAPTCHA form to be presented:
|
|
37
|
admin/config/people/captcha
|
|
38
|
|
|
39
|
|
|
40
|
MAILHIDE INPUT FORMAT
|
|
41
|
---------------------
|
|
42
|
|
|
43
|
The reCAPTCHA module also comes with an input format to
|
|
44
|
protect email addresses. This, of course, is optional to
|
|
45
|
use and is only there if you want it. The following is how
|
|
46
|
you use that input filter:
|
|
47
|
|
|
48
|
1. Enable the reCAPTCHA Mailhide module:
|
|
49
|
admin/modules
|
|
50
|
|
|
51
|
2. Head over to your text format settings:
|
|
52
|
admin/config/content/formats
|
|
53
|
|
|
54
|
3. Edit your default input format and add the reCAPTCHA
|
|
55
|
Mailhide filter.
|
|
56
|
|
|
57
|
4. Click on the Configure tab and put in a public and
|
|
58
|
private Mailhide key obtained from:
|
|
59
|
https://www.google.com/recaptcha/mailhide/apikey
|
|
60
|
|
|
61
|
5. Use the Rearrange tab to rearrange the weight of the
|
|
62
|
filter depending on what filters already exist. Make
|
|
63
|
sure it is before the URL Filter.
|
|
64
|
|
|
65
|
Note: You will require the installation of the mcrypt
|
|
66
|
PHP module in your web server for Mailhide to work:
|
|
67
|
http://php.net/manual/en/ref.mcrypt.php
|
|
68
|
|
|
69
|
|
|
70
|
MULTI-DOMAIN SUPPORT
|
|
71
|
--------------------
|
|
72
|
|
|
73
|
Since reCAPTCHA uses API keys that are unique to each
|
|
74
|
domain, if you're using a multi-domain system using the
|
|
75
|
same database, the reCAPTCHA module won't work when
|
|
76
|
querying the reCAPTCHA web service. If you put the
|
|
77
|
following into your sites/mysite/settings.php file for
|
|
78
|
each domain, it will override the API key values and make
|
|
79
|
it so multi-domain systems are capable.
|
|
80
|
|
|
81
|
$conf = array(
|
|
82
|
'recaptcha_public_key' => 'my other public key',
|
|
83
|
'recaptcha_private_key' => 'my other private key',
|
|
84
|
);
|
|
85
|
|
|
86
|
|
|
87
|
CUSTOM RECAPTCHA THEME
|
|
88
|
----------------------
|
|
89
|
|
|
90
|
You can create a custom reCAPTCHA theme widget by setting
|
|
91
|
the theme of the reCAPTCHA form to "custom" in the
|
|
92
|
reCAPTCHA administration page. This will output a custom
|
|
93
|
form that is themeable through the theme function:
|
|
94
|
theme_recaptcha_custom_widget().
|
|
95
|
|
|
96
|
If you don't implement this function, it is still quite
|
|
97
|
easily customizable through manipulating the CSS.
|
|
98
|
|
|
99
|
For more information on this, visit:
|
|
100
|
https://developers.google.com/recaptcha/docs/customization
|
|
101
|
|
|
102
|
|
|
103
|
THANK YOU
|
|
104
|
---------
|
|
105
|
|
|
106
|
* Thank you goes to the reCAPTCHA team for all their
|
|
107
|
help, support and their amazing Captcha solution
|
|
108
|
https://www.google.com/recaptcha
|
