================================================
Brazilian Fields for Plone Form Gen
================================================

.. contents:: Table of Contents
   :depth: 2

Overview
--------
A homage to Brazilian bureaucracy, **sc.pfg.brazilianfields** aims to provide 
Brazil-specific fields for use with `PloneFormGen 
<http://plone.org/products/ploneformgen>`_


Requirements
------------

    * Plone 3.3.x / 4.0.x / 4.1.x (http://plone.org/products/plone)
    
    * Products.PloneFormGen >= 1.5 (http://plone.org/products/ploneformgen)

    * Products.BrFieldsAndWidgets >= 1.2 (https://github.com/collective/Products.BrFieldsAndWidgets)
    
Installation
------------

To enable this product, on a buildout based installation:

    1. Edit your buildout.cfg and add ``sc.pfg.brazilianfields``
       to the list of eggs to install ::

        [buildout]
        ...
        eggs = 
            sc.pfg.brazilianfields

.. note:: Since Plone 3.3 is not is necessary to explictly inform 
          plone.recipe.zope2instance recipe to install the ZCML slug

After updating the configuration you need to run the ''bin/buildout'',
which will take care of updating your system.

Using in a Plone Site
----------------------

Activate it
^^^^^^^^^^^^^^^^^^^^

Go to the 'Site Setup' page in the Plone interface and click on the
'Add/Remove Products' link.

Choose the product **PloneFormGen: Brazilian Fields** (check checkbox at its 
left side) and click the 'Activate' button.


Uninstall
-------------

Go to the 'Site Setup' page in the Plone interface and click on the
'Add/Remove Products' link.

Choose the product **PloneFormGen: Brazilian Fields**, which should be under 
*Activated add-ons*, (check checkbox at its left side) and click the 
'Deactivate' button.

.. note:: You may have to empty your browser cache and save your resource 
          registries in order to see the effects of the product installation.

Sponsoring
----------

Development of this product was sponsored by `Simples Consultoria 
<http://www.simplesconsultoria.com.br/>`_ customers, including (but not limited 
to):

    * `Rede Brasil Atual <http://www.redebrasilatual.com.br/>`_
    
    * `Essencis <http://www.essencis.com.br/>`_
    
    * Escola Sao Paulo


Credits
-------

    * Erico Andrei (erico at simplesconsultoria dot com dot br) - Packaging and
      plumbing.



Changelog
-----------

1.1.1 (2012-08-01)
^^^^^^^^^^^^^^^^^^

    * Resolves issue #1 (Couldn't install sc.pfg.brazilianfields)
      [cleberjsantos]


1.1 (2012-07-24)
^^^^^^^^^^^^^^^^^^

    * Require Products.BrFieldsAndWidgets >= 1.2 [ericof]


1.0 (2011-12-21)
^^^^^^^^^^^^^^^^^^^

    * PEP 8 [ericof]

    * Add uninstall profile [ericof]

    * Add plone.app.testing based tests [ericof]
    
    * Moved from svn.plone.org to github.com/collective [ericof]


0.8.1 (2011-01-17)
^^^^^^^^^^^^^^^^^^^

    * Fix distribution [erico_andrei]

0.8 (2009-11-17)
^^^^^^^^^^^^^^^^^^^

    * Adding MANIFEST.in to make releaser works [erico_andrei]


0.7 (2009-11-14)
^^^^^^^^^^^^^^^^^^^

    * Adds dependencies [erico_andrei]

0.6 (2009-07-09)
^^^^^^^^^^^^^^^^^^^

    * Fixes an infinite recursion when adding a BrPhoneField
      [erico_andrei]
      
    * Adds our types to the allowed content inside a FieldsetFolder
      [erico_andrei]
      
    * Localization
      [erico_andrei]

0.5 (2009-06-02)
^^^^^^^^^^^^^^^^^^^

    * PloneFormGen fields based on BrFieldsAndWidgets
      [erico_andrei]
    
    * Initial release
      [erico_andrei]