Ratings Application

Last modified by Admin on 2017/10/16 00:04

starRate Wiki pages, and browse them by average ratings
TypeXAR
Developed by

XWiki Development Team

Active Installs230
Rating
Rate!
1 Votes
LicenseGNU Lesser General Public License 2.1
Installable with the Extension Manager

Description

This app allows users to rate Wiki pages.

Starting with XWiki 6.4, this extension's sources have been integrated into a module of the XWiki Platform. Thus the jump in the version number.

Screenshots

Rating stars displayed in XWiki pages.
RatingsApplication.png

Rating stars dispalyed in Extension Manager.
stars.png

UI Extension point

The javascript that injected the ratings html after the breadcrumb (id="hierarchy") has been replaced by a UI Extension Point.
This change has the advantage that it allows ratings to be displayed in the flamingo skin.
The problem with the old approach was that in flamingo there is no html element with the id "hierarchy".

Ratings are disabled by default

By default, the ratings are disabled.
You can activate them either globally or at space level.
Please see below how to do that.

New configuration source

As opposed to the older versions, since 6.4 the ratings configuration can now be done via XWiki objects.
This means that it is possible to configure the application on a space basis.

The main configuration source is located at XWiki.RatingsConfig. From the XWiki.RatingsConfig page select Edit > Objects and set the "Display ratings" to Yes, then Save & View.

Ratings.jpg

In order to have separate configurations for each space you need to attach a XWiki.RatingsConfigClass object to the WebPreferences document of that space. Unfortunately, at the moment there is no UI for editing the configuration so it has to be done by editing the objects manually.

A important thing to note is that a fallback to xwiki.[cfg|preferences] has been kept.

The precedence order is as follows:

  1. *.WebPreferences
  2. XWiki.RatingsConfig
  3. xwiki.cfg
  4. xwiki.preferences

XWiki.RatingsConfigClass

PropertyDescriptionValuesDefault
displayRatingsDisplay the ratings or notbooleantrue
excludedPagesPages on which ratings should not be displayedcomma separated list of documents-
managerHintThe ratings manager to use. This defines where the ratings are storeddefault=same page,separate=different spacedefault
storageSpaceIn case of using the separate ratings manager, specify in which space to save the rating informationspace name-
storageSeparateSpacesStore the ratings for each space individually (only takes effect at global level, on space level use storageSpace)booleanfalse
storeAverageRatingStore the average rating in an object or keep it in memorybooleanfalse
reputationCalculate the user's reputationbooleanfalse
reputationStoredStore the user reputation in an object or keep it in memorybooleanfalse
reputationMethodName of the methods used for calculating a user's reputationcomma separated list of values-
reputationAlgorithmThe algorithm used to calculate the reputationdefault,simple,customdefault
reputationCustomAlgorithmWhen the reputationAlgorithm property is set to "custom" a reference to the algorithm must be providedDocument containing the groovy script-

Tested on

This extension has been tested with the following configurations.

Extension VersionXWiki FlavorNotes
1.0XWiki Enterprise 2.2+

Compatible with toucan and XWiki 2.2+ using plugin API

1.2XWiki Enterprise 2.2+

Compatible with colibri and toucan and XWiki 2.2+ using plugin API

1.3XWiki Enterprise 4.1+

Compatible with colibri and XWiki 4.1+ using component API

1.3.1XWiki Enterprise 6.0.1

Warning message when installing the app with EM

1.3.1XWiki Enterprise 6.2.4
7.1.3XWiki Enterprise 7.1.3

Prerequisites & Installation Instructions

  • For 1.3+
    • Install using Extension Manager
  • For 1.1. and 1.2 only
    • This application relies on the Ratings Plugin. Please make sure you have successfully installed this plugin first.
    • Add XWiki.RatingsTranslations as an internationalization document bundle
    • Visit the Ratings section of the administration UI to activate or deactivate ratings

Release Notes

v6.4

Starting with 6.4 the release notes are now part of the XWiki Enterprise Release Notes.

v1.3.4

v1.3.3

  • Closed XARATINGS-12 The class initializer does not mark the documents as hidden

v1.3.2

  • Closed XARATINGS-7 RatingsClass and AverageRatingsClass get a new version everytime the wiki starts
  • Closed XARATINGS-5 Mark page "XWiki/RatingsMacros" as hidden

v1.3

  • Installs automatically using Extension Manager
  • Tested with XWiki 4.5

Dependencies

Dependencies for this extension (org.xwiki.platform:xwiki-platform-ratings-ui 9.8.1):

Tags: ratings social
Created by Jerome on 2010/12/09 19:52
    

Get Connected