+

Search Tips   |   Advanced Search


Display the profile details of an item

The Profile component tag is used to display the profiling details (either categories or keywords) of an item. This tag can be added to presentation templates, element designs and component designs.

<profilecmpnt type=" " context=" " name=" " field=" " format=" " separator=" " include=" " restrict=" " ifEmpty=" " htmlencode=" " start=" " end=" " />
<profilecmpnt Opens a Profile Component tag.
type=" " This determines where the profile is being referenced from. Either "site", "sitearea", "content" or "user".

The user type displays a users profile. You can either select context="current" to display the current users profile, or context="selected" and enter a user name in the name parameter to display a specific user profile.

context=" " This determines which item is being referenced.

Selected

Refers to a particular item as specified in the name attribute below.

Current

This will reference the component from the current site, site area or content file that is being browsed by the user.

AutoFill

The component being referenced will be determined by the search parameters of a menu, navigator or taxonomy component.
name=" " Enter the name and library of the item being referenced.

For example, name="library/item" . If no library is specified, the library specified in the URL of the current page is used. This is not used if context=current or context=autofill.

field=" " Enter the field you wish to display.

  • categories.

  • keywords.

format=" "

When field="categories":

When field="categories" the format parameter is used to determine the output format.

  • format="title" displays a list of category titles.

  • format="uri" displays a the wcm:oid:<id> style URI for each listed category.

separator=" " Separate each listed category or keyword.

For example, separator=", "

Double-byte character sets

Not all double-byte character sets support extended ASCII. To use tags such as "&nbsp;" replace "&" with "&amp;".

For example:

separator="&amp;nbsp;&amp;nbsp;"
ifEmpty=" " Enter some text to display if no result is returned by the tag. If not specified, nothing is displayed if no result is returned by the tag.
include=" " Used only with field="categories". Determines which level of a taxonomy to display:

  • exact

  • ancestors

  • descendants

  • all

For example, if an item is profiled with a category of Sport, and include="descendants", then all the descendants of "sport" would also be displayed.

restrict=" " Used only with field="categories". Enter a list of categories separated by commas to only return results for the categories specified in the list.

For example, restrict="red, green" will only display profile details of items profiled with the categories or red or green.

htmlencode=" " If htmlencode="true" any reserved HTML characters in categories or keywords 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 Web content tag within other tags, such as HTML. These attributes are not mandatory.
/> Closes the tag.


Parent topic:

Creating Web content tags