= collective.stickyitem =

== Links ==

 * [http://pypi.python.org/pypi Release on PyPi ]
 * [http://github.com/collective/collective.stickyitem Repository] 
 * Build status - https://travis-ci.org/collective/collective.stickyitem [[Image(https://travis-ci.org/collective/collective.stickyitem.png?branch=master)]]

This !NewsItem schema extender adds possibility to pin items on top of the listings. There is "Sorting Date" field added to newsitem content type which is indexed as "effective" value when set.

=== Development ===

This product was developed by http://quintagroup.com for Plone collective, sponsored by Headnet company http://headnet.dk/.

=== Usage ===

After product installation all newsitems get a new field - '''Sorting date'''. This field allows to sort newsitems in a listing according to the date/time specified in this field. 

 * If sorting date is NOT set - newsitems are sorted by their effective date as in default Plone.
 * If sorting date IS set - newsitems are sorted by this date.

This field can be used in cases when you don't want to change object's effective date, but need to make is appear on top of the listing.

[[Image(sorting-date.png, nolink)]]	

=== Example ===

We have 4 newsitems in the News folder, they are now sorted by the date they were published:

[[Image(news.png, nolink)]]	

If now we want '''!NewsItem 2''' to appear at the top of the listing - we edit this newsitem and set the most recent date (e.g. the time/date we have now) as its '''Sorting Date''':

[[Image(newsitem2.png, nolink)]]

As a result '''!NewItem 2''' will be displayed on top of News listing, while its location in the News portlet remained unchanged (news portlets item sorting remained unchanged - according to the effective date).

[[Image(news-sort.png, nolink)]]