Metadata-Version: 1.1
Name: collective.sortmyfolder
Version: 1.0.6
Summary: Reveal some not-so-hidden Plone feature for sorting your folders
Home-page: http://plone.org/products/collective.sortmyfolder
Author: RedTurtle Technology
Author-email: sviluppoplone@redturtle.net
License: GPL
Description: Introduction
        ============
        
        The piece of software that make it possible to sort items in Plone contains hidden additional features.
        
        Normally, when you call a sort action in Plone, you call a URL like this::
        
            http://myhost/myfolder/folder_position?position=up&id=content_id
        
        ... of course, KSS/jQuery stuff in recent Plone versions will hide this feature, but is still available when you disable
        Javascript.
        
        The Plone UI has no way at the moment for performing actions like this::
        
            http://myhost/myfolder/folder_position?position=ordered&id=fieldname
        
        But this feature is inside Plone: in this way you will sort a folder automatically, using a field value for comparison
        (like ``title``, or ``created``).
        
        The ``folder_position`` script uses the ``orderObjects`` API. This last method has some additional nice features that
        unluckily are not exposed to users. But we can fix this.
        
        
        What this product does
        ======================
        
        This product adds to Plone some of the features that follow, patching Plone a little (see also `#11317`__).
        
        __ http://dev.plone.org/plone/ticket/11317
        
        
        Can now sort a folder in reverse order
        --------------------------------------
        
        You can call an URL like this::
        
            http://myhost/myfolder/folder_position?position=ordered&id=created&reverse=1
        
        and this will sort the folder using reverse criteria.
        
        
        Add "delta" criteria to the sorting mechanism
        ---------------------------------------------
        
        You can call::
        
            http://myhost/myfolder/folder_position?position=up&id=content_id&delta=4
        
        and this will move the content down by 4 slots instead of the default 1 (this feature is not so useful if you use Plone KSS/jQuery/Javascript
        sorting).
        
        
        Add a nice Plone interface for global folder sorting
        ----------------------------------------------------
        
        Your "*Action*" menu will be populated with a new entry: "*Sort folder*". This will present the user a Plone form where
        he can perform common sorting operations.
        
        .. image:: http://keul.it/images/plone/collective.sortmyfolder-1.0.0.png
           :alt: Sort my folder form
        
        The last option makes it possible for users to specify a custom
        attribute that's not in the list.  It is hidden by default and is
        shown by Javascript as it needs some Javascript to work anyway.  If
        you don't like this option, just add a CSS rules which hides the
        ``choice_custom_field`` element.
        
        
        What this product isn't
        =======================
        
        This product only reveals features that are already in Plone (inside the *orderObjects* method).
        It will not add new sorting behaviour.
        
        
        Alternative products
        ====================
        
        On pypi there is a newer product that upgrades base folder_contents view with more features (like different sorting methods, multiple upload or shift-click selection): `pypi.python.org/pypi/wildcard.foldercontents <http://pypi.python.org/pypi/wildcard.foldercontents>`_
        
        
        Dependencies
        ============
        
        Testing for collective.sortmyfolder has been done on:
        
        * Plone 3.3
        * Plone 4.2
        * Plone 4.3
        
        Note that on Plone 4, reverse sorting on the position does not work.
        Work is under way to fix this.  It needs changes in both
        ``collective.sortmyfolder`` and the core ``plone.folder`` package.
        
        
        Credits
        =======
        
        Developed with the support of `S. Anna Hospital, Ferrara`__
        
        .. image:: http://www.ospfe.it/ospfe-logo.jpg 
           :alt: S. Anna Hospital - logo
             
        S. Anna Hospital supports the
        `PloneGov initiative`__.
        
        __ http://www.ospfe.it/
        __ http://www.plonegov.it/
        
        Authors
        =======
        
        This product was developed by RedTurtle Technology team.
        
        .. image:: http://www.redturtle.net/redturtle_banner.png
           :alt: RedTurtle Technology Site
           :target: http://www.redturtle.net/
        
        Changelog
        =========
        
        1.0.6 (2013-09-05)
        ------------------
        
        - Add option to sort by id.
          [maurits]
        
        - Hide the custom field by default.  Show it with Javascript.
          [maurits]
        
        - Fix javascript for newer jquery versions in newer Plones, not using
          the ``jq`` alias.
          [maurits]
        
        
        1.0.5 (2012-11-13)
        ------------------
        
        - Fixed manifest for rst files [micecchi]
        
        
        1.0.4 (2012-11-13)
        ------------------
        
        - Fixed uninstall step for skin layer [micecchi]
        
        
        1.0.3 (2012-10-14)
        ------------------
        
        - Moved to https://github.com/collective/collective.sortmyfolder
          [maurits]
        
        
        1.0.2 (2011-11-14)
        ------------------
        
        * Set the icon_expr in actions.xml so we register the action icon in
          the preferred way in Plone 4.  We keep actionicons.xml for backwards
          compatibility with Plone 3.
          [maurits]
        
        * No longer use the plone domain for our action as portal_actions
          accepts other domains too.  This means we no longer need the i18n
          directory.  Added an upgrade step to switch our action to use
          collective.sortmyfolder as domain.
          [maurits]
        
        * Added MANIFEST.in so .mo files can be included in the release
          (automatically when using zest.releaser+zest.pocompile).
          [maurits]
        
        * Made compatible with Plone 4.1.
          [maurits]
        
        
        1.0.1 (2011-04-20)
        ------------------
        
        * Updated Dutch translations [fvandijk]
        * Corrected english spelling in README.txt [fvandijk]
        
        1.0.0 (2011-04-06)
        ------------------
        
        * added new dates sorting criteria [keul]
        * added the field for a custom way to sort [keul] 
        * do not show the menu entry if you can't sort the current object [keul]
        * added some javascript for the new custom field.
          Not enabled js browser will no be able to use the new feature [keul]
        * tested also on Plone 4
        
        0.2.0 (2011-01-07)
        ------------------
        
        * fixed typo syntax error in english text [markvl]
        * added dutch translation [markvl]
        
        0.1.0 (2010-12-02)
        ------------------
        
        * initial release
Keywords: plone folder sort
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
Classifier: Programming Language :: Python :: 2.4
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Development Status :: 5 - Production/Stable
