nerc-ceh/products.contentwellportlets

A Plone product that enables you to add portlets to the central column in a page

Overview

• This product enables you to put portlets in places other than right and left columns, specifically:

  • Underneath global nav but above portal-columns so it spans the width of the page
  • above the main heading (h1) of the page
  • at the base of the page, above the footer
  • in the footer well

  In each area, you can add up to three columns of portlets.

• You should use CSS (in the custom folder in portal_skins, or in your own theme product) to configure how these portlets should appear relative to each other and to the content.

• This may allow you to create distinctive layouts for pages, folders etc without having to write new zope page templates

To install the product

• See docs/INSTALL.TXT for instructions

To add portlets above the content

1. Log into your Plone site as a Manager (or someone else with the "Portlets: Manage portlets" permission)
2. Go to the place in your site where you want portlets. For example: * If you want portlets on your home page only, go to http://yourSiteURL/front-page * If you want portlets on your entire site, go to http://yourSiteURL
3. Bring up a management page by either (a) Clicking the "add, edit or remove portlets link" [*]; or (b) Adding "/@@manage-portletsabovecontent" to the end of the URL and hitting "return"
4. You should see a management page entitled "Manage Portlets Above Content" This gives you the option to add portlets in one or more of three columns: A, B and C You can add as many portlets in each column as you like Other commands (reordering, hiding, blocking portlets) are the same as for the right and left columns

[*]

Note: if you are in a folder that has a default page, this will take you to a screen where you can add portlets to that page. If you want to add portlets to all the pages in the folder, make sure you are on the folder rather than the default page (e.g. by clicking the "contents" tab) before clicking the link.

To add portlets below the content

Follow the above instructions, but instead of clicking the "add, edit or remove portlets above content" link or adding /@@manage-portletsabovecontent to the URL:

1. Click the "add, edit or remove portlets below the content" link; or
2. Add /@@manage-portletsbelowcontent to the end of the URL

Technical details

• The product adds two new viewlets; within each of these are three portlet managers (specified in portlets.xml) For details of exactly which viewlet managers these viewlets slot into:
  • see configure.zcml in Products/ContentWellPortlets/browser
  • or install the product, go to your Plone site and add /@@manage-viewlets to the URL