== Quintagroup Plone Captchas == The Captchas products story started back in 2006 with '''[http://svn.quintagroup.com/products/qPloneCaptchas qPloneCaptchas]''' Plone product which supported Plone versions 2.0.x, 2.1.x and 2.5.x. Later it was refactored into '''[http://svn.quintagroup.com/products/quintagroup.plonecaptchas quintagroup.plonecaptchas]''' package which supported Plone versions 3.0.x-3.3.x. From version 3.0 and on quintagroup.plonecaptchas goes though another refactoring: * the standard Plone customizations (Join, Send this page, Contact Us, Reply) are staying in '''quintagroup.plonecaptchas''' * the captchas core rendering and validation functionality are factored into '''[http://svn.quintagroup.com/products/quintagroup.captcha.core quintagroup.captcha.core]''' package We are adding the following three packages to the stack: * '''[http://svn.quintagroup.com/products/quintagroup.pfg.captcha quintagroup.pfg.captcha]''' (earlier known as qPloneCaptchasField) * '''[http://svn.quintagroup.com/products/quintagroup.formlib.captcha quintagroup.formlib.captcha]''' contains formlib field and widget * '''[http://svn.quintagroup.com/products/quintagroup.z3cform.captcha quintagroup.z3cform.captcha]''' contains z3cform field and widget All the stack is set up as dependency for quintagroup.plonecaptchas, so you just need to mention them in your buildout to get all captcha packages. ---------------------------------------------- == quintagroup.captcha.core == Quintagroup Captcha Core allows configure captchas on your Plone site: its size, color, etc. After its installation you'll see '''Plone captchas setup''' option under Add-on Product Configuration in Site Setup. [[Image(captcha-core.png, nolink)]] Here you can select what kind of captchas you want to appear: either static or dynamic. In case you select dynamic captchas, in the dynamic captchas image setup options you can configure captchas look by using different font sizes, background and font colours, period, amplitude, random values. As a result your captchas field can look like the following: [[Image(1.png, nolink)]] [[Image(2.png, nolink)]] [[Image(3.png, nolink)]] ---------------------------------------------- == quintagroup.plonecaptchas == quintagroup.plonecaptchas adds captcha support to Plone, it works together with quintagroup.captcha.core. With these products installed captchas will be added to Plone's '''''Send this''''', '''''Contact Us (/contact-info)''''' forms, and Plone's default discussion mechanism: '''''Add Comment''''' and '''''Reply''''' forms. [[Image(add-comment.png, nolink)]] === Join Form === quintagroup.plonecaptchas does not automatically plug to Plone's default registration (/join_form). You can make captcha plug to Plone's Join form via Zope Management Interface: * Go to ''portal_setup/manage_importSteps'' * in ''Select Profile or Snapshot'' drop down menu select '''Plone Captchas Join Form for plone 3-...''' according to the Plone version used on your site, e.g '''Plone Captchas Join Form for plone-3.3''' [[Image(select-profile.png, nolink)]] * Move to the bottom of the page and press '''Import all steps''' * Captcha will now be applied to the registration form. ---------------------------------------------- == quintagroup.pfg.captcha == quintagroup.captcha.pfg (former qPloneCaptchasField product) allows adding captcha field to the forms, created with !PloneFormGen. To create forms with the captcha field you need to install the following Plone products: * [http://plone.org/products/ploneformgen PloneFormGen] - for creating the form itself * [http://plone.org/products/plone-captchas Plone Captchas (quintagroup.plonecaptchas)] - for enabling Plone captchas on a Plone site together with quintagroup.captcha.core - for configuring captcha. * quintagroup.pfg.captcha - for adding captcha field to the PFG form. Make sure the products are installed in this order, otherwise they may fail to work correctly. [[Image(installed-products.png, nolink)]] 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)]] ---------------------------------------------- == quintagroup.formlib.captcha == ---------------------------------------------- == quintagroup.z3cform.captcha ==