Personal tools
You are here: Home Documentation Tutorials What controls what you see Portlets
Support

Get Help

Join our chat rooms or support forums if you have more specific questions.

Plone Training
Learn how to design, build, and deploy a website in Plone through one of the numerous Plone training sessions around the world.
Find Plone training…
 
Document Actions

Portlets

Editing the default appearance of portlets on each side of the main content area

John DeStefano

This tutorial breaks down the main display elements in a Plone site, and shows you how to control and customize the appearance of each element.
Page 10 of 17.
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
 
by John DeStefano last modified March 20, 2008 - 13:43
Contributors: Jet Wilda
All content is copyright Plone Foundation and the individual contributors.

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