= Plone Captcha Field (qPloneCaptchaField) =
[[PageOutline]]
== Product Overview ==

Plone Captcha Field (qPloneCaptchaField) is a Plone product that allows to add captcha field to the form, created with !PloneFormGen product.

== Links ==

 * Home Page - http://quintagroup.com/services/plone-development/products/plone-captcha-field
 * Repository - http://svn.quintagroup.com/products/qPloneCaptchaField
 * Releases - http://plone.org/products/qplonecaptchafield/releases
 * Watch [http://quintagroup.com/cms/screencasts/qplonecaptchafield Plone Captcha Field Screencast] that illustrates how to install and use Plone Captcha Field on a Plone instance.

== Prerequisites ==

To create forms with the captcha field you need to install 3 Plone products:
 * [http://plone.org/products/ploneformgen PloneFormGen] - for creating the form itself
 * [http://plone.org/products/plone-captchas qPloneCaptchas] - for enabling Plone captchas on a Plone site
 * qPloneCaptchaField - for adding captcha field to the form

Make sure the products are installed in this order, otherwise they may fail to work correctly.

 [[Image(products.png, nolink)]]

== !PloneCaptchaField in work ==

To add captcha field to the form:
 * go to the desired form
 * select '''Captcha Field''' from '''Add new...''' drop-down menu

 [[Image(add-new.png, nolink)]]  

 * Captch field is getting its id "key" by default. You only need to save this field.
 
 [[Image(edit.png, nolink)]]  

 * Go back to the form to see the captcha field beneath all other fields

 [[Image(form.png, nolink)]] 

== Captchas Configuration ==
You can configure Plone Captcha Field in !qPloneCaptchas product configuration area.
 * When !qPloneCaptchas product is installed, !qPloneCaptchas Configuration appears under Add-on Product configuration
 * Here you can select what kind of captchas you want to appear: either static or dynamic

 [[Image(setup.png, nolink)]] 

 * In case you select dynamic captchas, in the dynamic captchas image setup options you can configure captcha look by using different font sizes, background and font colors, period, amplitude, random values.
 * As a result your captcha field can look like the following:
 
 [[Image(1.png, nolink)]]
 

 [[Image(2.png, nolink)]]


 [[Image(3.png, nolink)]]