Rating widget parameter reference
You configure rating widget instances by setting the JavaScript parameters listed here.
Note: The parameters listed here are specific to the inline rating widget that was introduced with HCL WebSphere Portal v8.5. For information about the earlier widgets and their parameters, read the appropriate topics in the HCL Portal v8.0 product documentation. To set the parameters, proceed as follows:
- In HCL Web Content Manager, go to Applications > Content > WCM Authoring > Libraries > Web Resources v70 > Components.
- Select the check box for HTML - Rating Widget Light - Stars.
- Click Edit.
Mandatory parameters
The following parameters are mandatory for the rating widget.
- id = unique_ID
- Use this attribute to specify a unique ID for parsing all surrounding <div> tags to enable your widgets
- resourceID
- Use this parameter to specify the identifier of the piece of content that will show the widget. This needs to be unique. For example, for a portal page specify the portal object ID of that page.
Optional parameters
The following parameters are optional for the rating widget. They correspond to similar parameters in the WP CP Configuration Service.
If you do not specify a value, the parameter defaults to COMMUNITY_PERSONAL_PUBLIC.
- customLabel
- Use this parameter to specify a non-localized custom label to describe the displayed ratings.
- customLabelCommunityRatings
- Use this parameter to specify the non-localized label that we want to be used to describe the meaning of the community rating that is displayed.
- customLabelPersonalPublicRatings
- Use this parameter to specify the non-localized label that we want to be used to describe the meaning of the personal public rating that is displayed.
- customLabelPersonalPrivateRatings
- Use this parameter to specify the non-localized label that we want to be used to describe the meaning of the personal private rating that is displayed.
- deletingEnabled = (true)
- Use this parameter to control whether the Delete Rating option is enabled in the inline widget. The default value is true.
- nonCSSuiEnabled
- Set this parameter to the value true for to enable rendering on a user interface that is accessible for iOS devices used with a bluetooth keyboard. The default value is false.
- numStars = 5
- Use this parameter to specify the number of stars or asterisks of which a rating consists. Specify a positive numeric value. The default value is 5. Do not specify a value larger than the value specified for the property com.ibm.wps.cp.rating.maxratingvalue in the WP CP configuration service for tagging and rating. For more information about this property, read General properties for tagging and rating.
- privateRatingEnabled = (false)
- The default value of this parameter is false. By this default, users cannot add private ratings. For users to be able to add private ratings, set this parameter to true.
- ratingDescription=NONE
- Use this parameter to specify the type of description for community average ratings in the rating widget. Specify one of the following values:
If we do not specify a value, the parameter defaults to NONE.
- RATING_VALUE
- With this value, the rating description includes only the numerical rating value.
- TOTAL_NO_RATING
- With this value, the rating description includes only the total number of ratings.
- ALL
- With this value, the rating description includes the numerical rating value and the total number of ratings.
- NONE
- With this value, the rating description is not shown. This is the default value.
- ratingScope = (COMMUNITY_PERSONAL_PUBLIC)
- Use this parameter to specify the scope of ratings that we want to show in this widget. Specify one of the following values:
PERSONAL_PUBLIC|PERSONAL_PRIVATE|COMMUNITY_PERSONAL_PUBLIC
resourceCategories = ["resrc_category_1", "resrc_category_2", . . . "resrc_category_n"]
Use this parameter to specify an array of categories 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
We can set this parameter to avoid access control issues with private resources. Users can add private ratings only to private resources. The default value is false.
resourceType = NAVIGATION_NODE | CONTENT_NODE
Use this parameter to specify the type of the resource for which the rating widget is called. This parameter is mandatory only for portal resources such as pages or portlets. Valid values are NAVIGATION_NODE or CONTENT_NODE.
Parent topic: Parameter reference for the tag and rating widgets
References: