Extension Citation Helper


Extension Basics

Title
Citation Helper
Name
ckanext-citehelp
Type
Public extension
Description
Helps people cite CKAN datasets correctly by providing ready-to-use attribution texts for datasets and resources.
CKAN versions
Download-Url (zip)
Download-Url commit date
2025-06-12
Url to repo
Category
Content Management


Background Infos

Description (long)
Show details

ckanext-citehelp

A CKAN extension that helps people cite your datasets correctly

Overview

Many licenses used for open data require some kind of attribution when the data is used. However, users often don’t know how exactly that should be done.

This extension gives users ready-to-use attribution texts that they can simply copy and paste. The texts are automatically adapted to the dataset, its license and the publishing organization.

Attribution Text

This is the default attribution text, shown on dataset and resource pages:

Dataset "Awesome Weather Data", Funky Weather Team (https://funky-weather.org).
Published under the license "Great Weather License" (https://weather-license.com).
See https://my-ckan-instance.com/dataset/65571194-1b1a-4ce1-b169-15942647208c.

In addition to the plain text, a HTML variant is shown which uses links instead of listing the URLs verbatim.

Key Features

  • Automatic Attribution Generation: Creates ready-to-use citation texts for datasets and resources
  • License Integration: Automatically includes license information in citations
  • Organization Support: Includes publishing organization details with customizable URLs
  • Multiple Formats: Provides both plain text and HTML formatted citations
  • Template Customization: Easy to customize through template overrides
  • Translation Support: Fully translatable using CKAN’s translation infrastructure
  • Dataset Adaptation: Automatically adapts citation text to current dataset, license, and organization
  • Custom Organization URLs: Organizations can provide custom URLs via extras field

Customization

There are multiple ways to customize the attribution text:

  1. Template Override: Override blocks in ckanext-citehelp/snippets/citehelp.html, particularly citehelp_template_text and citehelp_template_html
  2. Custom Translations: Provide custom translations using CKAN’s translation infrastructure

Both plain text and HTML text are marked as translatable and can be customized per language.

Technical Details

  • The dataset title, organization name/URL, license title/URL are automatically adapted
  • Organizations can provide custom URLs in an extra field named url
  • Falls back to CKAN organization page if no custom URL is provided
  • Integrates seamlessly with CKAN’s template system

License

Copyright © 2025 Stadt Karlsruhe. Distributed under the GNU Affero General Public License (AGPL-3.0).

Version
0.0.1
Version release date
2025-06-12
Contact name
Ondics GmbH
Contakt email
Contact Url
(not set)


Installation Guide

Configuration hints

Add citehelp to your CKAN plugins list. The extension adds citation help text to dataset and resource pages automatically. Templates can be customized by overriding ckanext-citehelp/snippets/citehelp.html. Organizations can provide custom URLs via extras field named ‘url’.

Plugins to configure (ckan.ini)
citehelp
CKAN Settings (ckan.ini)
# No additional CKAN configuration settings required # The extension works out of the box once the plugin is activated # # Optional: Organizations can provide custom URLs via extras # This is configured per organization in the CKAN web interface # Extra field name: url # Extra field value: https://your-organization-website.com
DB migration to be executed
(not set)
<< back to Extensions