plone.formwidget.recaptcha is a
z3c.form ReCaptcha widget for use with Plone.
It is a z3c.form re-implementation of the collective.recaptcha package original written by David Glick.
Add the following code to your buildout.cfg to install plone.formwidget.recaptcha:
[buildout] ... [instance] ... eggs = ... plone.formwidget.recaptcha ...
There is a control panel at
http://path/to/site/@@recaptcha-settings to configure the Addon.
Google provides a set of test keys, that can be used to try out the recaptcha form
and documentation at https://developers.google.com/recaptcha/docs/faq.
Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
To actually use the service, you must obtain a site key and secret key from developers.google.com/recaptcha
See the demo folder inside the distribution for an example usage.
You can add a captcha field in an XML model by adding something like this:
<field name="captcha" type="plone.formwidget.recaptcha.ReCaptchaWidget"> <title>Solve Captcha</title> <description></description> </field>
Upgrade to API v2
plone.formwidget.recaptcha 2.* uses V2 of the reCaptcha API. Users upgrading from plone.formwidget.recaptcha 1.* will therefore need to generate new keys as global Keys are not supported in the V2 API.
Contributors please read the document Process for Plone core's development
Sources are at the Plone code repository hosted at Github.