Grouping Items in a Region

Working with Layouts 10-23 By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

4. Under Pages in the Layout Appearance section, click the link to the page where

the portlet region is located. This opens the page in Edit mode.

5. Click the Edit Region icon in the relevant portlet region

Figure 10–34 . Figure 10–34 The Edit Region Icon

6. On the resulting page, go to the Portlet Display Options section, and specify your

portlet header and border preferences. Choose from: ■ Select Show Portlet Headers to display a color banner that contains the portlet display name and all available and enabled links and icons see Section 10.2.13 . Leave this option unselected to hide portlet headers and their associated links and icons. ■ Select Show Portlet Borders to display a thin line the color of the portlet header around the portlets in a region. Leave this option unselected to hide portlet borders.

7. Click OK to save your changes and return to the page.

10.2.13 Showing or Hiding Portlet Header Links

Many of the portlets provided through Oracle Portal, as well as through third parties, include individual controls for such actions as personalizing the portlet, performing a specific refresh on the portlet, invoking portlet help, and so on. When you display portlet headers see Section 10.2.12 , you also have the option of showing or hiding portlet controls in each portlet header in a region. Note: Regardless of whether a page portlet or navigation page uses its source pages style, once the page portlet or navigation page is placed on a page, its headers and borders always use the style of the target page. This is because the controls for a portlet’s headers and borders operate at the region level, and the region is a component of the target page. If you do not care to use the target pages header and border colors on the portlets belonging to a page portlet or a navigation page, you can turn off the display of headers and borders at the region level on the target page. If the page portlet or navigation page also contains its own portlets, you must also turn off the display of headers and borders for portlet regions on the source page. To ensure that a page portlet or navigation page uses its own background color, rather than the one specified for its host page: 1. Do not select the option Use Style Of Page On Which Portlet Is Placed for the navigation page or the page that you are publishing as a portlet. 2. In the style used by the target page, clear any value from the Portlet Body Color style element and click Apply. 10-24 Oracle Fusion Middleware Users Guide for Oracle Portal The controls that are available depend on the types of controls that were included in the portlet when it was constructed. Although you may select all control options when you edit region properties, only those controls intrinsic to the portlet display. For example, you may choose to expose a Help link in a portlet header. If the developer who created the portlet provided portlet help, the Help link displays. If the developer did not provide help, the link does not display, even though it is selected for display in region properties. When you edit region properties to show or hide portlet header links, all the portlets within the region are affected. The display of portlet header links are controlled at the region level. If you want some portlets to display links and others to hide them, you can place the display portlets in one region, where links are exposed, and the hide portlets in another, where links are hidden. Link options include: ■ Personalize —Enables users to create a personal view of a portlet ■ Help —Connects to portlet help text ■ About —Connects to a portlet description ■ Details —Links the portlet title to a more detailed view of the portlet ■ Refresh —Refreshes the display of a portlet without refreshing the entire page ■ Remove —Removes the portlet from the user’s personal view of the page ■ CollapseRestore —Minimizes and maximizes portlet display in the user’s personal view of the page For information on how to specify Help and About text for your portlets, see the Portal Developer Kit on the Oracle Portal section of the Oracle Technology Network, http:www.oracle.comtechnologyproductsiasportalportlet_ development_10g1014.html . If you do not display portlet headers see Section 10.2.12 , the links described in this section will not display, even if you have selected a display check box. Portlet header link options are available only for portlet regions. Note: When users remove a portlet from their own view of a page, it is the same as when they hide the portlet from view. See Section 15.4, Hiding and Showing Portlets for more information. In either case, the user can restore the portlet by personalizing the page and selecting the Show action on the portlet. With this in mind, any page that contains portlets with a Remove header link should also include a Personalize link to allow users to restore removed portlets. Note: The Personalize, CollapseRestore, and Remove linksicons do not display when the page is in Edit mode. They display when the user returns the page to View mode. When you suppress the display of the CollapseRestore icon on a portlet header, all instances of collapsed portlets on the affected page are restored automatically to prevent them from being stuck in a permanently collapsed state. Should the display of the CollapseRestore icon be reinstated, all portlet instances are reset to the state they were in before icon display was suppressed. Working with Layouts 10-25 To show or hide portlet header links: 1. Log in to Oracle Portal.

2. Click the Build tab to bring it forward.

3. From the Page Groups portlet Work In drop-down list, select the page group that

owns the page where the portlets are located. By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

4. Under Pages in the Layout Appearance section, click the link to the page where

the portlets are located. This opens the page in Edit mode.

5. Click the Edit Region icon in the region where the portlets are located

Figure 10–35 . Figure 10–35 The Edit Region Icon

6. On the resulting page, go to the Portlet Display Options section, and select from:

■ Show Portlet Headers, to show portlet headers, then select the portlet header links you will display. ■ Clear the Show Portlet Headers check box to hide portlet headers. When portlet headers are hidden, no links display, whether or not they are selected.

7. Click OK to save your changes and return to the page.

10.2.14 Changing Portlet and Item Spacing

In designing the layout of your portal pages, you may want to exercise tight control over the spacing of objects within regions. Oracle Portal provides this control through region display options. Using these options, you can change the amount of blank space rendered around and between the portlets and items in a region. Figure 10–36 shows the same region with different portlet spacing. In the first example the space around portlets is set to 4 pixels and the space between portlets is set to 6. In the second example, the space around portlets has been changed to 10 pixels. In the final example the space between portlets has been changed to 15 pixels. Figure 10–36 The Same Region with Different Spacing around and between Portlets To change item and portlet spacing: 1. Log in to Oracle Portal.

2. Click the Build tab to bring it forward.

3. From the Page Groups portlet Work In drop-down list, select the page group that

owns the page where the region is located.