Portal Predefined Settings

The portal defines some settings that allow the theme to determine certain behaviors. As of this writing, predefined settings are only available for portlet borders and bullet styles, but more settings may be added in the future. Modify these settings from the liferay-look-and-feel.xml file.

By default, portlet borders are turned on. If set to false, the portal’s default behavior is to turn off portlet borders.

Here’s how the XML looks when you modify the default to false:

<settings>
    <setting key="portlet-setup-show-borders-default" value="false" />
</settings>

Override default behavior for individual portlets using:

• liferay-portlet.xml

• Portlet CSS popup setting: Used by the Navigation portlet to determine the CSS class name of the list of pages. The value must be a comma separated list of valid bullet styles.

Example:

<settings>
    <setting key="bullet-style-options" value="classic,modern,tablemenu" />
</settings>

The user can change the bullet style in the Navigation portlet’s configuration menu. The chosen style is applied as a CSS class on the <div> containing the navigation. This class is named in the following pattern:

.nav-menu-style-{BULLET_STYLE_OPTION} {
    ... CSS selectors ...
}

Here’s an example of the HTML code needed to add style through CSS code. In this case the bullet style option is modern:

<div class="nav-menu nav-menu-style-modern">
    <ul class="breadcrumbs lfr-component">
       ...
    </ul>
</div>

Using CSS, and maybe some unobtrusive JavaScript, you can create any type of menu.

Next we’ll see how Liferay lets your theme inherit styling from a parent theme.