Modify portlet settings

Overview

Enable a portlet to render in parallel with other portlets on a page; select the caching method for a portlet; add, edit, or delete a preference or parameter/value pair; or set locale-specific titles and descriptions for a portlet.

For standard portlets the term preference is used; for IBM portlets the term parameter is used. The following instructions refer to preferences. If you work with an IBM portlet, replace preference by parameter.

Modify portlet settings

1. Click the Configure portlet icon on the appropriate row.

2. To add a preference:

   1. Enter the new preference in the New preference field.

   2. V for the new preference in the New value field.

   3. Click the Add button.
      The new preference is shown in the list.

3. To edit a preference:

   1. Select Edit preference from the appropriate row.
      The portal displays the panel for modifying the preference. The preference fields contain the current values. The preference field is blocked; you can only change the value field.

   2. Enter the new value for the preference in the value field.

   3. Select OK to save changes, or select Cancel to quit without saving the changes.
      The portal returns to the panel for configuring the portlet.

4. To delete a preference:

   1. Select Delete from the appropriate row.

   2. Select OK at the prompt to continue the delete, or select Cancel to return without deleting the preference.

5. To set locale-specific titles and descriptions:

   1. Select the I want to set titles and descriptions link.

   2. Select the Edit pencil icon in the appropriate row for the locale.

   3. Enter a new title in the New title field.

   4. Enter a description in the New description field.

   5. Click OK to save updates or Cancel to quit without saving.
      The portal returns to the panel for configuring the portlet.

6. Select Enable parallel rendering to have portlets rendered in parallel. This means that all portlets on a page are rendered simultaneously rather than sequentially. This can be of benefit if you have many portlets that take a long time to render. Enable this option takes effect only if parallel portlet rendering is enabled globally for the respective portlet type (JSR or IBM API) and the corresponding markup.

7. Select the caching options.
   The caching options make use of the remote caching feature of the portal. A page and all portlets on the page can contribute their maximum cache timeout so that the browser or proxy caches can cache the complete markup.

   These options are only available for standard API portlets.

   As other page elements can also contribute their cache settings, effective settings for a completely rendered page might differ from the ones defined here.

   You can select from two sets of options:

   • The portlet cache scope for HTTP and fragment caches:
     Non-shared cache for a single user
     Set portlet output to be cached only in the browser cache, that is the a cache that only a single user can access. Use this option if the portlet output contains information that is only relevant or available to a single user. Default.setting.

     Share cache across all users (not applicable if "cache always expires" option is selected below)

     The portlet markup is cached in a shared cache, typically a proxy server. Portlet markup is not private to a particular user, but other users might see the same portlet output as well.

   • The portlet cache expiration for HTTP and fragment caches:
     Portlet cache always expires
     If you select this option, caching of the portlet output is switched off. No caching takes place, neither in a browser nor a proxy cache. Use this selection for volatile or security sensitive information.

     Portlet cache never expires

     If you select this option, the cached output is never removed from a cache.

     Portlet cache expires after this many seconds

     How long the markup of this portlet should be valid. Values are typically in the range of a few seconds up to a few days or weeks, depending on how often you expect updates to the content that the portlet displays.

8. Click OK to save updates or Cancel to quit without saving.
   The portal returns to the list of portlets.

When you click the Configure portlet icon for a portlet, there is a showbypermission preference that has the following two settings:

• Yes: Displays only top level pages that a user has Editor roles on

• No: Displays all top level pages that a user has User roles on

 

+

Search Tips   |   Advanced Search