[[PageOutline(2-5,Contents,pullout)]] = !TracCaptcha == Description This plugin embeds a captcha in the ticket page in addition to Trac's regular permission checks. Its purpose is to keep spammers out of the Trac environment. '''Fully functional:''' The popular reCAPTCHA system is supported out of the box. Technically it's a plugin: if you don't like it, you are free to use any other plugin while still leverage the benefits from the general captcha infrastructure. '''Does not annoy users:''' After the user entered the captcha once, he does not have to solve the captcha again for the same ticket when he just clicks 'preview'. Also you can configure exempt certain users or groups (e.g. 'all authenticated users') from the captchas just by using Trac's permission system. '''Generic Infrastructure:''' !TracCaptcha takes care about embedding a given captcha in the appropriate places which means that building a different captcha plugin is easy - you just have to build the captcha itself while this code will take care of the Trac integration. The whole code is licensed under the very liberal [http://en.wikipedia.org/wiki/MIT_License MIT license], so you can use the API in your own code without problems. == See it in Action [[Image(wiki:TracCaptchaPlugin:captcha_example.png)]] The macro is also used on the '''[http://www.schwarz.eu/opensource/projects/trac_captcha/ project page]''', but please keep in mind that this is not an online demo, so do not create tickets to test the captcha! == Download The latest sources are available from the [http://www.schwarz.eu/opensource/projects/trac_captcha/ project page] and [pypi:TracCaptcha]. === Configuration Enable the macro in your `trac.ini`: {{{ #!ini [components] trac_captcha.* = enabled # only needed if you want to use reCAPTCHA trac_recaptcha.* = enabled [recaptcha] # add here the keys you obtained from http://recaptcha.net/api/getkey public_key = ... private_key = ... }}} If you want to exempt some users from the captcha, grant them the `CAPTCHA_SKIP` privilege. TICKET_ADMINs and TRAC_ADMINs automatically have this privilege, so they will never see a captcha. Also a user only needs to solve the captcha once per modification, so you can click 'preview' as often as you like without having to solve the captcha all over again. === Dependencies and Compatibility * Python 2.3-2.7 * [trac: Trac] 0.11, 0.12, 0.13 * Optional: [http://www.pycrypto.org PyCrypto] for better security on Python 2.3 and 2.4 == Bugs/Feature Requests Existing bugs and feature requests for the !TracCaptcha plugin are stored on the [http://www.schwarz.eu/opensource/projects/trac_captcha/ project page]. Please do not file bugs in the trac-hacks bug tracker. == Author/Contributors '''Author:''' [wiki:felix_schwarz] [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:'''