Attention

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

For more information, see the version support policy.

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

Advanced Use. Portlets management

by Volodymyr Rudnytskyy last modified Dec 30, 2008 03:05 PM
How to control portlets with generated Plone skin product

If you changed 'left_slots' or 'right_slots' in the general portal properties or/and developed new skin related portlets you would need to redo it in the Plone site where your product will be installed. Portlet management feature of qPloneSkinDump do it automatically on user's Plone site after your Plone skin product installation. Therefore if portlets definition of your skin differs from portlets definition of default Plone you may find it useful to read information on configuring portlet management feature below.

Portlets management

Portlets management

  • 'Customize portal slots in new product' checkbox
    Check this checkbox if you want to turn ON the portlets management feature. Other words checking this checkbox will allow your skin product to affect portlets definition for entire site on users Plone site.

  • Left portal slots customizing
    Plone Skin Dump  read left_slots property from your current site and show them in this field. Portlets list will be applied to the site where your Plone skin product will be installed. You can make corrections on your own. But generally there is no need to change portlets listing here.

  • Right portal slots customizing
    qPloneSkinDump read right_slots property from your current site and show them in this field. Portlets list will be applied to the site where your Plone skin product will be installed. You can make corrections on your own. But generally there is no need to change portlets listing here.

  • Slot's list forming
    Here you should choose the way portlets lists will appear on the site where your Plone skin product will be installed. There are three choices. First choice is used in most cases. If you unsure what option to choose let it be the 1-st choice.

    • Blend with skin
      Your portlets have priority. They will appear the first, after them all previously installed portlets on user's Plone site will be added.

    • Blend with site
      Portlets on user's Plone site have priority. They will appear the first, after them all portlets from your skin will be added.

    • Replace
      Portlets on user's Plone site will be rewritten with portlets defined in 'Left portlets customizing' and 'Right portlets customizing'

  • Main column
    This setting is important for positioning of all Plone's default portlets. You choose here which column has a priority during portlet's list forming. If you unsure which option to choose left it to be 'Both' as it is set by default

    • Left
      It is possibly that you designed your skin to have some portlet (for example 'portlet_news') in left column, but Plone have this portlet in the right column by default. Where the portlet_news will be placed on user's Plone site with your Plone skin product installed?

      • portlet will be placed in the left column

    • Right
      It is possibly that you designed your skin to have some portlet (for example 'portlet_news') in left column, but Plone have this portlet in the right column by default. Where the portlet_news will be placed on user's Plone site with your Plone skin product installed?

      • portlet will be placed in the right column

    • Both
      If you set 'Both' it is important which option for portlet's list forming you have chosen previously.

      There are 2 choices:

      • you set 'Blend with skin' portlet's list forming
        It is possibly that you designed your skin to have some portlet (for example 'portlet_news') in left column, but Plone have this portlet in the right column by default. Where the portlet_news will be placed on user's Plone site with your Plone skin product installed?

        • portlet will be placed in the left column

      • you set 'Blend with site' portlet's list forming
        It is possibly that you designed your skin to have some portlet (for example 'portlet_news') in left column, but Plone have this portlet in the right column by default. Where the portlet_news will be placed on user's Plone site with your Plone skin product installed?

        • portlet will be placed in the right column

 

 


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.