= quintagroup.formlib.captcha =

== Links ==

 * Home page - http://quintagroup.com/services/plone-development/products/quintagroup.formlib.captcha
 * Repository - http://svn.quintagroup.com/products/quintagroup.formlib.captcha
 * Releases - https://pypi.python.org/pypi/quintagroup.formlib.captcha

== Introduction ==

quintagroup.formlib.captcha allows adding captcha field to the [http://pypi.python.org/pypi/zope.formlib zope.formlib] forms. As a result such forms are prevented from automatic submit. Captcha field for formlib is based on [wiki:quintagroup.captcha.core quintagroup.captcha.core] package.

== Captchas in a formlib form ==

Using quintagroup.formlib.captcha in a formlib form is simple. Just add a Captcha field to your schema, and away you go:

{{{
    >>> from zope.interface import Interface
    >>> from quintagroup.formlib.captcha import Captcha
    >>> class CaptchaSchema(Interface):
    ...     captcha = Captcha(
    ...         title=_(u'Type the code'),
    ...         description=_(u'Type the code from the picture shown below.'))
}}}

and formlib will take care of the rest. The widget associated with this field will render the captcha and verify the use input automatically.


== Supported Plone versions ==

quintagroup.formlib.captcha was tested with Plone 3.x and Plone 4.0.

== Notes ==

 * If you want to change captcha look - use [wiki:quintagroup.captcha.core quintagroup.captcha.core] settings.
 * If you want captcha for default Plone forms - use [wiki:quintagroup.plonecaptchas quintagroup.plonecaptchas] product.