Tag widget parameter reference
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 Digital Experience (DX) Version 8.5. For information about the earlier widgets and their parameters, read the appropriate topics in the HCL DX Version 8.0 product documentation.
To set the parameters, proceed as follows:
- In HCL Web Content Manager, go to Web Content > Authoring > Libraries > Web Resources v70 > Components.
- 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
For more information, see the classcom.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:
PERSONAL_PUBLIC|PERSONAL_PRIVATE|COMMUNITY_PERSONAL_PUBLIC
If you do not specify a value, the parameter defaults to
COMMUNITY_PERSONAL_PUBLIC
.