Developing Custom Navigation Panel Items

This topic discusses developing custom items for the My Preferences navigation panel.

You can create custom preference options to add to the General Settings preference item category using the pages in the Personalization component. You can also add custom items to the navigation panel on the My Preferences page by creating Fluid components and defining content references in the My Preferences folder in the portal registry.

As with custom navigation panel items, the General Settings navigation panel item is registered in the portal registry. As a result, you can control the order in which navigation panel items appear in the navigation panel by folder and content reference sequence number.

This section provides an overview of developing custom items for the My Preferences navigation panel, defining content references for those items, and specifying content reference attributes.

Development Overview

This section lists the general steps for creating custom navigation panel items on the My Preferences page.

  1. Create a PeopleSoft Fluid User Interface component.

    • Use the PSL_USER_PREF layout page. Do not delete any items on the layout page, with the exception of restore defaults.

    • Load the PTGP_USER_PERS_FL stylesheet in either the page Activate event or in a component post build event.

    As a general guideline the component should be:

    • Self-contained with a Save button.

    • Possess functionality that enables users to restore default preference values, for example through a Restore Defaults control.

    The component should not feature:

    • A left panel.

    • An application header.

    • Custom items in the Actions menu in the banner.

  2. Add the navigation panel item to the portal registry, including:

    • Add and define a content reference.

    • Define optional content reference attributes.

    Additional information for adding and defining content references and content reference attributes is provided in the next sections.

Content References for Custom Navigation Panel Items

To define a content reference for custom navigation panel items, you must add and define a content reference in the Fluid Structure and Content > My Preferences folder. To navigate to the folder:

  1. Select PeopleTools > Portal > Structure and Content.

    The Structure and Content page appears.

  2. In the Folders grid, click the Fluid Structure Content link.

    The Structure and Content page for Fluid Structure Content appears.

  3. In the Folders grid, click the My Preferences link.

    The Structure and Content page for My Preferences appears.

  4. Below the Content References grid, click the Add Content Reference link.

    The Content Ref Administration page for My Preferences appears.

  5. Define the content reference.

    See the following section for information about optional content reference attributes to define in the content reference definition.

Content Reference Attributes for Custom Navigation Panel Items

Depending on your business requirements there are several attributes to consider setting when defining content references for custom navigation panel items.

Term

Definition

CLUSTER_AWARE

When a custom navigation panel item is defined on multiple systems in a clustered environment, use the CLUSTER_AWARE attribute so that only the navigation panel item defined on the local system appears on the end-user My Preferences page.

If you define this attribute, set the attribute value equal to true.

PTPP_IMAGE

Use this attribute to add an image to the navigation panel item label.

Images are typically added only to root-level folder items.

If you define this attribute, specify the image object name in the attribute value field.

CONTEXT_KEYS

Use this attribute to associate the navigation panel item with a comma-separated list of components.

Add the comma-separated list of components to the attribute value field.