collective.recaptcha

by David Glick last modified Aug 19, 2011 10:57 PM

Wraps the recaptcha-client library to provide a drop-in replacement for collective.captcha.

Project Description

collective.recaptcha

This package provides an integration of the Recaptcha service into Zope. Recaptcha is a third-party CAPTCHA service provided by Carnegie Mellon University. One of its most interesting features is that the act of users answering CAPTCHAs contributes to efforts to digitize books.

The API is based on collective.captcha and is provided via a "@@captcha" browser view, so these two packages can be swapped for each other relatively simply. Use collective.captcha if you need to not be dependent on an external service; use collective.recaptcha for a slightly better user experience.

Installation and Configuration

Simply make sure that the ZCML for this package is loaded. (You cannot configure this package at the same time as collective.captcha, because the '@@captcha' browser view registration will conflict.)

Before the service will work, you must obtain a public and private key from http://recaptcha.net, and configure them at http://path/to/site/@@recaptcha-settings

Usage

You can insert a Recaptcha using the following TAL:

<tal:block tal:replace="structure context/@@captcha/image_tag"/>

You can verify Recaptcha input by testing the return value of:

context.restrictedTraverse('@@captcha').verify()

Differences between this package's API and collective.captcha

Because the simplest form of Recaptcha is rendered entirely via a remote call to the service, we couldn't implement the ICaptchaView interface from collective.captcha exactly as it was defined there. Differences include:

* The image_tag method returns the HTML for the entire CAPTCHA widget,
  including text entry and audio link, not just the tag for the CAPTCHA
  image.

* The audio_url method returns None

* The verify method does not require the input parameter, as a standard
  form input name is used and the value can be found in the request.

* There is an additional method, external, which simply returns True.
  This is a bit of a hack so that a template requiring captcha can
  adjust to the different semantics of the @@captcha view in this
  package as compared to collective.captcha.

Changelog

1.1.3 (2011-08-19)

  • Add z3c.autoinclude entry point for automatic ZCML loading in Plone 3.3+. [WouterVH]

1.1.2 (2011-05-17)

  • Require the latest version of recaptcha-client, which has the correct HTTPS URL for the recaptcha service. [davisagli]
  • Add support for Zope2.13: try to use five.formlib first. [toutpt]

1.1.1 (2011-02-15)

  • Register the @@captcha view using browser:page instead of browser:view, because I still fail to understand the latter and was breaking access from restricted python in Zope 2.12. [davisagli]

1.1 (2010-11-18)

  • Use the recaptcha settings from plone.formwidget.recaptcha if it is installed, since it overrides our recaptcha-settings view. [davisagli]

1.0.1 (2009-08-05)

  • Disallowed dependency on broken release of recaptcha-client (1.0.4). [davisagli]

1.0 (2009-05-04)

  • Fixed method signature for verify method so that the vestigial input parameter from collective.captcha's ICaptchaView is no longer required. [davisagli]
  • Added documentation. [davisagli]

1.0b2 (2009-01-14)

  • Correctly handle comma-delimited values in the HTTP_X_FORWARDED_FOR header. [davisagli]
  • Added support for verifying the captcha multiple times within the same request. [davisagli]
  • Added security declarations on the view methods so they can be called from restricted Python. [davisagli]

1.0b1 (2009-01-14)

  • Initial release

Current Release
collective.recaptcha 1.1.3

Released Aug 19, 2011

Download file Get collective.recaptcha for all platforms
collective.recaptcha-1.1.3.zip
If you are using Plone 3.2 or higher, you probably want to install this product with buildout. See our tutorial on installing add-on products with buildout for more information.

All Releases

Version Released Description Compatibility Licenses Status
1.1.3 Aug 19, 2011 More about this release… LGPL final
1.1.2 May 17, 2011 More about this release… LGPL final
1.1.1 Feb 15, 2011 More about this release… LGPL final
1.1 Nov 18, 2010 Use the settings from plone.formwidget.recaptcha if available. More about this release…
Plone 4
Plone 3
LGPL final
1.0b2 More about this release… GPL beta
1.0b1 More about this release… GPL beta
1.0.1 Aug 06, 2009 More about this release… LGPL final
1.0 May 04, 2009 More about this release… LGPL final