Metadata-Version: 1.1
Name: pwrentch.FileReferences
Version: 1.0.2
Summary: Lists file and image items and the items that link to them
Home-page: https://github.com/paulrentschler/pwrentch.FileReferences
Author: Paul Rentschler
Author-email: paul@rentschler.ws
License: GPL
Download-URL: https://github.com/paulrentschler/pwrentch.FileReferences/tarball/1.0.2
Description: pwrentch.FileReferences
        =======================
        
        pwrentch.FileReferences adds a browser view to your Plone site that produces a report showing all of the File and Image items in your site, or sub-folder of your site. Along with each item it also shows any content items in the site that link to that File or Image item.
        
        This report can be useful in assessing the types of files and images your content editors have added to the site. It can also be useful if you're looking to remove or replace a certain file or image and need to know what other content links to it.
        
        Installation
        ============
        
        Dependencies
        ------------
        
        Plone 4.1+
        
        This product has been tested with Plone 4.1.4 and should work with anything newer.
        
        
        Install stable version via Buildout
        -----------------------------------
        
        #. Add ``pwrentch.FileReferences`` to the eggs section of your buildout configuration
        #. Run buildout
        #. Restart Zope
        #. Go to the Site Setup page in the Plone interface and click on the Add Ons link.
           Choose "File References" (check its checkbox) and click the Install button.
        
        
        Using the latest development version
        ------------------------------------
        
        #. Clone the repository from GitHub into the src folder
        #. Add ``pwrentch.FileReferences`` to the eggs section of your buildout configuration
        #. Add ``src/pwrentch.FileReferences`` to the develop section of your buildout configuration
        #. Run buildout
        #. Restart Zope
        #. Go to the Site Setup page in the Plone interface and click on the Add Ons link.
           Choose "File References" (check its checkbox) and click the Install button.
        
        
        Security
        ========
        
        The view is hard coded to require the "Modify Portal Content" permission. Thus users must be logged in and have the Editor role in order to view the report.
        
        
        Usage
        =====
        
        Add ``@@reflist`` to the end of any folder's URL to view the report of all the File and Image items in that folder and its sub-folders.
        
        Click the "customize" link at the top of the page to choose to include/exclude File and/or Image items and to limit the type of documents displayed by their file type. File types are determined by filename extension and/or mime type.
        
        
        Support
        =======
        
        *   Code repository: https://github.com/paulrentschler/pwrentch.FileReferences
        *   Questions and comments: paul _ at _ rentschler _ dot _ ws
        *   Report bugs: https://github.com/paulrentschler/pwrentch.FileReferences/issues
        
        
        License
        =======
        
        Distributed under the GPL.
        
        See LICENSE.txt and LICENSE.GPL for details.
        
        
        Change History
        ==============
        
        1.0.2 (2014-02-05)
        ------------------
        
        - Converted documentation to reStructured text instead of MarkDown
        - Packaging for PyPI works now
        
        
        1.0.1 (2014-02-05)
        ------------------
        
        - Updated installation instructions
        - Packaged for PyPI and Plone.org
        - Removed the "docs" directory as it was unnecessary
        
        
        1.0 (2014-01-17)
        ----------------
        
        - Created product with ZopeSkel
        - Provides a list of File and Image objects in the current folder
        - Shows what content items link to those File and Image objects
        - Report options dialog allows user to select which portal types and document types to include
        
        
        Download
        ========
        
Keywords: Plone FileReferences
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.1
