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

= Registration using Recaptcha

== Description

This plugin 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:''' There is a [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] improvements/fixes.

== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=RecaptchaRegisterPlugin new ticket].

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

== Download

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

== Source

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

== Installation

 1. Install the AccountManagerPlugin. Make sure you have '''disabled''' the [wiki:AccountManagerPlugin#RegistrationModule RegistrationModule], since you'll be using this registration instead.
 1. 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
}}}
 1. Install this plugin:
 {{{#!sh
easy_install https://trac-hacks.org/svn/recaptcharegisterplugin/0.11
}}}
 1. 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:'''