source: products/quintagroup.pfg.captcha/trunk/docs/INSTALL.txt @ 3606

Installation
============

Quintagroup PloneFormGen CaptchaField should be installed only after PloneFormGen, 
otherwise it might fail to work correctly.

quintagroup.pfg.captcha on Buildout
-----------------------------------

To install quintagroup.pfg.captcha to your buildout-based project:

* Add ``quintagroup.pfg.captcha`` to the list of eggs to install::

    [buildout]
    ...
    eggs =
        ...
        quintagroup.pfg.captcha
       
* Tell the plone.recipe.zope2instance recipe to install a ZCML slug::

    [instance]
    recipe = plone.recipe.zope2instance
    ...
    zcml =
        quintagroup.pfg.captcha
      
* Re-run buildout, e.g. with::

    $ ./bin/buildout
    
* Restart the Zope server, e.g with the following command in the terminal::

   $ ./bin/instance restart
   
* Install ``quintagroup.pfg.captcha`` with Quickinstaller in Plone (Site Setup -> Add/Remove Products) 
        
        
quintagroup.pfg.captcha on Traditional Zope 2 instance
------------------------------------------------------

To install quintagroup.pfg.captcha into the global Python environment (or a workingenv),
using a traditional Zope 2 instance, you can do this:

* Copy ``quintagroup`` folder to your instance's ``/lib/python`` directory.

* Create a file called ``quintagroup.pfg.captcha-configure.zcml`` in your instance's ``/etc/package-includes`` directory. The file
should only contain this::

    <include package="quintagroup.pfg.captcha" />

* Restart the Zope server, for example with the following command in the terminal::

   $ ./bin/zopectl restart

* Install ``quintagroup.pfg.captcha`` with Quickinstaller in Plone (Site Setup -> Add/Remove Products)