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 IBM® WebSphere® Portal Version 8.5. For
information about the earlier widgets and their parameters, read the
appropriate topics in the WebSphere Portal Version 8.0 product
documentation.
To set the parameters, proceed
as follows:
- In IBM Web Content Manager, go to .
- 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.
- 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 you 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 you 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 you 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:
- 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 you want
to show in this widget. Specify one of the following values:
If you do not specify a value, the parameter defaults to COMMUNITY_PERSONAL_PUBLIC.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
- You 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.