Skip to main content

A ckan extension to showcase datasets in use

Project description


Showcase and link to datasets in use. Datasets used in an app, website or visualization, or featured in an article, report or blog post can be showcased within the CKAN website. Showcases can include an image, description, tags and external link. Showcases may contain several datasets, helping users discover related datasets being used together. Showcases can be discovered by searching and filtered by tag.

Site sysadmins can promote selected users to become ‘Showcase Admins’ to help create, populate and maintain showcases.

ckanext-showcase is intended to be a more powerful replacement for the ‘Related Item’ feature.


Compatible with CKAN 2.9.

N.B. The migrate command, detailed below, requires the Related Item models and actions, which have been removed in CKAN 2.6. If you wish to migrate your Related Items, please first upgrade CKAN to 2.5, do the migration, then continue upgrading to CKAN 2.6+.


To install ckanext-showcase:

  1. Activate your CKAN virtual environment, for example:

    . /usr/lib/ckan/default/bin/activate
  2. Install the ckanext-showcase Python package into your virtual environment:

    pip install ckanext-showcase
  3. Add showcase 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

Development Installation

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

git clone
cd ckanext-showcase
python develop
pip install -r dev-requirements.txt

The extension contains a custom build of CKEditor to allow using a WYSIWYG editor to write the content of the showcase. It has been built using webpack and the repository contains all the files needed to edit and customize it if needed:

npm install
npx webpack --config webpack.config.js

The webpack will use as entrypoint a file located in ckanext/showcase/fanstatic/src/ckeditor.js, create a build and save it to ckanext/showcase/fanstatic/dist/ckeditor.js

More info on how to build CKEditor from source:


All actions in the Showcase extension are available in the CKAN Action API.

Showcase actions:

- create a new showcase (sysadmins and showcase admins only)
curl -X POST -H "Authorization:{YOUR-API-KEY}" -d '{"name": "my-new-showcase"}'

- delete a showcase (sysadmins and showcase admins only)
curl -X POST -H "Authorization:{YOUR-API-KEY}" -d '{"name": "my-new-showcase"}'

- show a showcase
curl -X POST -d '{"id": "my-new-showcase"}'

- list showcases
curl -X POST -d ''

Dataset actions:

- add a dataset to a showcase (sysadmins and showcase admins only)
curl -X POST -H "Authorization:{YOUR-API-KEY}" -d '{"showcase_id": "my-showcase", "package_id": "my-package"}'

- remove a dataset from a showcase (sysadmins and showcase admins only)
curl -X POST -H "Authorization:{YOUR-API-KEY}" -d '{"showcase_id": "my-showcase", "package_id": "my-package"}'

- list datasets in a showcase
curl -X POST -d '{"showcase_id": "my-showcase"}'

- list showcases featuring a given dataset
curl -X POST -d '{"package_id": "my-package"}'

Showcase admin actions:

- add showcase admin (sysadmins only)
curl -X POST -H "Authorization:{YOUR-API-KEY}" -d '{"username": "bert"}'

- remove showcase admin (sysadmins only)
curl -X POST -H "Authorization:{YOUR-API-KEY}" -d '{"username": "bert"}'

- list showcase admins (sysadmins only)
curl -X POST -H "Authorization:{YOUR-API-KEY}" -d ''


The Showcase extension adds the following pages to the user interface:

  • The main showcase index is available on:
  • To create a new showcase:
  • To edit or delete a showcase:{showcase-name}
  • To add a Showcase Admin :


If you want to use the WYSIWYG editor instead of Markdown to write the content of the showcase:

ckanext.showcase.editor = ckeditor

Migrating Showcases Notes from Markdown to HTML

When using CKEditor as WYSIWYG editor showcases notes are stored in HTML instead of Markdown. To migrate all existing notes from markdown to HTML you can use the `showcase markdown_to_html` command.

From the ckanext-showcase directory:

paster showcase markdown-to-html -c {path to production.ini}

Running the Tests

To run the tests, do:

nosetests --ckan --nologcapture --with-pylons=test.ini

To run the tests and produce a coverage report, first make sure you have coverage installed in your virtualenv (pip install coverage) then run:

nosetests --ckan --nologcapture --with-pylons=test.ini --with-coverage --cover-package=ckanext.showcase --cover-inclusive --cover-erase --cover-tests

Registering ckanext-showcase on PyPI

ckanext-showcase should be availabe on PyPI as If that link doesn’t work, then you can register the project on PyPI for the first time by following these steps:

  1. Create a source distribution of the project:

    python sdist
  2. Register the project:

    python register
  3. Upload the source distribution to PyPI:

    python sdist upload
  4. Tag the first release of the project on GitHub with the version number from the file. For example if the version number in is 0.0.1 then do:

    git tag 0.0.1
    git push --tags

Releasing a New Version of ckanext-showcase

ckanext-showcase is availabe on PyPI as To publish a new version to PyPI follow these steps:

  1. Update the version number in the file. See PEP 440 for how to choose version numbers.

  2. Create a source distribution of the new version:

    python sdist
  3. Upload the source distribution to PyPI:

    python sdist upload
  4. Tag the new release of the project on GitHub with the version number from the file. For example if the version number in is 0.0.2 then do:

    git tag 0.0.2
    git push --tags


See: “Internationalizing strings in extensions” :

  1. Install babel

    pip install Babel

  2. Init Catalog for your language

    python init_catalog -l es

  3. Compile your language catalog ( You can force pybabel compile to compile messages marked as fuzzy with the -f)

    python compile_catalog -f -l es

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ckanext-showcase, version 1.4.8
Filename, size File type Python version Upload date Hashes
Filename, size ckanext-showcase-1.4.8.tar.gz (204.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page