= 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.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.png, nolink)]]

 * Save changes and here it is - a new shelf portlet. It displays items that are collected by the specifies collection. You can browse portlet elements by pressing numbers at the bottom of a portlet or using left/right arrows.

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

Compare standard Plone collection portlet (on the left) and shelf portlet (on the right):

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

== Development ==

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

== Supported Plone Version ==

Plone 4.0