Change the page help

Customize the help page to reflect the content and information for your organization's site.

WebSphere Portal provides help information for the site when users click the help link that is provided in the toolbar. You should customize this help page to reflect the content and information for your organization's site. Help topics should address the needs of the users and not provide access to information about administering. The help page that is provided by WebSphere Portal provides definitions for common terms, such as portlet and skin.

You should either keep these definitions for your users or provide your own.

Location of the help

The help link must be located in a theme JSP so that it can always be accessible from any page. After installation, WebSphere Portal provides the help link in...

banner_toolbar.jspf

...in...

/themes/html/Portal

For customized themes, this help link could be placed in other theme JSP files. To provide site-specific help, you can edit the target of the help link or edit the help source that is provided by WebSphere Portal.

The help link in Page Builder is located in Default.jsp...

...and is...

    <a href='javascript:void(0);' 
       onClick="javascript: return wptheme_showHelpWindow('${wpsDocURL}');">
    
    <portal-fmt:text key='link.help' 
                     bundle='nls.engine'/>
    </a> 

To change the help link, edit the link in the JSPs that are provided for each theme that you use. The following example shows the default help link target:

    href="<%= wpsDocURL %>/help/index.html"

To edit the help source, edit the help file at the following location:

PROFILE_HOME/installedApps/cellname/wps.ear/wps.war/doc/locale/help/index.html

Change the help window size

Code to resize the help window is located in banner.jspf (for themes that use the page builder template, the code to resize the help window is in js.jsp). By default, the help window width is set to 800 pixels and the height is set to 600 pixels, using the JavaScript onClick event handler of the anchor tag.

To change the window size...

1. Locate the markup for the help link.

2. In the corresponding anchor tag, look for the width=800,height=600 values in the window.open() method.

3. Change these values to the desired width and height values for the help window.

Parent topic:

Customize the portal

Related concepts

Portal style classes
Work with portal navigation
Use JSTL tags in the portal JSPs
User and group management

Related tasks

Creating a new theme
Import a theme
Deploy the theme
Creating a new skin
Enable automatic JSP reloading
Supporting new clients
Supporting new markup languages
Changing banner text

Related reference

Use the color palette in themes
Performance guidelines for themes and skins

---