14.2 Portlet preferences

You can personalize many options for the HTML Message Editor portlet by setting portlet preferences. Details about each preference are available in this section, or by clicking Show Descriptions in the Portlet Preferences Editor.

For each HTML Message Editor portlet preference, specify a value and settings.

Preference settings

Description

Hide

When Hide is checked, this preference is not visible at runtime.

Required

When Required is checked, this preference must be set at runtime.

Read Only

When Read Only is checked, this preference cannot be changed at runtime.

You can set values for the following HTML Message Editor portlet content preferences:

Preference

Value to specify

Message for view mode

Click View/Edit Custom Preference to begin creating a message. You must then select a locale, click Go, and create a message. See Section 14.2.1, Editing a message.

Stylesheet

Specify a style sheet for the page.

Height

Specify the height of the inline frame in pixels. For example, the height of a 640x480 display is 480.

Width

Specify the width of the portlet on the page. To specify a percentage of the total page width, use a number followed by a percent sign, for example 75%. To specify absolute width, use the number of pixels, for instance half the width of a 640x480 display would be 320.

14.2.1 Editing a message

To edit a message:

  1. Open the HTML Editor portlet preferences window.

  2. Click View/Edit Custom Preference.

  3. Choose a locale from the drop-down list, and click Go.

  4. Click in the text area. Use the text area and the tools (including Custom Dropdown Text menu) available in the palette to create or edit a page.

  5. Optionally, create, edit, or delete Custom Controls. See Section 14.2.2, Custom controls.

  6. Optionally, check View Source to view and edit the html source for the message.Uncheck View Source to return to view mode.

  7. Click Return to List View to return to Preferences without saving changes, or click Save to save the changes and then click Return to List View to return to Preferences.

14.2.2 Custom controls

When you edit a message, you can save text strings or functions for use in messages. To do so, create a Custom Key and associate a value (text string or function) with the key.

To add a new Custom Control item:

  1. In the Define Custom Dropdown Text Menu area, under Custom Key, enter text to use as the key.

  2. Enter a Value to associate with the key.

  3. Click Add. The key shows up in the Custom Dropdown Text drop-down box. If the custom key already exists, the new corresponding value overwrites the old one. If you want to add a name variable to Custom Dropdown Text, use $[path]. Do not use ${path}

To delete a Custom Control item

  1. In the Define Custom Dropdown Text Menu area, under Custom Key, enter the key to delete

  2. Click Delete.