Confluence

Default Statitics

Add a rating panel to your content as follows:

{rate}

Then display statistics for that rating panel as follows:

{rate-table}

The macro will output a table showing how many votes have been cast for each rating level and the overall value of the rating:

The 255 value in the first column is the automatically assigned "key" for the rating, defaulting to the database ID for the content in which you placed the rating panel. If you want a more descriptive key, see Example #3.

Pie Chart Visualisation

To display a pie chart of the vote distribution, disable the "overall rating" column and wrap the macro inside the chart macro as follows:

{chart:legend=false}{rate-table:overall=false}{chart}

A pie chart will be shown as follows:

Don't add any new lines between the chart and rate-table macro tags otherwise the chart will not display.

Using Keys

If you don't specify a key for your rating, the internal database ID of the content will be used. In order to get something a bit more friendly, especially if you are using multiple rate macros on the same page, specify the key for each rating panel as shown in the following example:

{rate:key=Readability}
{rate:key=Usability}

To display results for just one of these rating panels, specify it's unique key:

{rate-table:keys=Readability}

Which results in:

To include multiple ratings in the table, include their keys separated by commas as shown below:

{rate-table:keys=Readability,Usability}

Which results in:

You can generate a nice summary chart as shown below:

{chart:type=bar|width=600|stacked=true}{rate-table:keys=Readability,Usability|overall=false}
{chart}

Which displays:

Don't add any new lines between the chart and rate-table macro tags otherwise the chart will not display.

Summary Graph

If you've got several ratings on a page, you can display a summary graph using the following:

{chart:dataOrientation=vertical|type=bar|legend=false|orientation=horizontal|height=50}
{rate-table:keys=Readability,Usability|breakdown=false}{chart}

Resulting in:

Increase the height of the chart by 25 for each rating included. For example, if you have 3 ratings to compare, the height would be 25*3 = 75.

Don't add any new lines between the chart and rate-table macro tags otherwise the chart will not display.

Remote Statistics

Normally, the {rate-table} macro is added to the same content that contains the rate macro. However, there may be scenarios where you want to display rating statistics on a different page or location to where they were obtained. For example, you might have a summary page showing rating statistics from several different pages.

To pull rating data from a different location, use the following:

{rate-table:ceo=1234}

Where 1234 is the ID of the content that contains the rating data.

So how do you get that ID? Well, the easiest way is to add a rate-table macro to the content containing the ratings panels. As shown in Example #1, the ID will be shown in the first column - that's the ID to use in the rate-table macro when pulling statistics from ratings on a different page.