Configuring the portlets on a page

By default, the installation process creates sample pages for the different portlets. You can customize those pages to fit your needs or remove them and create new pages. This article describes how to configure the IBM® Connections portlets on a WebSphere® Portal page

Before you begin

Restriction: Do not place multiple instances of the same portlet on a page. For example, putting two blog portlets on a page might result in unexpected behavior and is not supported.

About this task

IBM Connections portlets can be configured on multiple pages with different filtering and display options. Community Pages (see Community Pages) affect portlets that are configured on those pages. By default, IBM Connections portlets that are placed on a community page filter the user's view to display content from that community. A link to a piece of content from a community resolves to a community page if there is an appropriate portlet to display the content on a matching community page. For example, if the Blogs portlet is configured on a "New Employees" community page, the page renders a link in WebSphere Portal to blog entries from that community (see Addressing IBM Connections content). If an appropriate community page is not found, links to the content in WebSphere Portal use a set of default pages to display IBM Connections content.

You can organize the pages any way you like and can even hide them from your Portal site's main navigation so that users cannot directly navigate to them. The following procedure creates one page for each service under a label named "IBM Connections" under the pre-defined "Home" page in WebSphere Portal. You can move the Connections pages or create them elsewhere in your WebSphere Portal site structure. It is only important that the unique names for the pages remain the same.

Procedure

  1. Define a label to contain the default pages.
    1. Define a label to contain the default pages.
    2. Click Administration > Portal User Interface > Manage Pages.
    3. Navigate to the page where you want to add a portlet. For example, navigate to Home.
    4. Click New Label. A label is a container for WebSphere Portal pages that does not itself contain content. Alternatively, create a page if you want to place portlets or content on the page.
    5.  Enter IBM Connections for the title.
    6. Click OK.
  2. Define page unique names that indicate the portal page users are directed to in order to view content from the Connections services. These unique names are used in the Content resolver component that handles the Portal page look up The lookup retrieves the appropriate page when a user selects Connections search results from the WebSphere Portal Search Center, selects items from the Connections summary portlets, or uses the URLs described in the Addressing IBM Connections content section. For each of the rows in the table, do the following:
    1. Define a page for each service to serve as a default page for content of that type.
    2. Click the IBM Connections label you created in the prior step.
    3. Click New Page, enter the title and unique name and create the page by clicking OK. The are suggested names, but you can modify them for your deployment.
      Table 1. Suggested page and portlet titles
      Page Title Unique Name Portlet Title
      Profiles ibm.conn.profiles  Profiles
      Activities ibm.conn.activities Activities  
      Blogs ibm.conn.blogs Blogs
      Bookmarks ibm.conn.bookmarks Bookmarks
      Forums ibm.conn.forums Forums
      Wikis ibm.conn.wikis  Wikis
      Attention: Do not deploy an Activities portlet or a Forums summary portlet on an anonymous page. The portlet page must require users to authenticate.
  3. Add portlets to corresponding pages:
    1. Click the pencil icon (Edit Page Layout) next to a page.
    2. Click Add Portlets.
    3. Type the portlet title in the Search box and click Search.
    4. Select the check box next to the appropriate portlet, then click OK.
    5. Click Done.
  4. Follow these steps to give users access to the page.
    1. Navigate to Administration > Access > Resource Permission > Pages > Content Root. Navigate to the first page that contains an IBM Connections Portlet.
    2. Click the Assign Access button for the entry. For example, to allow non-admin users to access the portlets, set the role "Privileged User" to "All authenticated users." To allow anonymous access, set the role "User" to "Anonymous Portal User."
    3. Click Apply and then Done.
    4. Repeat Steps a-d for each page that contains an IBM Connections Portlet.
    Note: Page access may be inherited. If page access is not inherited in your site structure, click the key icon (Edit access) next to each page and add at least user access for each user or group that will view Connections content in WebSphere Portal.