collective.sortmyfolder

by Luca Fabbri last modified Nov 14, 2011 03:47 PM

Reveal some not-so-hidden Plone feature for sorting your folders

Project 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).

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.

Sort my folder form

The last option makes it possible for users to specify a custom attribute that's not in the list; if you don't like this, just add a CSS rules which hides the choice_custom_field element. Use of this last option needs some Javascript to be executed.

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.

Dependencies

Testing for collective.sortmyfolder has been done on:

  • Plone 3.3
  • Plone 4.0

Credits

Developed with the support of S. Anna Hospital, Ferrara; S. Anna Hospital supports the PloneGov initiative.

Authors

This product was developed by RedTurtle Technology team.

RedTurtle Technology Site

Self-Certification

[X] Internationalized

[ ] Unit tests

[X] End-user documentation

[ ] Internal documentation (documentation, interfaces, etc.)

[X] Existed and maintained for at least 6 months

[ ] Installs and uninstalls cleanly

[X] Code structure follows best practice

Current Release
collective.sortmyfolder 1.0.2

Released Nov 14, 2011 — tested with Plone 4.1, Plone 4, Plone 3

Migration to Plone 4.1
More about this release…

Download file Get collective.sortmyfolder for all platforms
collective.sortmyfolder-1.0.2.tar.gz
If you are using Plone 3.2 or higher, you probably want to install this product with buildout. See our tutorial on installing add-on products with buildout for more information.

All Releases

Version Released Description Compatibility Licenses Status
1.0.2 Nov 14, 2011 Migration to Plone 4.1 More about this release…
Plone 4.1
Plone 4
Plone 3
GPL final
1.0.1 Apr 20, 2011 Updated dutch translation More about this release…
Plone 4
Plone 3
GPL final
1.0.0 Apr 06, 2011 Final release More about this release…
Plone 4
Plone 3
GPL final
0.2.0 Jan 07, 2011 Translation release More about this release…
Plone 3
GPL final
0.1.0 First releease More about this release…
Plone 3
GPL beta

Comments (0)