Metadata-Version: 1.0
Name: uwosh.pfg.d2c
Version: 2.0a1
Summary: A PloneFormGen adapter that will save the data from a form to an actual content type. This way you can still use permissions, workflows, etc on the form data.
Home-page: http://pypi.python.org/pypi/uwosh.pfg.d2c
Author: Nathan Van Gheem
Author-email: vangheem@gmail.com
License: GPL
Description: Introduction
        ============
        
        uwosh.pfg.(d)ata(2)(c)ontent
        
        This product provides a dynamic content type to store PloneFormGen form
        data into. It leverages schemaextenders ability to dynamically add extra
        fields on a content type so that you essentially get a persistent copy of
        your form.
        
        The product adds a "Save Data to Content Adapter" item to the "Add
        new.." drop down for the PloneFormGen Form. Once enabled, when a user
        submits a form, a new content item is created with that data and
        located in the adapter.
        
        Saving Content
        --------------
        Upon save data adapter creation, user can choose to use any content type
        that has 'uwosh.pfg.d2c' configured as the 'product' in the FTI, to store
        the form submission. 
        
        So besides the original FormSaveData2ContentEntry, its clone types can
        also be used to store form data - whether added to types tool via code,
        genericsetup profile or by manually copying the FormSaveData2ContentEntry
        FTI in portal_types tool (and then renaming it appropriately).
        
        The type names can be translated simply by adding them to
        plone.po in the language-specific locale/LC_MESSAGES subdirectory.
        
        Upgrading to 2.0
        ----------------
        
        You must run the upgrade step in the add/remove product control panel
        in order for you to successfully upgrade to 2.0 otherwise, your
        data adapter will not display it's contents properly.
        
        
        Warning
        -------
        
        Don't forget to enable the adapter after it is added to the form!
        
        
        Placeful Workflows
        ------------------
        
        It is often very useful to assign a placeful workflow onto a 
        save data content type. Normally, this is rather cumbersome to
        do; however, d2c now provides a nice widget to make this sort
        of action automatic(automatically create missing workflow policy).
        
        
        Compatibility
        -------------
        
        Compatible with versions of PloneFormGen >= 1.2.2 and Plone 3.x ->
        4.x.
        
        Version 1.0 derives the new D2C saved data adapter from the BTree
        folder class.  This allows Plone 3.x sites to handle larger numbers of
        content items inside the D2C objects.  There is an upgrade step that
        allows pre-1.0 D2C objects to get migrated to BTree storage.  Version
        1.0 also works with Plone 4.  However, if you have a Plone 3.x site
        that uses pre-1.0 D2C and you upgrade to Plone 4 and only then upgrade
        to 1.0+ D2C, the upgrade step that migrates D2C storage to BTree
        storage may not work.  We recommend that you first upgrade to 1.0+ D2C
        *then* upgrade to Plone 4.
        
        Windows
        ~~~~~~~
        
        In order for this to work, you'll need to disable the schemaextender cache::
        
          archetypes.schemaextender\archetypes\schemaextender\extender.py line 113
          disable CACHE_ENABLED
          
        
        
        Changelog
        =========
        
        2.0a1 ~ 2012-02-03
        ------------------
        
           - Fixed issue with vocabulary field
             [vangheem]
        
           - Providing ordering support for data adapter
             folder and enable next/previous navigation.
             [vangheem]
        
        1.3.2 ~ 2012-01-31
        ------------------
        
           - add alias to form findFieldObjectByName method on
             data entry type. This fixes selection widgets on
             content objects that were moved out of the adapter
             directory. 
        
        1.3.1 ~ 2012-01-10
        ------------------
        
           - safely check portal type when finding related form
             [vangheem]
        
        
        1.3.0 ~ 2012-01-10
        ------------------
        
           - Add ability to easily assign a placeful workflow
             onto a data adapter
             [vangheem]
        
           - Correctly use the hidden 'last_referer' form field
             to figure out where the user came to the form from.
             IFormSaveData2ContentEntryFinalizedEvent subscribers
             can access the referrer content object simply as
             event.referrer.
             [saffe]
        
           - set value of adapter on entry object so you can
             move the object around
             [vangheem]
        
           - fire the object initialized event when data entry
             object is created
             [vangheem]
        
        
        1.2.8 ~ 2011-10-28
        ------------------
        
           - Mention the BTree portal_setup upgrade step, in new
             docs/UPGRADES.txt file
             [tkimnguyen]
        
           - Add ability to easily add new types via edit form.
             [vangheem]
             
        
        1.2.7 ~ 2011-07-20
        ------------------
        
           - fixed max value validator.
             [vangheem]
             
        
        1.2.6 ~ 2011-06-30
        ------------------
        
           - Fix use of urlparse for python 2.4
        
        1.2.5 - 2011-06-01
        ------------------
        
           - Fix issue where in some cases object could not acquire to
             parent form.
             [vangheem]
        
        
        1.2.4 - 2011-04-29
        ------------------
        
           - fix file fields to work with ones that aren't
             required. [vangheem]
        
           - incorrect default value fo entry type. [vangheem]
        
        1.2.3 - 2011-04-28
        ------------------
        
           - File fields are now working. [vangheem]
        
        1.2.2 - 2011-03-03
        ------------------
        
           - Improved functionality for product developers: If user
             arrives to the pfg form via a plone content object,
             the referring content object is available
             as 'referrer' attribute of the event dispatched
             upon data entry content creation. [saffe]
        
           - Bugfix: anonymous TALES title override did not always
             work due to insufficient permissions. User is now
             elevated to "Owner" in the current context, allowing for more 
             useful TALES expressions. [saffe]
        
        
        1.2.1 - 2011-02-24
        ------------------
        
           - New functionality for product developers: uwosh.pfg.d2c now fires
             a custom event upon a data content entry creation. Subscribe to:
             uwosh.pfg.d2c.interfaces.IFormSaveData2ContentEntryFinalizedEvent
             [saffe]
        
           - Improved documentation & Sphinx docs [saffe]
        
        
        1.2 - 2011-02-20
        ----------------
        
           - New feature: dynamic data entry title override via a TALES
             expression configurable in the save data adapter. [saffe] [vangheem]
        
        
        1.1.1 - 2011-02-11
        ------------------
        
           - fix translations
             [saffe]
        
        
        1.1 - 2011-02-10
        ----------------
        
           - New feature: Any FTI clone of FormSaveData2ContentEntry type can be
             selected in the save adapter as the data content entry type to use.
             This makes it possible to apply different workflows, content rules
             etc. to content saved by different forms. [saffe]
        
        
        1.0 - 2011-01-06
        ----------------
        
          - New saved data adapter derives from large (BTree) folder instead
            of regular ones to handle better large numbers of contained items.
            Upgrade step migrates from obsolete normal/slow folder storage to
            the new BTree storage.
            [nguyen]
        
          - fixed issue where it couldn't render the title viewlet if a
            lines field was used for the title field. Convert all value
            fields to string for the title.
            [vangheem]
            
        
        0.8 (2010-10-30)
        ----------------
        
          - add support for pfg datagridfield
            [vangheem]
          
        
        0.7 (2010-08-04)
        ----------------
        
         - added accessor method getValue for entry type.
         
         - index object properly after values are set
         
         - allow you to specify which field to use for the title
         
        
        0.6 (2010-07-31)
        ----------------
        
         - added autoinclude entry point
        
         - only use _finishConstruction method if it's available since in newer 
           versions of CMFCore, it's not there.
           
        
        0.5
        ---
        
         - use id for Title
         
         - allow avoiding security checks when creating content.
         
         - conditionally include certain fields for backwards compatibility
        
         - make backward compatible to at least PloneFormGen 1.2.2 -- maybe older.
         
         - added tests
         
         - added permissions for adding content
         
         - More fixes for the rating scale field. Should work as expected now.
         
        
        0.4
        ---
        
         - fixed widgets not working correctly.
        
         - memoize the call to get the fields just in case it gets slow
         
        
        0.3 (2010-07-27)
        ----------------
        
         - fix the way I checked for FileFields so that anything that subclasses a
           FileField won't try to get it's form value differently anymore.
        
        0.2 (2010-07-27)
        ----------------
        
         - fix egg distro not including docs folder so the product wouldn't install
         
         - fixed file fields not saving
        
        0.1 (2010-07-27)
        ----------------
        
         - initial release
        
        
        Contributors
        ************
        
        
        Nathan Van Gheem, Author
        T. Kim Nguyen, Lurker
        Petri Savolainen, Contributor
        
        
Keywords: ploneformgen plone forms adapter uwosh
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
