Tag widget parameter reference | HCL Digital Experience
You configure specific tag widget instances by setting the JavaScript parameters that are listed here.
Note: The parameters listed here are specific to the inline tag widget that
was introduced with HCL Portal Version 8.5. For information about the earlier
widgets and their parameters, read the appropriate topics in the HCL Portal
Version 8.0 product documentation.
To set the parameters, proceed as follows:
- In HCL Web Content Manager, go to .
- Select the check box for HTML - Tagging Widget Light - Menu.
- Click Edit.
The following parameters are optional for the tag widget. They correspond to similar
parameters in the WP CP Configuration Service.
- countsEnabled = false
- Use this parameter to specify whether the count of each community tag is displayed.
The count shows how often the tag was applied by users. The default value is
false
. To show the count of each community tag, specifytrue
. The count is then displayed in parentheses. - customLabel
- Use this parameter to specify a non-localized custom label to describe the displayed tags. If you do not want any further labeling or if you want to keep the label short, you can specify an empty string.
- customLabelCommunityTags = = (false)
- Use this parameter to specify the non-localized label that you want to be used to
describe the meaning of the community tagging that is displayed. The default value is
false
. - customLabelPersonalPublicTags = (false)
- Use this parameter to specify the non-localized label that you want to be used to
describe the meaning of the personal public tagging that is displayed. The default
value is
false
. - customLabelPersonalPrivateTags = (false)
- Use this parameter to specify the non-localized label that you want to be used to
describe the meaning of the personal private tagging that is displayed. The default
value is
false
. - customMessageNoTags
- Use this parameter to specify a non-localized custom label that you want to be displayed if no tags are available. This case can occur when users did not assign tags to the piece of content yet. Non-localized means that the label does not change with the browser language. This parameter has no default value.
- maxResults = 5
- Use this parameter to specify the number of tags that are shown per resource. The
default value is
5
. - order = DESC|ASC
- Use this parameter to specify the order direction for displaying the tags. This
parameter is related to the parameter
orderMetric
. It can take the following values:- DESC
- This value is the default value. It specifies descending order. For example,
if the default
TAG_SPACE_COUNT_REVERSE_NAME
is specified for theorderMetric
parameter that is listed later, tags with the highest count and the lowest character in the alphabet are listed first. - ASC
- This value specifies ascending order. For example, if the order metric
parameter is specified as
orderMetric = TAG_SPACE_COUNT
, tags with the lowest count are listed first.
- orderMetric = TAG_SPACE_COUNT_REVERSE_NAME
- Use this parameter to specify the order metric for the order by which the tags are
displayed. To determine the actual order, use the parameter
order
that was listed earlier. The default value isTAG_SPACE_COUNT_REVERSE_NAME
. This default value means that tags are shown first by the tag count, with resources with more tags shown before resources with fewer tags, then, if resources have the same number of tags, alphabetically. This parameter can take the following values:TAG_SPACE_NAME
TAG_SPACE_COUNT
TAG_SPACE_COUNT_NAME
TAG_SPACE_COUNT_REVERSE_NAME
. This value is the default value.TAG_SPACE_CREATION_DATE
TAG_SPACE_LAST_MODIFIED_DATE
com.ibm.portal.cp.Constants.OrderMetric
in the HCL Digital Experience Javadoc. - privateTaggingEnabled = (false)
- Use this parameter to specify the
PERSONAL_PRIVATE
scope for the tags that you want to show in this widget. The default value isfalse
. By this default, users cannot add private tags. If you set this parameter totrue
, users can also add private tags. - resourceCategories = ["resrc_category_1", "resrc_category_2", . . . "resrc_category_n"]
- Use this parameter to specify an array of categories that are assigned to the
resource for which the widget was called. Represent each category by a string, for
example
Books
or a Web Content Manager category. A typical value is["books", "action"]
. - resourcePrivate = true|false
- You can set this parameter to avoid access control issues with private resources.
Users can add private tags only to private resources. The default value is
false
. - resourceType
- Use this parameter to specify the portal resource type. Specify either
CONTENT_NODE
orNAVIGATION_NODE
. Specifying a value for this parameter is mandatory for portal resources only. - tagClickActionMode = TAG_CENTER|PUBLIC_RENDER_PARAMETER
- Use this parameter to determine what happens when a user clicks a tag. Specify one
of the following values:
- TAG_CENTER
- With this value, the widget redirects the user to the tag center. This value is the default value.
- PUBLIC_RENDER_PARAMETER
- With this value, the widget exposes a public render parameter with the tag name.
- tagClickTransmitScopes = (false)
- Use this parameter to specify whether scopes to which a tag belongs, for example
categories, are transmitted, when a user clicks a tag. Setting this parameter set to
true
makes sense only if you also set the parametercom.ibm.wps.cp.tagging.inline.tagsClickable
totrue
. - tagsClickable = true|false
- Use this parameter to determine whether the tags can be clicked for redirection or
public render parameter exposure. The default is
true
. - tagScope = (COMMUNITY_PERSONAL_PUBLIC)
- Use this parameter to specify the scope of tags that you want to show in this
widget. Specify one of the following values:
If you do not specify a value, the parameter defaults toPERSONAL_PUBLIC|PERSONAL_PRIVATE|COMMUNITY_PERSONAL_PUBLIC
COMMUNITY_PERSONAL_PUBLIC
.