Using the Content rating web part

You can add the Content rating web part to any web part zone on any page of your website, thus enabling users to rate the content of the currently displayed page. The web part has three default appearance modes:

StarsRadio-buttonsDrop-down list

Web part properties

The table lists specific properties of the web part:

Property nameDescription

Rating value

Sets the displayed rating value explicitly. A value from the <0,1> interval can be used, while 0 represents the lowest rating and 1 represents the highest rating on the scale defined by the Max rating value property. If blank, the system displays the real rating calculated as an average value of particular ratings.
Rating typeSpecifies the appearance of the web part. You can choose from Stars, Radio-buttons or Drop-down list.
Max rating valueSpecifies the size of the rating scale. For example, if 7 is entered, rating is possible on a scale from 1 to 7.
Show resultsIf selected, the system displays overall rating results. Otherwise (removed checkmark), users can rate but cannot see the results.
Result messageAllows you to specify a message showing overall rating results. The {0} macro displays overall rating (for one decimal rounding, you can use {0:0.#} ). The {1} macro displays the total number of votes.
Check permissionsIf selected, the system checks permissions set by the Allow for public and Hide to unauthorized roles properties.
Allow zero valueIf selected, users can submit ratings with zero value (no rating value selected).
Error messageAllows you to specify a message displayed to users who try to submit a rating with zero value. Applied only if the Allow zero value option is disabled.
Anonymous users can rateIf selected, rating is allowed to public unauthorized users. Otherwise (removed checkmark), only authenticated users can rate.
Check if user ratedIf selected, users can vote only once. To indicate that the user already voted, the system stores a DocRated cookie in the web browser. The cookie contains NodeIDs of the rated pages, separated by the pipe character (e.g. |4|61|229|230|228|369|).
Hide to unauthorized usersIf selected, the web part is hidden to unauthorized users.
Message after ratingAllows you to specify a text message displayed after a user submits their rating. Macros that can be used: {0} your rating, {1} overall rating, {2} overall number of votes.

                    

Example: Adding news ratings

You can place the Content rating web part on any page of your website to enable users to rate the content of this particular page. In the following example, you will add the web part to news items on the sample Corporate site. You can achieve a similar result also with transformations, as described in Displaying content rating in transformations.

  1. Open the Pages application, switch to the Design mode and select News in the content tree.
  2. Add the Content rating web part to the Main zone.
  3. In the web part properties dialog, configure the following property:
    • Show for page types: cms.news; this ensures that the system displays the web part only for the particular news items, and not for the list of news on the title page of the News section.

Now go to the live site and view the New Consulting Services news item. You can see the web part as in the screenshot below. Try rating the page.

Rating a page
To view the overall rating, open the Pages application and view Properties of the news item. The Rating property on the General tab reflects the current rating of the selected page. Here, all ratings are recalculated to a 10-step scale and displayed as stars, regardless of the current configuration of the web part.


Was this page helpful?