Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The add-on enables you to define your own rating criterias. You will find the configuration within Confluence Administration area at "Configuration" → "Content Rating" or by clicking the “Configure” buttom from the plugin manager.

Criteria

In “Criteria” tab you will find all existing rating criterias (Default criterias are Perspicuity, Significance, Structure).

Image RemovedImage Added

Edit

Here you can edit every aspect of the rating criterion. Press “Edit” from the list view and fill in the fields:

...

OptionDescription
NameRecommended is a noun. This is the only mandatory field.
Description

...

Tell users something about the meaning of this criterion.
Order

...

Sorting of criteria order numbers is ascending.

...

StatusYou can disable and enable criteria.
Icon

...

You can define an optional Font Awesome icon for your criterion. 
Info

Be careful renaming a criterion, as this may alter the original intention of existing user ratings.

Delete

Press “Delete” from the list view and confirm the deletion.

Info

Deleting a criterion also criterion also deletes all ratings and feedbacks ( when feedback management is configured) for this criterion. Consider disabling it.

...

Add Criterion

For adding a criterion just switch to the “Add Criterion” tab and fill in the fields:

OptionDescription
Name

...

Recommended is a noun. This is the only mandatory field.
Description

...

Tell users something about the meaning of this criterion.
Order

...

Sorting of criteria order numbers is ascending.
Status

...

You can disable and enable criteria.
Icon

...

You can define an optional Font Awesome icon for your criterion. 


Settings

Modifiy Modify global settings of rating addon in “Settings” tab.

...

  • Title
  • Content
  • Custom → Define custom selector to insert rating box

...

SettingDescription
Insertion

With insertion, you can configure, where the criteria are shown at the frontend. 

  • Title: criteria will be shown near the title of the page
  • Content: criteria will be shown near/within the content
  • Custom: you can define a custom CSS selector (target selector) for showing the criteria
Insertion Placement

Insert the criteria and therefor set the position within the above selected method.

  • Before
  • After
  • Append
  • Prepend
Insertion Style

...

You can add additional CSS which will be added to the main criteria container as "style" attribute.

Mode

Choose one of the following modes

  • Toggle (default)
  • Toggle Small (unobtrusive design)
  • Knob (wheels for more specific ratings)

...

MultipleCheck if multiple criteria be selected.

Anonymous Rating for internal users

Check if you want that Confluence user ratings should be anonymous.
HeadlineAdd a headline to the rating criteria  (Optional: If field is empty no headline will be shown.)
Hide UsersCheck to hide users in rating result dialog.

Hide Result

...

Check to tide rating result

...

for users without content rating.
Replace Like

...

Select the criterion, which will replace the original like button.

Info

The Confluence like button will be hidden and ratings on the criterion will be stored as like

...

as criterion rating. The criterion will also be hidden for an anonymous user.


Restriction

SettingDescription
Content Type

...

Check content type to enable content rating for.

  • Page
  • BlogPost
Space

...

  • Choose space restriction exclude or include to hide or show content rating in defined space keys.
  • Define comma seperated list of space keys to restrict.
  • Use comfortable autocomplete space search field to get and add correct key.
Individual Content

...

Add “Disable Content Rating” macro to disable the content rating individually.

...

Statistics

...

Access

SettingDescription
Anonymous User

Configure if anonymous user should have not access, can view or can view and rate in rating criteria area.

  • None (default): No anonymous access of content rating for all contents
  • View: View ratings of all anonymous permitted contents
  • View and Rate: View and rate of all anonymous permitted contents

Report

SettingDescription
User Groups

Define comma separated list of user groups with access to Content Rating Statistic. Default only system admins have access.

...

Reset

...

Statistic

SettingDescription
Authors

Check if user with edit permissions can reset statistic of single content.

Space Admin

...

Check if user with space admin permissions can reset statistic of space content.

...

User GroupsCheck if users who belong to the set user groups of the report can reset statistic. Default only system admins can reset statistics.
Remove all likes

...

All likes will be removed when resetting statistic (This works only when "Replace Like" option has selected criterion).

...

Access

...

Automated on updateSelect criteria for automated reset in statistics when content type was updated.
Export SeparatorComma separator for csv export of statistics. 
Anonymous LikeEnable anonymous likes for selected replace like criterion.
Anonymous Session ExpirationDefine expiration time of cookie for anonymous user like.

JIRA Issue Collector

You can use a JIRA issue collector to gather more feedback from your users.

...