Metadata-Version: 1.0
Name: plone.browserlayer
Version: 2.0.1
Summary: Browser layer management for Zope 2 applications
Home-page: http://pypi.python.org/pypi/plone.browserlayer
Author: Plone Foundation
Author-email: plone-developers@lists.sourceforge.net
License: GPL version 2
Description: Introduction
        ============
        
        This package aims to make it easier to register visual components (e.g. views
        and viewlets) so that they only show up in a Plone site where they have been
        explicitly installed.
        
        Basic usage
        -----------
        
        To use this feature, you should:
        
        - declare plone.browserlayer as a dependency, e.g. in setup.py::
        
        install_requires=[
        'plone.browserlayer',
        ],
        
        - ensure that its ZCML is loaded, e.g. with an include from your own package::
        
        <include package="plone.browserlayer" />
        
        - create a layer marker interface unique to your product::
        
        from zope.interface import Interface
        class IMyProductLayer(Interface):
        """A layer specific to my product
        """
        
        - register this with GenericSetup, in a browserlayer.xml file::
        
        <layers>
        <layer name="my.product"
        interface="my.product.interfaces.IMyProductLayer" />
        </layers>
        
        - register visual components in ZCML for this layer, e.g.::
        
        <browser:page
        name="my-view"
        for="*"
        layer=".interfaces.IMyProductLayer"
        permission="zope.Public"
        template="my-view.pt"
        />
        
        Changelog
        =========
        
        2.0.1 - 2010-09-21
        ------------------
        
        - Make sure the layers don't get applied twice if the site is traversed more
        than once (such as in a vhosting URL).
        [davisagli]
        
        2.0 - 2010-07-18
        ----------------
        
        - Update license to GPL version 2 only.
        [hannosch]
        
        - Package metadata cleanup, require Zope2 distribution.
        [hannosch]
        
        1.0.1 - 2009-09-09
        ------------------
        
        - Be more robust against broken layer registrations. These can occur when
        packages with registered layers are removed.
        [wichert]
        
        - Clarified license and copyright.
        [hannosch]
        
        - Register ourselves for the more generic ISiteRoot from CMFCore and not
        IPloneSiteRoot.
        [hannosch]
        
        - Declare test dependencies in an extra.
        [hannosch]
        
        - Specify package dependencies.
        [hannosch]
        
        1.0.0 - 2008-04-20
        ------------------
        
        - Unchanged from 1.0rc4
        
        1.0rc4
        ------
        
        - Register the GenericSetup import and export steps using zcml. This means
        you will no longer need to install this package manually.
        [wichert]
        
        1.0rc3
        ------
        
        * Include README.txt and HISTORY.txt in the package's long description.
        [wichert]
        
        * Add metadata.xml to the GenericSetup profile. This fixes a deprecation
        warning for Plone 3.1 and later.
        [wichert]
        
        1.0b1
        -----
        
        * Initial package structure.
        [zopeskel]
        
        
Keywords: plone browser layer
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Zope2
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
