+

Search Tips   |   Advanced Search


Use Placeholders in element designs

Use a placeholder tag to display metadata within an element design.

<placeholder tag=" " htmlencode=" " start=" " end=" " />
<placeholder Opens a Placeholder Tag.
tag=" " Determines which placeholder is being referenced:

  • Name

  • Title

  • dn

  • Href

  • noprefixhref

  • Namelink

  • noprefixnamelink

  • Titlelink

  • noprefixtitlelink

  • Sitepath

  • Idnum

  • Listnum

  • Treenum

  • Paddedtreenum

  • Depth

htmlencode=" " If htmlencode="true" the reserved HTML characters in the source will be converted into character entities.

For example, '<' will be converted to '&lt;'. This is useful if you would like to prevent users adding malicious code, or if you want to prevent users changing the look and feel of their text using HTML. If not specified, the default setting specified in WCMConfigService.properties located in the PROFILE_HOME/PortalServer/wcm/config/ directory is used. By default, this is set to "true":

cmpnt.htmlEncodeDefault=true
start=" "

end=" "

The start and end attributes are used to wrap the data returned by a tag within other tags, such as HTML. These attributes are not mandatory.
/> This closes the tag.


Placeholder types

Name This is used to display the name of the site area or content being retrieved in a menu or navigator. This can also be used when you create a user name component, where you can add a placeholder tag in the design and specify tag="name" to render the name of the user.
Title This is used to display the title of the site area or content being retrieved in a menu or navigator.
dn This is for when you create a user name component.

You can add a placeholder tag in the design and specify tag="dn" to render the distinguished name of the user.

HREF This inserts a link to the page of the site area or content being retrieved in a menu or navigator.
noprefixhref The URLs generated by "HREF" parameter will be fully qualified when viewed through a portal. To generate URLs with no prefix, use the "noprefixhref" parameter instead of the "HREF" parameter.
NameLink This is a combination of the name and HREF tags. It assembles a complete link based on the name of the item being returned.
noprefixnameLink The URLs generated by "nameLink" parameter will be fully qualified when viewed through a portal. To generate URLs with no prefix, use the "noprefixnameLink" parameter instead of the "nameLink" parameter.
TitleLink This is a combination of the title and HREF tags. It assembles a complete link based on the title of the item being returned.
noprefixtitleLink The URLs generated by "titleLink" parameter will be fully qualified when viewed through a portal. To generate URLs with no prefix, use the "noprefixtitleLink" parameter instead of the "titleLink" parameter.
Using a URLCmpnt tag.

The URLCmpnt tag is used to generate a URL to a site, site area or content item and can be used as an alternative to a placeholder when generating a URL.

This is particularly useful when creating links to Web content displayed within rendering portlets.

sitepath This is similar to the HREF placeholder except that it only display the site path of an items URL.

For example, an HREF placeholder tag displaying a content item may give you:

  • /ILWWCM/connect/metaorg/intranet/press+releases

Whereas the site path will give you:

  • /metaorg/intranet/press+releases

For example, an HREF placeholder tag displaying a site area may give you:

  • /ILWWCM/connect/metaorg/intranet/

Whereas the site path will give you:

  • /metaorg/intranet

The final / slash is not included when the site path is displayed for sites and site areas.

Idnum This returns the hexadecimal id value of an item. This can be used when creating static URLs in menus and navigators.

You could hard-code the site/site area path in a menu or navigator element design and use the Idnum for each content item being displayed.

This would allow you to display content with a different presentation template (for example, a printer friendly presentation template) or use different security settings.

Listnum Displays a single column list of numbered links:

  1. First

  2. Second

  3. Third

Treenum Displays a hierarchical numbered list:

1.0

1.1

1.2

2.0

2.1

2.2

Paddedtreenum Similar to Treenum, but the numbers are padded:

0001

00010001

00010002

000100020001

000100020002

Depth Displays the depth of the currently processed node (in a navigator or menu) as a number. A top-level node has a depth of 1.

Using placeholders tags with authoring tools elements: When using placeholder tags in the element design of an authoring tools component that is rendered by the JSR 286 Web Content Viewer, use the format attribute to control where the authoring task is performed.

format="tag"

The placeholder is rendered as a URL that opens a pop-up window containing the authoring portlet. This is the default value if no value is specified.

format="url"

The placeholder is rendered as a URL that redirects the user to a hidden portal page that is used by the JSR 286 Web Content Viewer for inline editing.


Parent topic:

Creating Web content tags