Metadata-Version: 1.0
Name: sc.contentrules.groupbydate
Version: 1.1
Summary: A Plone content rules action that creates a chronological archive.
Home-page: http://www.simplesconsultoria.com.br/
Author: Simples Consultoria
Author-email: products@simplesconsultoria.com.br
License: GPL
Description: .. contents:: Table of Contents
           :depth: 2
        
        sc.contentrules.groupbydate
        ***************************
        
        Overview
        --------
            sc.contentrules.groupbydate is a very basic content rule action used to 
            organize content under a chronological-based hierarchy on a web site upon
            publication.
        
        Base use case
        -------------
            
            A news portal with a few dozen new content items per day needs to organize 
            its information in a chronological, yet human-readable, hierarchy.
            
            To do so this package is installed in a Plone Site and a new content rule is
            created. This content rule will be triggered by the publication of an News
            Item and will initialize a '''Move an item to a date-based folder 
            structure'''. 
            
            This action has a target (/news) and a structure ('ymd'), so as our News 
            Item, with id hello-world, is published on the site, it will be moved to a 
            a new folder structure under /news. Supposing it's December 19th, 2008, the
            item will end in /news/2009/12/19/hello-world.
        
        Requirements
        ------------
        
            * Plone 3.1 and above (http://plone.org/products/plone)
            
            * Products.CMFPlacefulWorkflow (http://plone.org/products/plone)
            
        Installation
        ------------
            
        To enable this product,on a buildout based installation:
        
            1. Edit your buildout.cfg and add ``sc.contentrules.groupbydate``
               to the list of eggs to install ::
        
                [buildout]
                ...
                eggs = 
                    sc.contentrules.groupbydate
        
            2. For Plone 3.1 and Plone 3.2 tell the plone.recipe.zope2instance recipe 
               to install a ZCML slug::
        
                [instance]
                ...
                zcml = 
                    ...
                    sc.contentrules.groupbydate
            
        
        If another package depends on the sc.contentrules.groupbydate egg or 
        includes its zcml directly you do not need to specify anything in the 
        buildout configuration: buildout will detect this automatically.
        
        After updating the configuration you need to run the ''bin/buildout'',
        which will take care of updating your system.
        
        Sponsoring
        ----------
        
        Development of this product was sponsored by `Simples Consultoria 
        <http://www.simplesconsultoria.com.br/>`_.
        
        
        Credits
        -------
        
            * Erico Andrei (erico at simplesconsultoria dot com dot br)
        
        Changelog
        =========
        
        1.1 (2011-06-23)
        ----------------
        
            * Added z3c.autoinclude entry point to mark this as a Plone plugin [erico_andrei]
            
            * Support for Plone 4.1.x [erico_andrei]
        
        
        1.0 (2010-07-02)
        ----------------
            
            * Allow relative paths as base_folder [erico_andrei]
            
            * Allow inputing of strftime formatting for structure field [erico_andrei]
            
            * Add dependency of placeful workflow as we need it to avoid publishing 
              content in an unpublished structure [erico_andrei]
        
        
        0.5 (2009-07-28)
        ----------------
            * Very earlier i18n support [erico_andrei]
            
            * Initial release
        
Keywords: plone contentrules actions
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
