Personal tools
You are here: Home Products SmartPortlets Documentation Reference README Usage
Document Actions

2. Usage

Up one level
How to create SmartPortlets and display them on your site

Go to SmartPortlets Configuration (in Add-on Product Configuration section of Site Setup. This is where you create SmartPortlet objects, using the "add smartportlet" link in the content bar.

A SmartPortlet is a simple AT object that holds a reference to a Smart folder, and has a setting for the maximum number of items to display in the portlet. If you leave max items at zero, the portlet will display all of the items that the Smart Folder returns.

Adding a SmartPortlet only makes the Smart Folder available for use as a portlet. To actually create the portlet, note the id of your smartportlet, then go to the ZMI and navigate to the properties of the object where you want the portlet to appear. Once there, add the following to the left_slots or right_slots property:

here/smartportlets_tool/your_smartportlet_id/smartportlet

(If left_slots or right_slots property does not exist, add it as a Lines value.)

Now visit that object in Plone - you should see the SmartPortlet items in the location that you specified. The portlet title is derived from the Smart Folder being referenced. If the number of items returned by the Smart Folder exceeds the max items specified for the SmartPortlet, you'll get a "more..." link in the portlet footer. Clicking the "more..." link or the portlet title will take you to the Smart Folder.

The dates displayed in the portlet are the modification date for non-Events, and the start date for Events.

by Sean Fulmer last modified July 8, 2006 - 16:20

For any issues with the web site functionality, please file a ticket.

Please consult the policy on plone.org content if you want your content published on this site.

Servers and hosting by