= collective.portlet.shelf =

[[PageOutline]]

== Links ==

 * SVN Repository - http://svn.plone.org/svn/collective/collective.portlet.shelf

== Introduction ==

collective.portlet.shelf is a portlet for Plone that allows to display Collection's results in a carousel portlet browsing them by subcollections.

== Usage ==

To create such a portlet you have to:

 * create a Collection (with !SubCollections) that returns results for showing in the portlet

 * add shelf portlet on a page where you want to add a carousel - click '''Manage portlets''' in one of the columns of your site and choose '''Portlet Shelf''' from '''Add portlet...''' menu;

 [[Image(add-portlet-plone3.png, nolink)]]
 
 * Portlet shelf is based on the standard Plone collection portlet, so the same fields are available for this type of portlet as for the standard Collection portlet. Fill in the fields in the portlet edit form, specifying a collection that will provide content for the portlet.

 [[Image(edit-portlet-plone3.png, nolink)]]

 * Save changes and here it is - a new shelf portlet. It displays items that are collected by the specified collection and its subcollections. You can browse collection  elements by using left/right arrows. To browse items of certain subcollection only - select its name from the listing at the bottom of a portlet (Sub 1, Sub 2, ..). To see all elements together - choose ''All'' at the bottom of porltet.

 [[Image(portlet-plone3.png, nolink)]]


== Development ==

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

== Supported Plone Version ==

Plone 3.x

== collective.portlet.shelf in Plone 4 ==

collective.portlet.shelf works in Plone 4, but it has a bit different functionality. Since there are no !SubCollections in Plone 4 any longer, collective.portlet.shelf will display elements of a selected collection only. 

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