This is a simple rating extension for CKAN datasets (packages) and showcases. The extension adds a list of clickable stars to the side navigation in the dataset and showcacse templates similar to ckanext-qa. In showcase the stars are also displayed in the showcase listing, but are not clickable.

The stars can also be added to any desired view by adding the following code to the desired template:

{% snippet "rating/snippets/stars.html", package=<YOUR_PACKAGE> %}

The amount of ratings submitted can also be displayed with:

{{h.package_rating(None, {'package_id' : <YOUR_PACKAGE>.id} ).ratings_count}}

Rating is identified with client IP if the user is not authenticated. User ID is saved with the rating when authenticated.

This extension works with CKAN version 2.5 or later.

To install ckanext-rating:

1. Activate your CKAN virtual environment, for example:

   . /usr/lib/ckan/default/bin/activate

2. Install the ckanext-rating Python package into your virtual environment::

   pip install -e git+https://github.com/6aika/ckanext-rating.git#egg=ckanext-rating

3. Add rating to the ckan.plugins setting in your CKAN config file (by default the config file is located at /etc/ckan/default/production.ini).

4. Restart CKAN. For example if you've deployed CKAN with Apache on Ubuntu:

   sudo service apache2 reload

5. Initialize database tables used by Rating:

   ON CKAN >= 2.9:
   
   ckan --config=production.ini rating init
   
   ON CKAN < 2.8:
   
   paster --plugin=ckanext-rating rating init --config=production.ini

6. If you want to use this extension for ckanext-showcase, install it into your environment by following the instructions at https://github.com/ckan/ckanext-showcase

Rating is enabled or disabled for unauthenticated users:

rating.enabled_for_unauthenticated_users = true or false

Optional:

# List of dataset types for which the rating will be shown (defaults to ['dataset'])
ckanext.rating.enabled_dataset_types

To install ckanext-rating for development, activate your CKAN virtualenv and do:

git clone https://github.com/6aika/ckanext-rating.git
cd ckanext-rating
python setup.py develop
pip install -r dev-requirements.txt