Plugin: ReCaptcha
Author: Tobias Frost (blog.coldtobi.de)
See changelog for version history.

For Development-Versions, Bug-Reports etc please visit this dedicated
article on my blog:
http://blog.coldtobi.de/1_coldtobis_blog/archive/128_recaptcha_plugin.html

LICENSE
========

ReCaptcha Library (folder recaptcha/library)

The ReCaptcha library redistributed in this packages is not written by  me, 
and has its own LICENSE file. Please read it carefully. The library also 
be downloaded at http://recaptcha.net/plugins/php/

ReCaptcha Plugin
The plugin is licensed under the GPL v2. See the file copyright for details.

ABSTRACT
=========

This plugin implements the ReCaptcha captcha authentications. 

ReCaptcha is like regular captchas, but in contrast to "regular" ones
these are from scanned books and they already failed being recognized by 
a OCR. So according to the authors of reCaptcha this method is far more
effective. 
For details on  ReCaptcha, please visit http://recaptcha.net.


RECAPTCHA API KEY
=================

You can obtain your ReCaptcha API Key from recaptcha.org. Please note, that it is only
good for one domain (including all sub-domains).

If you host several blogs on different domains, you might want to let the blog owners 
enter their codes individually, and not enter anything in the Administration Settings.

IMPORTANT:
A change in (Apr 2008) now offers to hide a site-wide API Key from blog users via blog settings. 
This option is now configurable in the global blog settings and cannot be changed by blog users. 
The Option is called "plugin_recaptcha_manglekey" and should be enabled to hide the keys.
(This option should be note overrideable by your users.)
IF YOU ARE UPDATING FROM A PRIOR VERSION, MAKE SURE TO UPDATE YOUR SETTINGS OR YOUR KEY MIGHT
BE EXPOSED TO BLOG OWNERS.



MOTIVATION, FEEDBACK
=====================
Some time ago, I stumbled upon ReCaptcha. 
(Story http://blog.coldtobi.de/blog-website/2007/07/05/recaptcha-stop-spam-read-books)
However, as life type currently does not have a well performing captcha plugin,
leading to a lots of automated spam, I decided to implement this. 

Please send me your feedback using my blog or mail me at tobi@coldtobi.de.

You'll probably notice, that I placed a link to my blog at the bottom of the 
captcha. If you like the plugin, I ask you let it intact. 


SETUP & CONFIGURATION
=====================

In order to employ the plugin, do the following
1. Obtain your API Key at recaptcha.net
2. Unzip the zip-file 
3. Configure the plugin with the keys. (See section "ReCaptcha API Key" for details")
4. Add the code to the commentform.template:

CONFIGURATON HINTS
==================

Szenario "One domain for all blogs"

In this case you need a site key for "yourdomain.tld". You want to enter that key in lifetype's
global configuration and disable any overrides from your users to prevent them locking themself out of recaptcha.
("User cannot override"). Enable "plugin_recaptcha_manglekey" to protect your key. 

Szenario "Different domains for the blogs."

The users have to obtain the keys and enter them in their blog settings. Make sure that your users can overide
the settings. 

Szenario "Mixture of the above" 

(This szenario might be not possible with standard lifetype. I don't know if tha mixed mode can be configured)
You need a site key for "yourdomain.tld" and enter this in your global configuration. Enable "plugin_recaptcha_manglekey" to protect your key but this time let the private and public keys be overrideable
by your users.  Instruct your users with the custom domains to get their own keys and enter them in their blog settings. Instruct the others not to touch the settings. 

(For best results, check it after installation: Maybe you have to modify some spacing, or the clearer div)

{ ** Plugin_Recaptcha Code start. ** }
{ ** VERSION plugin_recaptcha 1.10 ** }
{if $recaptcha && $recaptcha->isEnabled()}
    <div style="overflow:auto">
        <label for="recaptcha" style="height:140px">{$locale->tr("recaptcha_type_code")}</label>
        <div id=recaptcha style="border-bottom:0px;">
			{$recaptcha->show()}
        </div>
        <div style="clear:left"></div>
	
    </div>
{/if}
{ ** Plugin_Recaptcha Code end  ** }

