Director Tutorials


Accessing Accessory Portlets

 
Top of page

Objective

Add some accessory portlets to a personal page, use the portlet options, and access portlet preferences.

Before you begin   See About exteNd Director Tutorials

Audience   This section is for portal end-users.

 
Top of page

Concepts

 
Top of page

Exercises

This section provides exercises that show you how to perform the following tasks:

 
Top of section

Adding accessory portlets to a page

The accessory portlets are a set of production-quality portlets that you can use on a personal or shared page in the ExpressPortal project or in your own exteNd Director project. They provide rich interaction with web sites, access to local applications, and other functions of interest to general users. Some of the accessory portlets have been converted from Novell Portal System (NPS) gadgets. All of the accessory portlets conform to the Java Portlet 1.0 specification.

Procedure To access ExpressPortal:

  1. Start a browser.

  2. Open the Express Portal application by typing this URL:

      http://host/ExpressPortal
    

    NOTE:   host is the machine on which the application is running. If the application is running on your local machine, use localhost.

    The default page for a guest user displays:

    GuestUserPage

  3. Click Login on the right side of the portal title bar.

    The login page displays:

    login

  4. If you have logged in to ExpressPortal previously you can use the same name and password to access the default ExpressPortal page. Otherwise, create a new user by following these steps:

    1. Click the New User? link on the login page.

  5. Fill in all of the requested fields. For example:

    Field

    Sample Entry

    User ID

    MDoe

    password

    mdoe

    First Name

    Mary

    Last Name

    Doe

    Email

    mdoe@tutorial.com

  6. Click the Create icon

    The login page reappears with a message indicating the new user has been successfully created.

  7. Log in using the new user and password.

    The default page for a non-administrator user displays.

    NewUserPage

TIP:   Now you are ready to create a personal page with accessory portlets. Leave the default user page running in the browser and move to the next exercise.

Procedure To create a personal page and add accessory portlets:

  1. Click Personalize on the right side of the title bar.

    The Portal Personalizer displays:

    Personalizer

  2. Under Personal Pages select New.

  3. Enter the following properties:

    Property

    What to specify

    Page Name

    Enter My Accessory Portlets

    Description

    Enter Tutorial

  4. Click Update.

  5. With the new page selected click Choose Content.

    The Content Selector displays:

    ContentSelector

  6. From the Filter dropdown list choose Accessory Portlets.

  7. From the Available Content list add the following portlets to the page by clicking Add:

    TIP:   You can select multiple items by pressing the Ctrl key while clicking, then add all items as a group.

  8. Close the Content Selector by choosing Close at the bottom of the form.

    The Portal Personalizer displays again.

  9. Choose Arrange Content.

    The Layout Selector displays:

    Click and drag Rss News Feed and Shortcut into the right column so the Layout Selector looks like this:

    Layout

  10. Click Save Layout at the bottom of the form.

    The Layout Selector closes and the Portal Personalizer displays.

  11. In the Portal Personalizer choose Portal.

    The default ExpressPortal page displays. Notice the new item My Accessory Portlets listed under Personal Pages in the navigation pane:

    PageWithMyAccessoryPortlet

  12. Select Accessory Portlets under Personal Pages.

    The new page displays the IFrame, Rss News Feed, and Shortcut portlets in the content frame. It should look something like this:

    MyAccessoryPortlets

TIP:   Now you are ready to learn about portal options. Leave this page running in your browser and move to the next exercise.

 
Top of section

Using portal options

A portal option is an image or text that appears in the title bar of a portlet. Each portal option specifies a link that controls which action will be performed when the user clicks on the option. For example, a portlet title bar can provide buttons to allow the user to edit, minimize, or restore the portlet.

Procedure To use portlet options:

  1. Move your cursor to the title bar of the RSS News Feed portlet and click the minimize button:

    RssNewsFeedMinimize

    TIP:   To display a tool tip hover over the option with your mouse.

    The RSS News Feed portlet window is minimized and the minimize button is replaced with a restore window icon.

  2. Click the restore window icon.

  3. Move your cursor to the title bar of the iFrame portlet and click the maximize button:

    The IFrame portlet window is maximized and the maximize button is replaced with a restore window icon.

  4. Click the restore window icon.

    NOTE:   The IFrame portlet has an edit option that allows you to access portlet preferences as defined for this portlet.

 
Top of section

Accessing help for accessory portlets

Each accessory portlet provides online help that can be accessed from an option in its title bar.

Procedure To access help for accessory portlets:

  1. Click the help icon in the title bar of each portlet.

    Help

    A general description of the portlet appears in the portlet window.

  2. Choose Click here to Return at the bottom of each help window to dismiss the help text and restore the original content:

    HelpReturn

TIP:   Now you are ready to learn about portlet preferences. Leave the page running in your browser and move to the next exercise.

 
Top of section

Accessing portlet preferences

Each of the accessory portlets has default content and behavior. You can customize portlets by modifying portlet preferences.

Procedure To access preferences for a portlet:

  1. Click Personalize on the right side of the title bar.

    The Portal Personalizer opens.

  2. In the Portal Personalizer select Choose Content.

  3. From the Selected Content box select iFrame and choose Content Preferences:

    IFramePreferences

    The Content Preferences editor opens for the iFrame portlet:

    IFramePreferencesEditor

TIP:   Now you are ready to access help for portlet preferences. Leave the Content Preferences editor open and move to the next exercise.

Procedure To access help for portlet preferences:

  1. Select Descriptions at the bottom of the Content Preferences editor.

    Help for each preference appears in the Descriptions column of the editor:

    IFramePreferencesDescriptions

  2. Select Hide Descriptions.

  3. Close all browser windows.

 
Top of page

What to do next



Copyright © 2004 Novell, Inc. All rights reserved. Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003 SilverStream Software, LLC. All rights reserved.  more ...