Portlet Inheritance

By default, portlets added to an individual page will display on just that page.  Any portlets however, that are assigned at the folder level will be inherited and will display on all sub-pages and folders.  For any section of your site you could have a combination of portlets that are inherited (parent portlets) and that are assigned there.  For example, if you add a portlet with contact information to the home folder (the root folder) of your site, that portlet will display throughout the rest of the site. If you add a portlet to the About Us section/folder of your web site then, that portlet will display on everything within the About Us folder. You can, however, prevent portlets from being inherited by blocking them.

Portlet Management Screen

The portlet management screen will list all portlets; portlets assigned here, inherited portlets and even inherited portlets that have been blocked.  In the example below you can see that for the given page that I'm on it has a 'Related Links' portlet assigned just to it.  It also has the News, Events and a 'Search This Site' portlet that it is inheriting.  These inherited/parent portlets are not being blocked and so will display on the page as well.  By default, the portlets 'assigned here' will display above inherited portlets.

Portlet Inheritance


Blocking Inherited Portlets 

If you want to block inherited portlets for any section on your site, then you must use the Block/unblock portlets controls to "block" the parent portlets.  Blocking portlets is an all or nothing deal.  You can't block some inherited portlets and keep other inherited portlets.  A work-around to this issue is to block all inherited portlets and then re-add the portlets you wanted to keep.

  • Navigate to the page or folder you wish to change (i.e., the one you want the portlets disabled/hidden), and click the appropriate "Add, edit or remove..." link.
  • Tip - blocking portlets at the folder level will block the portlets on everything contained in that folder.
  • In the Parent portlets drop-down menu, change Do not block to Block.
  • Click Save settings at the bottom of the portlet management screen.
Block Portlets

Unblock Portlets on an Individual Page or Folder

In the School of Medicine web system it is very easy to unblock inherited portlets that have previously been blocked.

  • Navigate to the page or folder you wish to show inherited portlets on, and click the appropriate "Add, edit or remove..." link.
  • In the Parent portlets drop-down menu, change Block to Do not block.
  • Click Save settings at the bottom of the edited column, in the Manage Portlets view.

Assigning Portlets to the Folder vs. the Default View of the Folder

When assigning a portlet to a folder that has a page set as the default view of the folder you need to pay attention to where you actually assign the portlet.  If you click on any of the Manage Portlets or Add, edit or remove a portlet... buttons, you will be taken to a portlet management screen.  The screen will display an info box alerting you as to whether or not you are adding a portlet to the page or the folder.  If you are adding a portlet to the page but want to actually add it to the folder (or vice versa), then simply click the 'go here' link in the Info box to switch.
Portlet Info Box
In addition, you can tell whether you're managing portlets for the page or folder by the address in the address bar. The address will always specifically reflect what's being edited ("site/folder/@@manage-portlets" versus "site/folder/page/@@manage-portlets").

Examples

Add a Portlet That Displays Throughout a Site

Lets say you want to add your address and contact information to the site footer throughout your entire site.  If you assign the portlet while you are on your sites root folder, that portlet will be inherited and displayed throughout the site.  The great benefit of this is when you need to make a change to the contents of the portlet, you change it in one place and it is updated throughout your site.

  1. Go to your sites home page.
  2. Click on the 'Add, edit or remove a portlet in the site footer' link located towards the bottom of the page.  Reference label 8 in the image below to see where the link is located.
    Columns and Portlet Locations
    Click for a larger image
     
  3. If you see the yellow info box that states you are managing the portlet of the default view of the folder, then you need to click the 'go here' link in the info box to add the portlet to the container (folder).
    Portlet Info Box
  4.  Add your address and contact information to the site footer.