$Id: README.txt,v 1.13.4.2.2.6.2.2 2008-01-26 17:24:07 robloach Exp $

reCAPTCHA for Drupal
====================

The reCAPTCHA module uses the reCAPTCHA web service to
improve the CAPTCHA system and protect email addresses. For
more information on what reCAPTCHA is, please visit:
    http://recaptcha.net


INSTALLATION
------------

1. Extract the reCAPTCHA module to your local favourite
   modules directory (sites/all/modules).
   
2. Download the reCAPTCHA PHP Library from: 
       http://recaptcha.net/plugins/php/index.html

3. Extract the library files to: modules/recaptcha/recaptcha
   So that recaptchalib.php is available at:
       modules/recaptcha/recaptcha/recaptchalib.php


CONFIGURATION
-------------
   
1. Enable reCAPTCHA and CAPTCHA modules in:
       admin/build/modules
   
2. You'll now find a reCAPTCHA tab in the CAPTCHA
   administration page available at:
       admin/user/captcha/recaptcha

6. Register for a public and private reCAPTCHA key at:
       http://recaptcha.net/api/getkey

7. Input the keys into the reCAPTCHA settings. The rest of
   the settings should be fine as their defaults.

8. Visit the Captcha administration page and set where you
   want the reCAPTCHA form to be presented:
       admin/user/captcha


MAILHIDE INPUT FORMAT
---------------------

The reCAPTCHA module also comes with an input format to
protect email addresses. This, of course, is optional to
use and is only there if you want it. The following is how
you use that input filter:

1. Enable the reCAPTCHA Mailhide module:
       admin/build/modules

2. Head over to your input format settings:
       admin/settings/filters

3. Edit your default input format and add the reCAPTCHA
   Mailhide filter.
   
4. Click on the Configure tab and put in a public and
   private Mailhide key obtained from:
       http://mailhide.recaptcha.net/apikey

5. Use the Rearrange tab to rearrange the weight of the
   filter depending on what filters already exist.  Make
   sure it is before the URL Filter.

Note: You will require the installation of the mcrypt
      PHP module in your web server for Mailhide to work:
         http://uk2.php.net/manual/en/ref.mcrypt.php


MULTI-DOMAIN SUPPORT
--------------------

Since reCAPTCHA uses API keys that are unique to each
domain, if you're using a multi-domain system using the
same database, the reCAPTCHA module won't work when
querying the reCAPTCHA web service.  If you put the
following into your sites/mysite/settings.php file for
each domain, it will override the API key values and make
it so multi-domain systems are capable.

  $conf = array(
    'recaptcha_public_key' =>  'my other public key',
    'recaptcha_private_key' =>  'my other private key',
  );


CUSTOM RECAPTCHA THEME
----------------------

You can create a custom reCAPTCHA theme widget by setting
the theme of the reCAPTCHA form to "custom" in the
reCAPTCHA administration page.  This will output a custom
form that is themeable through the theme function:
  theme_recaptcha_custom_widget().

If you don't implement this function, it is still quite
easily customizable through manipulating the CSS.

For more information on this, visit:
http://recaptcha.net/apidocs/captcha/client.html#customization


CHANGELOG
---------

http://drupal.org/project/cvs/147903?branch=DRUPAL-6--1


THANK YOU
---------

 * Thank you goes to the reCAPTCHA team for all their
   help, support and their amazing Captcha solution
       http://www.recaptcha.net