Metadata-Version: 1.0
Name: megrok.form
Version: 0.2.4
Summary: Fields, Widgets and Constraints for Grok
Home-page: http://svn.zope.org/megrok.form
Author: Dirceu Pereira Tiegs
Author-email: dirceutiegs@gmail.com
License: ZPL
Description: ===========
        megrok.form
        ===========
        
        megrok.form is a helper package that provides some useful fields, widgets and constraints for Grok.
        
        Fields
        ------
        
        - Email, a TextLine field with a default contraint
        - HTML, a Text field that uses z3c.widget.tiny
        - File, from collective.namedfile
        - Image, from collective.namedfile
        - BlobFile, from collective.namedblobfile
        - BlobImage, from collective.namedblobfile
        
        Widgets
        -------
        
        megrok.form overrides the default widgets for:
        
        - zope.interface.schema.Date (using zc.datetimewidget.widget.DateWidget)
        - zope.interface.schema.Datetime (using zc.datetimewidget.widget.DatetimeWidget)
        
        And add new widgets for Image and File (from collective.namedfile).
        
        Validators / Constraints
        ------------------------
        
        megrok.form add constraints for:
        
        - SSN
        - US Phone Numbers
        - International Phone Numbers
        - Zip Code
        - URL
        - Email
        
        Installation
        ------------
        
        To use megrok.form under Grok all you need is to install megrok.form as an egg
        and include it's zcml. The best place to do this is to make megrok.form
        a dependency of your application by adding it to your install_requires
        list in setup.cfg. If you used grokprojet to create your application setup.cfg
        is located in the project root. It should look something like this::
        
        install_requires=['setuptools',
        'grok',
        'megrok.form',
        # Add extra requirements here
        ],
        
        Then include megrok.form in your configure.zcml. If you used grokproject to
        create your application it's at src/<projectname>/configure.zcml. Add the
        include line after the include line for grok, but before the grokking of the
        current package. It should look something like this::
        
        <include package="grok" />
        <include package="megrok.form" />
        <grok:grok package="." />
        
        Then run bin/buildout again. You should now see buildout saying something like::
        
        Getting distribution for 'megrok.form'.
        Got megrok.form 0.2.2.
        
        That's all.
        
        Using Blob Storage
        ------------------
        
        To use blob storage you need to change zodb definition in your parts/zopectl/zope.conf like this::
        
        <zodb>
        <blobstorage>
        <filestorage>
        path /path_to_your_app/parts/data/Data.fs
        </filestorage>
        blob-dir /path_to_your_app/parts/data/blobs
        </blobstorage>
        </zodb>
        
        The blob-dir specifies where you want to store blobs.
        
        Authors
        -------
        
        - Dirceu Pereira Tiegs (dirceutiegs at gmail dot com)
        
Keywords: grok form widgets fields constraints
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Programming Language :: Python
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP
