Metadata-Version: 1.1
Name: rt.lastmodifier
Version: 1.0.2
Summary: Extends features and shown data in Plone document byline section
Home-page: http://plone.org/products/rt.lastmodifier
Author: RedTurtle Technology
Author-email: sviluppoplone@redturtle.it
License: GPL
Description: Enhance the Plone adding an additional information on document view: the **user who performed the last change** and
        the **change note**.
        Optionally expands the **document byline** section showing those informations.
        
        .. contents:: **Table of contents**
        
        Documentation
        =============
        
        Plone already handle lot of infos in the document byline section, like the document author, the modification date
        and the publication date.
        
        In the same way new data added by this add-on will be added to the byline section.
        
        .. image:: http://blog.redturtle.it/pypi-images/rt.lastmodifier/rt.lastmodifier-0.4-01.png
           :alt: Document byline preview in the Plone 4.3 style
        
        When the new byline informations are shown?
        -------------------------------------------
        
        New infos apart, all byline elements can now be controlled with a **granular security configuration**.
        This will change the way to handle document byline because commonly Plone simply use a couple of
        site-wide options: the *allow_anon_views_about* and the *displayPublicationDateInByline*.
        
        The viewlet will now handle many different informations: *author*, *last modifier*, *publication date*,
        *modification date* and *last versioning change note*.
        Each information is visible if the user has a specified permission:
        
        - ``rt.lastmodifier: documentByLine view author``
        - ``rt.lastmodifier: documentByLine view last modifier``
        - ``rt.lastmodifier: documentByLine view modification date``
        - ``rt.lastmodifier: documentByLine view publication date``
        - ``rt.lastmodifier: documentByLine view change note``
        - ``rt.lastmodifier: show long time format``
        
        To show last modifier info, *Creator* and *Modifier* must be not equals (just for not show a duplicate link).
        
        By default Anonymous users can't see anything (this will reproduce the Plone default behavior, where Anonymous
        can't see the byline section by default).
        
        The "show long time format" permission can enable disable the visibility of timing when dates are displayed.
        
        Disabling byline on content types
        ---------------------------------
        
        Sometimes the byline section is displayed on contents where you don't need it.
        
        In that case you can apply (from ZMI) a marker interface named ``ILastModifierInertContent`` to a single
        content, or let your 3rd-party content types to extends it.
        This will disable the byline section.
        
        Also, the byline section is automatically disabled on the Plone site root.
        
        Show change notes
        -----------------
        
        This feature will show the comment to changes you did, that commonly are kept in the history section
        so this only works for content type where `versioning`_ is activated.
        
        The editor must explicitly choose if a change note must be putted in the byline section by selecting
        the "*Show the changes note in document info*" checkbox.
        This will store *that* change note to be shown in the content, that means that additional changes without
        checking the option will not update that information.
        
        .. image:: http://blog.redturtle.it/pypi-images/rt.lastmodifier/rt.lastmodifier-0.4-02.png
           :alt: New change note section
        
        To *delete* the change note shown you must edit a document, provide an empty note while keeping the check
        selected.
        
        **Note**: this feature require JavaScript to work properly *and* has only be tested for Archetypes based
        content types.
        
        Installation
        ============
        
        Add ``rt.lastmodifier`` to your buildout::
        
            [buildout]
            ...
            
            [instance]
            ...
            eggs=
               ...
               rt.lastmodifier
        
        After that, install the "rt.lastmodifier" add-on product.
        
        .. Note::
            Installation will trigger an index creation and population. This can require some times
            on huge sites.
        
        Compatibility
        -------------
        
        All Plone versions from 3.3 to 4.3.
        
        Credits
        =======
        
        Developed with the support of:
        
        * `S. Anna Hospital, Ferrara`__
          
          .. image:: http://www.ospfe.it/ospfe-logo.jpg 
             :alt: S. Anna Hospital logo
          
        * `Camera di Commercio di Ferrara`__
          
          .. image:: http://www.fe.camcom.it/cciaa-logo.png/
             :alt: CCIAA Ferrara - logo
          
        * `Province of Vicenza`__
        
          .. image:: http://www.provincia.vicenza.it/logo_provincia_vicenza.png
             :alt: Province of Vicenza - logo
        
        All of them supports the `PloneGov initiative`__.
        
        __ http://www.ospfe.it/
        __ http://www.fe.camcom.it/
        __ http://www.provincia.vicenza.it/
        __ http://www.plonegov.it/
        
        Authors
        =======
        
        This product was developed by RedTurtle Technology team.
        
        .. image:: http://www.redturtle.it/redturtle_banner.png
           :alt: RedTurtle Technology Site
           :target: http://www.redturtle.it/
        
        .. _`versioning`: https://plone.org/documentation/manual/plone-4-user-manual/managing-content/versioning-plone-v3.3
        
        Changelog
        =========
        
        1.0.2 (2015-12-16)
        ------------------
        
        - Fix document by line folder viewlet to take last modifier
          from last modified content inside the folder
          [fdelia]
        
        
        1.0.1 (2015-10-16)
        ------------------
        
        - Added memoize for caching the values of last_modifier method
          [fdelia]
        
        
        1.0.0 (2015-09-07)
        ------------------
        
        - Added a new permission ``rt.lastmodifier: show long time format``.
          This can enable/disable the full time format on dates.
          [keul]
        - Added the ``ILastModifierInertContent`` marker interface for disable
          byline section on contents
          [keul]
        - Fixed to byline infos: prevented some commas to be misdisplayed
          [keul]
        
        
        
        0.6.0 (2015-07-28)
        ------------------
        
        - Fixed italian translation typo
          [keul]
        - Now save last modifier info in a low level annotation.
          This way we can have this information also when the content type do not
          use any versioning support (that is still the fallback)
          [keul]
        - Do not, never, display any byline on site root.
          It's totally useless
          [keul]
        
        0.5.0 (2015-02-16)
        ------------------
        
        - When visiting folders, show last modifier and modification date taken
          by most recent child document, not from folder itself
          [keul]
        
        0.4.1 (2014-09-30)
        ------------------
        
        - Fixed issue in calling ``@@manage-viewlets``, and generally
          accessing site root [keul]
        - Fixed typo in italian translation [keul]
        
        0.4 (2014-07-17)
        ----------------
        
        - New feature for showing the last change note on versionable contents.
          User must explicitly mark the change has "showable"
          [keul]
        
        0.3.1 (2014-02-25)
        ------------------
        
        - Fixed default roles: do not use ``Authenticated`` but ``Member``
          [keul]
        
        0.3 (2014-02-12)
        ----------------
        
        - Added new permissions to handle the view of single infos in the viewlet:
          author, last modifier, publication date and modified date
          [cekk]
        - fixed bug: last modifier was never shown to anonymous users in Plone 4
          (`#1`__)
          [keul]
        
        __ https://github.com/RedTurtle/rt.lastmodifier/issues/1
        
        0.2 (2013-04-17)
        ----------------
        
        * Renamed the product from "collective.lastmodifier" to "rt.lastmodifier".
          This is unbelievable and embarassing, but I didn't find `collective.lastmodifier`__ when I looked for
          a Plone product with those features... and in the end I choosed the same name!
          However the original product is using a different approach.
        * Added collection criteria (for new and old ones)
        
        __ https://pypi.python.org/pypi/collective.lastmodifier
        
        0.1 (Unreleased)
        ----------------
        
        - Initial release
        
Keywords: plone plonegov modifier byline
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 3.3
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Programming Language :: Python
