Attention

This document was written for an old version of Plone, Plone 2.5.x, and was last updated 424 days ago.

To learn how to upgrade to the current version of Plone, read the upgrade manual.

Portlets

by John DeStefano last modified Mar 26, 2011 12:59 PM
Contributors: Stephanie McFarlin
Editing the default appearance of portlets on each side of the main content area
portlets

Portlets are the parts of the page that get displayed in the left (left_slot) and right (right_slot) columns. Each portlet has its own template.

  • Templates: portlet_calendar, portlet_events, portlet_favorites, portlet_login, portlet_navigation, portlet_news, portlet_recent, portlet_related, and portlet_review
    • Located: [site]/portal_skins/plone_portlets
  • CSS: .portlet, .portlet h4, .portlet h5, .portlet h6, .portletBody, .portletDetails, .portletMore, .portletContent, .portletClose, .portlet .even, .portlet .odd, .portlet input, .portlet ul, and .portlet li
    • Located: [site]/portal_skins/plone_styles/plone.css
Note:
The Calendar slot has additional CSS
  • CSS: .dayPopup, .date, .ploneCalendar, .ploneCalendar a, .ploneCalendar a:hover, .ploneCalendar th, .ploneCalendar td, .ploneCalendar .weekdays td, .ploneCalendar .event, .ploneCalendar .todayevent, and .ploneCalendar .todaynoevent
    • Located: [site]/portal_skins/plone_styles/plone.css

Additional Information:

To control which slots are displayed and where:

In Plone v2.x:

  • Navigate to the root of your Plone site
  • Click the Properties tab at the top. You should see:

portlet control

  • Each line in left_slots and right_slots is an entry for a portlet
  • Deleting any line from left_slots or right_slots will remove that portlet
  • Moving any line from left_slots to right_slots or vice versa will change the side of the page on which the portlet appears
  • Reordering the lines will change the order in which the portlets appear
  • Remember to click Save Changes
Note
Here is a how-to on creating a static portlet.
Note
This can also be done in any other folder in your Plone site in order to diplay or hide different portlets in different locations. If either left_slots or right_slots do not appear in the ZMI, you can add them:
  • At the bottom of the Properties page, enter either left_slots or right_slots for Name
  • Select a Type value of strings
  • Enter the name and path above for the appropriate portlet as a Value
  • Click Add


In Plone v3.x:

  • Click Manage Portlets
  • To remove a portlet from either the left or right side, click the red X icon to the right of its name
  • To add a portlet to either side, select its name from the Add portlet drop-down menu
  • To edit the behavior of some (not all) portlets, click its name and edit its settings

Navigation portlet in Plone 3.x:

In Plone v3 sites with default configurations, the left_slots section is hidden on the front page, due to the default Navigation portlet configuration settings on the front-page object.  To enable the display of the Navigation portlet at the site home page:

  • Click Manage Portlets
  • Click the Navigation portlet
  • Under Start Level, change the portlet start level value from 1 to 0
  • Click Save

Contribute

Something wrong or out of date? Anybody can edit or create a new article in the knowledge base. Simply create an account on this site, log in, and click the Edit button to contribute.