[[PageOutline(2-5,Contents,pullout)]]

= Recaptcha Register Plugin

== Description

This hack adds a [http://recaptcha.net/ reCAPTCHA] that the user must pass before registering. You must have the AccountManagerPlugin installed.

This plugin is being developed for [http://trac.usla.org.ar USLA tracs], a service by and for the Free Software Users of Argentina.

It is loosely based on the work of TracRecaptchaPlugin, so it's GPL licensed as well.

'''Fork:''' I have made a small [https://github.com/trac-hacks/trac-recaptcharegister fork on GitHub] with some improvements/fixes. Feel free to [https://github.com/trac-hacks/trac-recaptcharegister/issues suggest new].

== Bugs/Feature Requests

Existing bugs and feature requests for RecaptchaRegisterPlugin are 
[report:9?COMPONENT=RecaptchaRegisterPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=RecaptchaRegisterPlugin&owner=alecu new ticket].

[[TicketQuery(component=RecaptchaRegisterPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [download:recaptcharegisterplugin here].

== Source

You can check out RecaptchaRegisterPlugin from [http://trac-hacks.org/svn/recaptcharegisterplugin here] using Subversion, or [source:recaptcharegisterplugin browse the source] with Trac.

== Usage
=== Install the Account Manager plugin

Please see AccountManagerPlugin page. Make sure you have '''disabled''' the [wiki:AccountManagerPlugin#RegistrationModule RegistrationModule], since you'll be using this registration instead.

=== Install the recaptcha python module

RecaptchaRegisterPlugin '''depends''' on this module. If it is not installed, then Trac will not show the RecaptchaRegisterPlugin, and will only show an error if you setup Trac's logging.

{{{#!sh
easy_install recaptcha_client
}}}

=== Install this plugin

{{{#!sh
easy_install http://trac-hacks.org/svn/recaptcharegisterplugin/0.11
}}}

=== Setup reCAPTCHA

You need to make an account at http://recaptcha.net/ to receive your public and private keys. 

Edit your `conf/trac.ini` file and add these lines, including your public and private reCAPTCHA keys:

{{{#!ini
[components]
recaptcharegister.* = enabled

[recaptcha]
public_key = 
private_key =
}}}

== Recent Changes

[[ChangeLog(recaptcharegisterplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:alecu] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''