RSS
 

All the IBM WCM 7 Tags

16 Jul

Page edited by Ben Shoemate

You use IBM® Web Content Manager tags to reference elements (such as title, id, date, and custom elements you added to authoring templates when you created them) within presentation templates and element designs (menu components, personalization components, etc). IBM Documentation here: http://www-10.lotus.com/ldd/portalwiki.nsf/dx/Creating_web_content_tags_wcm7 and consolidated below.

Alternate design tags 

You use an alternate design tag to display a different component based on whether the item being returned by a menu or navigator is on the current path or not.

[alternatedesign highlight=" " normal=" " type=" " start=" " end=" " ]

Table 1. Additional tag parameters

Tag parameters Details
normal=" " To use the library specified in the URL of the current page, use normal="./name"

Note: If you specify normal="./name", the library name does not appear in your presentation template or element design. The actual path is not resolved until the item is rendered.
highlight=" " To use the library specified in the URL of the current page, use highlight="./name"

Note: If you specify highlight="./name", the library name does not appear in your presentation template or element design. The actual path is not resolved until the item is rendered.
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.
Back to Top

Attribute resource tags

You use the attribute resource tag to define the information returned by a search query.

[attributeResource attributeName="parameter" separator=" " format=" "]

Table 1. Additional tag parameters

Tag parameters Details
attributeName=authoringtemplate The name of the authoring template, if available, that was used to create the content item.
attributeName=author The name or names of the authors of the content item, if any are defined. If there is more than one author, then they are rendered with the string specified in the optional separator attribute between each value.
attributeName=category The categories of the content item if any are defined. If there is more than one category, then they are rendered with the string specified in the optional separator attribute between each value.
attributeName=contentid The id of the content item.
attributeName=contentpath The path excluding the server address, port, or servlet context (/wps/wcm) for this search result.
attributeName=date The value of the date field from the SIAPI result. The format of the date can be specified by using the optional format attribute. See the Javadoc HTML documentation for SimpleDateFormat in the Java SDK for details.
attributeName=description The description of the content item.
attributeName=effectivedate The effective date of the content item. The format of the date can be specified by using the optional format attribute. See the Javadoc HTML documentation for SimpleDateFormat in the Java SDK for details.
attributeName=expirationdate The expiration date of the content item. The format of the date can be specified by using the optional format attribute. See the Javadoc HTML documentation for SimpleDateFormat in the Java SDK for details.
attributeName=keywords The keywords of the content item if any are defined. If there is more than one keyword, then they are rendered with the string specified in the optional separator attribute between each value.
attributeName=lastmodifieddate The last modified date of the content item. The format of the date can be specified by using the optional format attribute. See the Javadoc HTML documentation for SimpleDateFormat in the Java SDK for details.
attributeName=modifier The name of the last person to modify the content item.
attributeName=name The name of the content item.
attributeName=namelink This assembles a complete link based on the name of the item being returned.
attributeName=owner The name or names of the owners of the content item, if any are defined. If there is more than one author, then they are rendered with the string specified in the optional separator attribute between each value.
attributeName=parentcontentpath This is used to return the content path excluding the server address, port, or Servlet context for the parent content item of this search result. For example: /wps/wcm

This parameter is valid when the search results include a link to a file resource element in the parent content item and is used to give context to the attached file. When the search result is not for an attached file in a file resource element, this value is an empty string.
attributeName=relevance The relevance “score” for this search result from the search engine.
attributeName=summary The summary of the content item as generated by Portal Search.
attributeName=title This is the title of a content item.
attributeName=titlelink This assembles a complete link based on the title of the item being returned.
attributeName=url Displays the URL of a content item.
format=" " This parameter is optional and can only be used with some parameter types:
When referencing number or date elements:
  •  Options:
    • format="DATE_SHORT"
    • format="DATE_MEDIUM"
    • format="DATE_LONG"
    • format="DATE_FULL"
    • format="DATE_TIME_SHORT"
    • format="DATE_TIME_MEDIUM"
    • format="DATE_TIME_LONG"
    • format="DATE_TIME_FULL"
    • format="TIME_SHORT"
    • format="TIME_MEDIUM"
    • format="TIME_LONG"
    • format="TIME_FULL"
    • format="relative" (The relative date is displayed as either "today", "yesterday" or the number of days ago.)** Setting parameters to format dates
    • Note on formatting numbers
separator=" " Enter text or code to be used to separate multiple search results. For example: separator=" - "
Back to Top

Component tags

The Component tag is used to reference the content of a component within a presentation template or element design.

[Component name=" " context="autofill" format=" " separator=" " compute=" "
  htmlencode=" " awareness=" " start=" " end=" " ]

Table 1. Additional tag parameters

Tag parameters Details
name=" " To use the library specified in the URL of the current page, use name="./item".

Note: If you specify name="./item", the library name does not appear in your presentation template or element design. The actual path is not resolved until the item is rendered.
context="autofill" This parameter is only used when referencing a Component tag within a Personalization element design to display the results of a Personalization rule that searches for components.
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.
format=" " This parameter is optional and can only be used with some component types:
When referencing an image component:
format="url"
format="tag"
When referencing a file resource component
  • word-processing documents (*.doc, *.odt)
  • spreadsheets (*.xls) *
  • HTML files (*.htm, *.html)
    Text files (.txt)*Maximum Cache Size:

    resourceserver.maxCacheObjectSizeWCM WCMConfigServiceresourceserver.maxCacheObjectSizeformat="HTML"
    When referencing file resource and image components:
  •  
  • Use format="mimetype" to render the mime type of a file or image. If no valid mime type can be determined then "www/unknown" is rendered.
  • Use format="filename" to render the name of a file or image.
  • Use format="size" to render the size of a file or image using the most appropriate unit. If the resource is smaller than 1K then the size in bytes is rendered. If the size of the resource is less than 1MB then the size in kilobytes are rendered. If the size is greater than or equal to 1MB then the size is rendered in megabytes.
  • Use format="size_bytes" to render the size of a file or image in bytes. Only the numeric value is displayed.
  • Use format="size_KB" to render the size of a file or image in kilobytes. Only the numeric value is displayed.
  • Use format="size_MB" to render the size of a file or image in megabytes. Only the numeric value is displayed.

    When referencing a link component:
  • /wps/wcm/myconnect/Library/SiteArea/Content
    /Library/SiteArea/Content
    **  
    •  
    • format="noprefixurl"
    • format="noprefixpath"
    • format="noprefixtag"
  • <a href="/wps/wcm/myconnect/Library/SiteArea/Content"></a>

    Note: format="url"format="path"format="tag"
    When referencing number or date elements:   * format="DATE_SHORT"
  • format="DATE_MEDIUM"
  • format="DATE_LONG"
  • format="DATE_FULL"
  • format="DATE_TIME_SHORT"
  • format="DATE_TIME_MEDIUM"
  • format="DATE_TIME_LONG"
  • format="DATE_TIME_FULL"
  • format="TIME_SHORT"
  • format="TIME_MEDIUM"
  • format="TIME_LONG"
  • format="TIME_FULL"
  • format="relative" (The relative date is displayed as either "today", "yesterday" or the number of days ago.)** Setting parameters to format dates
  • Note on formatting numbers

    When referencing user details:*  format="cn" is used to display the common name.
  • format="dn" is used to display the distinguished name.
    Maximum character length:
  •  format="length:number_of_characters"** format="length:10" |
compute=" " This is only applicable to menu, navigator, and taxonomy components. You specify compute="always" when you reference some JSP code within a component design, and you want that code to be run separately on each result returned by a menu, navigator and taxonomy component.

For example, if a menu referenced JSP code that used the public DocumentId getCurrentResultId(); method, you would use compute="always" to make the JSP code run separately in every result returned by the menu.

If not specified, then compute="once" is used which is the default method for delivering the results of menu, navigator, and taxonomy components.
htmlencode=" " If htmlencode="true" the reserved HTML characters in text and short text components are 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.

If not specified, the default setting specified by the cmpnt.htmlEncodeDefault property in the WCM WCMConfigService service is used. By default, this property is set to true.
awareness=" " If awareness="true" then user names are displayed using the people awareness features. This feature displays user names as hyperlinks that allow users to contact people with whom they might want to work. Wherever person links appear, users can click the link to display a menu of actions for collaborating (contacting and working) with the person named by the link. If you, as administrator, have also configured an IBM® Lotus® Sametime® server to work with WebSphere® Portal, person links indicate whether a person is active, away, offline, or in a Do Not Disturb state.

People awareness only works in content rendered using either a local or remote rendering portlet.

If not specified, then awareness="false" and people awareness is not used.
separator=" " This only used when referencing a user selection component. It is used to define what text or code is rendered between each selection. For example, to add a line break between each selection, you would use separator="<br>" . If not defined, a comma is placed between each selection when rendered.
Back to Top

Element tags

The Element tag is used to reference an element within a presentation template or element design.

[Element type=" " context=" " name=" " key=" " format=" " link=" " separator=" "

htmlencode=" " awareness=" " start=" " end=" " ]

Table 1. Additional tag parameters

Tag parameters Details
name=" " If you specify name="./itemName", the actual path is not resolved until the item is rendered. This takes slightly longer to resolve than specifying the path to the item.
format=" " This parameter is optional and can only be used with some element types:
When referencing an image element:
format="url"
format="tag"
When referencing a link element:
  •  
    /wps/wcm/myconnect/Library/SiteArea/Content
    /Library/SiteArea/Content
    **  
      • format="noprefixurl"
      • format="noprefixpath"
      • format="noprefixtag"

        <a href="/wps/wcm/myconnect/Library/SiteArea/Content"></a>

        Note: format="url"format="path"format="tag"
        When referencing a file resource element:
  •  
    •  
      • word-processing documents (*.doc, *.odt)
      • spreadsheets (*.xls) *
      • HTML files (*.htm, *.html)
      • Text files (.txt)*Maximum Cache Size:

        resourceserver.maxCacheObjectSizeWCM WCMConfigServiceresourceserver.maxCacheObjectSizeformat="HTML"
        When referencing file resource and image elements:
  • Use format="mimetype" to render the mime type of a file or image. If no valid mime type can be determined then "www/unknown" is rendered.
  • Use format="filename" to render the name of a file or image.
  • Use format="size" to render the size of a file or image using the most appropriate unit. If the resource is smaller than 1K, then the size in bytes is rendered. If the size of the resource is less than 1MB, then the size in kilobytes is rendered. If the size is greater than or equal to 1MB, then the size is rendered in megabytes.
  • Use format="size_bytes" to render the size of a file or image in bytes. Only the numeric value is displayed.
  • Use format="size_KB" to render the size of a file or image in kilobytes. Only the numeric value is displayed.
  • Use format="size_MB" to render the size of a file or image in megabytes. Only the numeric value is displayed.

    When referencing number or date elements:
  •  
    • format="DATE_SHORT"
    • format="DATE_MEDIUM"
    • format="DATE_LONG"
    • format="DATE_FULL"
    • format="DATE_TIME_SHORT"
    • format="DATE_TIME_MEDIUM"
    • format="DATE_TIME_LONG"
    • format="DATE_TIME_FULL"
    • format="TIME_SHORT"
    • format="TIME_MEDIUM"
    • format="TIME_LONG"
    • format="TIME_FULL"
    • format="relative" (The relative date is displayed as either "today", "yesterday" or the number of days ago.)** Setting parameters to format dates
    • Note on formatting numbers

      When referencing user details:
  •  
    • format="cn" is used to display the common name.
    • format="dn" is used to display the distinguished name.

      Maximum character length:
  •  
    • format="length:number_of_characters"** format="length:10"

link=" " The link parameter is used to define the type of link created by the element tag:
  • link="default" 
  • link="path"
  • link="contextual"
    Contextual linking: 
    Contextual linking is used so that when content is linked from another site, the link is rendered relative to the current site if possible. It can only be used if context=current orcontext=autofill. 
separator=" " This is used when referencing an option selection or user selection element. It is used to define what text or code is rendered between each selection displayed in an option selection or user selection element. For example, to add a line break between each selection, you would use separator="<br>". If not defined, a comma is placed between each selection when rendered.
htmlencode=" " If htmlencode="true" the reserved HTML characters in text, short text and option selection elements are 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.

If not specified, the default setting specified by the cmpnt.htmlEncodeDefault property in the WCM WCMConfigService service is used. By default, this property is set to true.
awareness=" " If awareness="true" then user names are displayed using the people awareness features. These features display user names as hyperlinks that allow users to contact people with whom they might want to work. Wherever person links appear, users can click the link to display a menu of actions for collaborating (contacting and working) with the person named by the link. If you, as administrator, have also configured an IBM® Lotus® Sametime® server to work with WebSphere® Portal, person links indicate whether a person is active, away, offline, or in a Do Not Disturb state.

People awareness only works in content rendered using either a local or remote rendering portlet.

If not specified, then awareness="false" and people awareness is not used.
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.
Back to Top

Information tags 

You use the page information tag to display page navigation details in the design of a page navigation element.

[PageInfo value=" " knowntext=" " unknowntext=" " start=" " end=" " ]

Table 1. Additional tag parameters

Tag parameters Details
knowntext=" "

unknowntext=" " 		These parameters are used when value="unknownPages". For example:

[PageInfo value="unknownPages"
knowntext="of" unknowntext="of at least" ]

This could be used with other PageInfo tags to render the following:
  • When the total number of pages are known: "Page 2 of 5."
  • When the total number of pages are unknown: "Page 2 of at least 5."

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.
Back to Top

Path component tags

The path component tag is used to represent certain parts of the URL such as the servlet path, the base path, or the context path of the current page. This tag can be added to presentation templates, element designs, and component designs.

[pathcmpnt type=" " start=" " end=" " ]

Table 1. Additional tag parameters

Tag 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.

Back to Top

placeholder tags 

You use a placeholder tag to display metadata within an element or component design.

[placeholder tag=" " htmlencode=" " start=" " end=" " ]
  • 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: /metaorg/intranet
      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:
    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.
Back to Top

Plug-in tags

Rendering plug-ins are referenced using the plug-in tag.

[plugin:pluginname paramKey="paramVal" ]
  Tag Body Content
[/plugin:pluginname]

You can have multiple paramKeys:

[plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2" ]

No parameters or body:

[plugin:pluginname ]

Content tags within the plugin tag

[plugin:pluginname paramKey1=" [IDCmpnt context='current' type='sitearea' field='id' ]" ]

Note: You must use single quotes within the web content tag being used as a parameter value.

Plug-in tag with body content

To reference a plug-in with parameters and content including a reference to a component:

[plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2" ]
    This is the tag body content.
    <br>
     [component name="test"]
    <br>
    More content.
[/plugin:pluginname ]

Remote action plugin tag example

You can reference remote actions using plugin tags using the following format:

[plugin:RemoteAction action=" " docid=" "
    useCurrentSelection=" " dialog=" " useCurrentContext=" "]
  • action= This is the remote action to perform.
  • docid= This is the document ID of the item to run the remote action against.
  • useCurrentContext= If set to true, then the document ID is obtained form the rendering context instead of the docid attribute.
  • dialog= If set to true, when rendered within a JSR 286 web content viewer portlet the remote action 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.

This is an example of a "new" action to create a content item:

[plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content"
 pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID2" atid="com.aptrix.pluto.presentation.template/ID1"
 wcmfield.content.name="newcontent" wcmfield.autosave="true" wcmfield.saveValidate="true" ]

JSP plugin tag:

Rendering plug-ins can be referenced within JSP code using the following format:

<wcm:plugin name=" " param1="value" param2="value2" >
// Your text.
</wcm:plugin>
Back to Top

Property tag

A property tag is used to display various fields and metadata from content items and site areas.

[Property field=" " context=" " type=" " name=" " key=" " format=" " link=" " separator=" "
htmlencode=" " awareness=" " ifEmpty=" " include=" " restrict=" " resolve=" "
start=" " end=" " ]

field=" " parameter:*

  • Name - Displays the text entered in the name field of an item.
  • Title - Displays the text entered in the title field of an item.
  • Description - Displays the text entered in the description field of an item.
  • Authors - Displays the users and groups selected in the authors field of an item.
  • Owners - Displays the users and groups selected in the owners field of an item.
  • ID - Displays the GUID of an item.

Authoring template properties:

  • authtemplateid - Displays the GUID of the authoring template used by the current content item.
  • authtemplatename - Displays the name of the authoring template used by the current content item.
  • authtemplatetitle - Displays the display title of the authoring template used by the current content item.

History properties:

  • lastmodified - Displays the last modified date and the last change message.
  • lastmodifieddate - Displays the last modified date. 
  • creation - Displays the creation date. 
  • lastmodifier - Displays the name of the user who last modified the item. 
  • creator - Displays the name of the user who created the item.

Profiling properties:

  • Categories - Displays a list of categories that an item has been profiled with. 
  • Keywords - Displays a list of Keywords that an item has been profiled with.

Access level properties:

  • *User - *Displays a list of users and groups assigned user access to an item. 
  • Contributor - Displays a list of users and groups assigned contributor access to an item.
  • Editor - Displays a list of users and groups assigned editor access to an item. 
  • Manager - Displays a list of users and groups assigned manager access to an item.

Workflow Properties:

  • Status - Displays the workflow status of an item. 
  • Workflow - Displays the selected workflow of an item. 
  • Current Stage - Displays the workflow stage that the item is currently in. 
  • Publish Date - Displays the date and time selected in the publish date field of an item. 
  • Expiry Date - Displays the date and time selected in the expiry date field of an item. 
  • General Date One - Displays the date and time selected in the general date one field of an item. 
  • General Date Two - Displays the date and time selected in the general date two field of an item. 
  • Additional Viewers - Displays the names of any additional viewers selected for an item. 

    type=" " parameter

  • Content - Use this option to display a property from the current content item.
  • Parent - Use this option to display a property from the parent site area of the current content item
  • Top - Use this option to display a property from the top site area in the current path of the current content item.

context=" " parameter:

  • Selected - Use this option to select a specific site area or content item. You must then add the name of the item being referenced using the name=" " parameter. You can select an item by clicking Select.
  • Current - Use this option to display a property from the current site area or content item
  • AutoFill - Use this option when the item is determined by the search parameters of a menu, navigator, or taxonomy component. If the tag is not used within a menu, navigator, or taxonomy component, the context will revert to the current item

If you select Selected, click the Select button to select a specific site area or content item.

Table 1. Additional tag parameters

Tag parameters Details
name=" " You must specify the name of the item being referenced if the context="selected". If you specify name="./itemName", the actual path is not resolved until the item is rendered. This takes slightly longer to resolve than specifying the path to the item.
format=" " This parameter is optional and can only be used with some element types:
When field="ID":
  • format="id" displays the plain ID. If not specified, this format is used by default.
  • format="uri" outputs a wcm:oid:<id> style URI.
    When referencing user details:
  • format="cn" is used to display the common name.
  • format="dn" is used to display the distinguished name.
    When field="categories":
  • format="title" displays a list of category titles.
  • format="uri" displays a wcm:oid:<id> style URI for each listed category.
    Maximum character length:
  •  format="length:number_of_characters"** format="length:10"
    When referencing number or date elements:
  •  
  • format="DATE_SHORT"
  • format="DATE_MEDIUM"
  • format="DATE_LONG"
  • format="DATE_FULL"
  • format="DATE_TIME_SHORT"
  • format="DATE_TIME_MEDIUM"
  • format="DATE_TIME_LONG"
  • format="DATE_TIME_FULL"
  • format="TIME_SHORT"
  • format="TIME_MEDIUM"
  • format="TIME_LONG"
  • format="TIME_FULL"
  • format="relative" (The relative date is displayed as either "today", "yesterday" or the number of days ago.)** Setting parameters to format dates
  • Note on formatting numbers
separator=" " This is used when referencing a property that returns multiple results. For example, to add a line break between each result, you would use separator="<br>" . If not defined, a comma is placed between each result when rendered.
htmlencode="" If htmlencode="true" any reserved HTML characters 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.

If not specified, the default setting specified by the cmpnt.htmlEncodeDefault property in the WCM WCMConfigService service is used. By default, this property is set to true.
awareness="" If awareness="true" then user names are displayed using the people awareness features. This feature displays user names as hyperlinks that allow users to contact people with whom they might want to work. Wherever person links appear, users can click the link to display a menu of actions for collaborating (contacting and working) with the person named by the link. If you, as administrator, have also configured an IBM® Lotus® Sametime® server to work with WebSphere® Portal, person links indicate whether a person is active, away, offline, or in a Do Not Disturb state.

People awareness only works in content rendered using either a local or remote rendering portlet.

If not specified, then awareness="false" and people awareness is not used.
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=library/categories. Enter a list of categories separated by commas to only return results for the categories specified in the list. For example, restrict="library/red, library/green" only displays profile details of items profiled with the categories of red or green. If no library is specified, the default library is used.
resolve=" " This determines which type of access to resolve to when rendering access level properties:
none

virtual

inherited

inheritedonly

effective

all |

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.

Back to Top

style element tag

- The style element tag is used to reference a style sheet component selected as the default style sheet in an authoring template, or a style sheet component referenced within a site area or content item using a component reference.

Note: To directly reference a specific style sheet component, use a component tag.

This is the format of a style element tag:

[StyleElement source=" " name=" " start=" " end=" "]

source=" " parameter:

  • *Template - *This option uses the style sheet specified in the authoring template of the current content item. You do not specify a name when using template as the source. To use this option, you must have selected a default style sheet in the related authoring template.
  • *Path - *This option uses the first style sheet element matching the name, specified in the name parameter, from either the current site area or content item in that order. To add a style sheet to a site area or content item, you need to use a component reference element and select a style sheet component as the component reference.

If a source type of "path" is selected, you must also select a content item and then select the component reference element that is used to reference the stylesheet.

Back to Top

URL tags

- The URLCmpnt tag is used to generate a URL to a site area or content item.

[URLCmpnt mode=" " context=" " type=" " name=" " pageDesign=" " portalTarget" " usedIn=" " start=" " end=" " htmlencode=" "]

mode=" " parameter:

  • *portal - *This generates a URL to a portal page. This is used when displaying web content within a web content viewer portlet
  • *standAlone - *This generates a URL to a web page. This is used when displaying web content using the Web Content Manager servlet.
  • *current - *This generates a URL based on the format of the current request. For example, if the current request is a WebSphere® Portal request, then mode="portal" is used.
    ----type=" " parameter*:** *Content - *Use this option to display the URL of the current content item.
  • *Parent - *Use this option to display the URL of the parent site area of the current content item
  • Top - Use this option to display the URL of the top site area in the current path of the current content item.
    ----context=" " parameter*:*
  • Selected - *Use this option to select a specific site area or content item. You must then add the name of the item being referenced using the name=" " parameter. You can select an item by clicking *Select.
  • *Current - *Use this option to retrieve the URL from the current site area or content item.
  • *AutoFill - *Use this option when the URL being retrieved is determined by the search parameters of a menu, navigator, or taxonomy component. If the tag is not used within a menu, navigator, or taxonomy component, the context will revert to the current item.

If you select Selected, click the Select button to select a specific site area or content item.
If you select Current or Autofill, click Select authoring template to select an appropriate authoring template.

If you want to render the content using an alternative presentation templates, click presentation template. This is added to the tag as the pageDesign=" " parameter.
Select Portal Page Target if you want to render the content on a specific Portal page. You can enter the compound name of the URL mapping or friendly URL of the target portal page in the tag after you add the tag to your design. This can only be used if mode="current" or mode="portal". This is added to the tag as the portalTarget=" " parameter.

Table 1. Additional tag parameters

Tag parameters Details
  name="./itemName"
   
   
   
Back to Top

Indenting element designs

- You use an indent tag to format element designs that require results to be indented.

[indentcmpnt repeat=" " offset=" " start=" " end=" " ]

Table 1. indent tag parameters

Tag parameter Description
repeat=" " Enter the text to repeat at the beginning of the indent.
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.

Example:

[indentcmpnt offset="0" repeat="&amp;nbsp;&amp;nbsp;"]
Back to Top
 
No Comments

Posted in Google Reader