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:
- Template Override: Override blocks in
ckanext-citehelp/snippets/citehelp.html
, particularly citehelp_template_text
and citehelp_template_html
- 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).