+

Search Tips   |   Advanced Search


Enable the Organize Favorites feature in custom themes


Overview

The My Favorites feature in WebSphere Portal lets you bookmark a page in the portal so that you can return to it at a later time.

The page is then added to your My Favorites list, which is maintained by the Organize Favorites portlet. Organize Favorites lets you create, edit, activate, order, and delete labels and web addresses in the My Favorites list. Nodes are located in a level of the navigation hierarchy relative to the parent node in which they are created. The topmost node in the tree is the Content Root. Organize Favorites is a node under the Content Root node.

By default, users without administrative privileges can only access nodes under the Home node, which is also under the Content Root node. Users with administrative privileges can use links in the toolbar to toggle between Administration and Home. If other nodes are created directly under the Content Root, links to these nodes are not referred to unless they are specifically added to one of the theme JSPs.

In a default installation of WebSphere Portal v6.1.5, you cannot directly access Organize Favorites functionality. However, you can access this functionality in a newly created theme.


Enable Organize Favorites

  1. Use the <portal-navigation:navigation> tag with the scopeUniqueName attribute as wps.p.Favorites to create the links to the Favorites in the theme. This replaces the <portal:favoritesLoop/> tag for enabling Organize Favorites functionality.

  2. Create a URL to Organize Favorites in the theme using the <portal-navigation:urlGeneration> tag to wps.OrganizeFavorites.

  3. Create a My Favorite label to store the favorites...

    1. Click...

        Administration | Portal User Interface | Manage Pages | Content Root label | New Label | My Favorites | Page Properties

      Add a page parameter key of Favorites with a value of Yes.

    2. Click...

        Set Page Permission for the new label

      Edit the privileged user role, and add the All Authenticated Portal Users user group. Then click OK.

    3. Click Portal Settings and then Custom Unique Names.

    4. Assign wps.My Favorites as a unique name to the My Favorites label you just created and then click OK.

    5. To create a link in your theme that lets users access the Organize Favorites portlet:

      1. Open the Default.jsp file for each theme that the portal uses. The file should be located in profile_root/installedApps/<cellname>/wps.ear/wps.war/themes/html/<themeName>

      2. Add the following where you want the link to appear:

      <portal-navigation:urlGeneration actionName="myAction" 
        contentNode="wps.Organize Favorites">
        <a href="<%wpsURL.write(out);%>">Link to Organize Favorites</a>
      </portal-navigation:urlGeneration>
      

      For example, in the default portal theme, if you add this code after the line shown below, the link will appear to the left, immediately below the banner:

      <table id="wptheme-pageWrapper" class="wptheme-pageWrapper" 
        cellpadding="0" cellspacing="0" width="100%"><tr><td><div class="wptheme-access">
        <a href="#wpsMainContent"><portal-fmt:text key="link.skiptocontent" bundle="nls.engine"/></a></div>
      <div class="wptheme-themeHeader"><%@ include file="./banner.jspf" %>
      

    6. Restart the portal server to load the updated Default.jsp file.

  4. Add <portal-logic:if/> tags with the pageBookmarkable attribute set to true to pages that you want to be able to bookmark.


Parent topic:

Creating a new theme


Related information


<portal-navigation/> tags