You use a placeholder tag to display metadata within an
element or component design.
About this task
This is the format of a placeholder tag:
[placeholder tag=" " htmlencode=" " start=" " end=" " ]
To create a placeholder tag:
Procedure
- Click Insert a Tag from a component
or element design field. The Tag Helper dialog
opens.
- Select Placeholder as the tag type.
- Select a placeholder tag type. This is added to the placeholder
tag as the tag=" " parameter:
- 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 is 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 is 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 is fully qualified
when viewed through a portal. To generate URLs with no prefix, use
the "noprefixtitleLink" parameter instead of the "titleLink" parameter.
- sitepath
- This is similar to the HREF placeholder except that it only display
the site path of an item's 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:
Note that the final / slash is not included when the site path
is displayed for 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 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:
- First
- Second
- Third
- Treenum
- Displays a hierarchical numbered list:
- 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.
- If you are using the placeholder tag with an authoring
tools element that is rendered by the JSR 286 web content viewer,
specify 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.
- Select the type of encoding for the placeholder:
- Encode tag output
- If selected, the reserved HTML characters in the source is converted
into character entities. For example, '<' is converted to '<'.
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.
- Do not encode tag output
- If selected, no encoding is applied to the HTML rendered by the
placeholder tag.
- Default encoding
- If selected the default setting specified by the cmpnt.htmlEncodeDefault property in the WCM WCMConfigService service is
used. By default, this property is set to true.
- Click OK to add the tag to your
design.
What to do next
Once you have added the tag to your design, you can also
add the following parameters to the tag:Table 1. Additional tag
parametersTag parameters |
Details |
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. |
Using a URLCmpnt tag: The
URLCmpnt tag is used to generate a URL to a 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.