Metadata-Version: 1.0
Name: wildcard.readonly
Version: 1.0a1
Summary: Easily setup readonly zeo clients
Home-page: http://svn.plone.org/svn/collective/
Author: UNKNOWN
Author-email: UNKNOWN
License: GPL
Description: Introduction
        ============
        
        This package provides a mechanism to easily have clients set to
        work with readonly.
        
        This is mostly useful for preventing ReadOnlyError from cropping up
        from write on read operations for a public read only site.
        
        
        Warning
        -------
        
        Also make sure to set your zeo client zope.conf `read-only true` setting::
        
            <zodb_db main>
                <zeoclient>
                ...
                read-only true
                ...
                </zeoclient>
            </zodb_db>
        
        
        To make this work along with buildout, use the wildcard.recipe.insertinto
        recipe::
        
            [readonly-insertinto]
            recipe = wildcard.recipe.insertinto
            client1 = ${client1:location}/etc/zope.conf insert-before "</zeoclient>" "\n\tread-only true\n"
        
        
        Lastly, make sure to disable product installation in your client configuration,
        otherwise you'll get errors on startup::
        
            [client1]
            recipe = plone.recipe.zope2instance
            ...
            enable-product-installation off
            ...
        
        
        Usage
        -----
        
        Abort all transactions
        ~~~~~~~~~~~~~~~~~~~~~~
        
        Aborts transaction on IPubBeforeCommit event.
        
        Add this to the zcml-additional option for your client::
        
            [client1]
            recipe = plone.recipe.zope2instance
            ...
            zcml-additional =
                <include package="wildcard.readonly" file="readonly.zcml" />
            ...
        
        
        Doom all transactions
        ~~~~~~~~~~~~~~~~~~~~~
        
        Dooms the transaction on the IPubAfterTraversal event.
        
        Add this to the zcml-additional option for your client::
        
            [client1]
            recipe = plone.recipe.zope2instance
            ...
            zcml-additional =
                <include package="wildcard.readonly" file="readonly-doom.zcml" />
            ...
        
        
        Conditionally abort transactions
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Useful when aborting all transactions prevents emails from getting sent out.
        For instance, if you're using PloneFormGen in your setup, dooming and aborting
        will prevent mail from getting sent.
        
        Add this to the zcml-additional option for your client::
        
            [client1]
            recipe = plone.recipe.zope2instance
            ...
            zcml-additional =
                <include package="wildcard.readonly" file="readonly-conditional.zcml" />
            ...
        
        Changelog
        =========
        
        1.0a1 (2012-06-14)
        ------------------
        
        - Initial release
        
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Programming Language :: Python
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
