ckanext-gallery
![Docs](https://img.shields.io/readthedocs/ckanext-gallery?style=flat-square)
A CKAN extension for a dataset gallery view.
Overview
Adds a gallery view for resources on a CKAN instance. Three plugins are included in this extension: the main plugin (gallery
) and two view plugins for specific image/data types (gallery_image
and gallery_iiif
).
Based on blueimp Gallery.
Installation
Path variables used below:
$INSTALL_FOLDER
(i.e. where CKAN is installed), e.g. /usr/lib/ckan/default
$CONFIG_FILE
, e.g. /etc/ckan/default/development.ini
Installing from PyPI
pip install ckanext-gallery
Installing from source
-
Clone the repository into the src
folder:
cd $INSTALL_FOLDER/src
git clone https://github.com/NaturalHistoryMuseum/ckanext-gallery.git
-
Activate the virtual env:
. $INSTALL_FOLDER/bin/activate
-
Install via pip:
pip install $INSTALL_FOLDER/src/ckanext-gallery
Installing in editable mode
Installing from a pyproject.toml
in editable mode (i.e. pip install -e
) requires setuptools>=64
; however, CKAN 2.9 requires setuptools==44.1.0
. See our CKAN fork for a version of v2.9 that uses an updated setuptools if this functionality is something you need.
Post-install setup
-
Add 'gallery' to the list of plugins in your $CONFIG_FILE
:
ckan.plugins = ... gallery
-
Install lessc
globally:
npm install -g "less@~4.1"
Configuration
There's only one option that can be specified in the .ini
file:
Name | Description | Default |
---|
ckanext.gallery.records_per_page | Number of images to display on a page | 32 |
Usage
To use as a view, no further setup is needed; the 'Gallery' type should be available for resources
after installing the plugin.
Interfaces
The IGalleryImage
interface allows plugins to override settings.
from ckan.plugins import SingletonPlugin, implements
from ckanext.gallery.plugins.interfaces import IGalleryImage
class YourPlugin(SingletonPlugin):
implements(IGalleryImage)
def image_info(self):
'''
Return info for this plugin. If resource type is set,
only datasets of that type will be available.
'''
return {u'title': u'Text',
u'resource_type': [u'csv', u'tsv'],
u'field_type': [u'text']}
def get_images(self, field_value, record, data_dict):
'''
Process images from a single record to return custom metadata.
The field_value depends on the image field you choose.
'''
images = [{
u'href': field_value[u'url'],
u'thumbnail': field_value[u'url'].replace(u'preview', u'thumbnail'),
u'record_id': record[u'_id']
} for img in field_value]
return image
Templates
Gallery block snippet
{% snippet 'gallery/snippets/gallery.html', images=g.images, resource_id=res.id %}
Testing
There is a Docker compose configuration available in this repository to make it easier to run tests. The ckan image uses the Dockerfile in the docker/
folder.
To run the tests against ckan 2.9.x on Python3:
-
Build the required images:
docker compose build
-
Then run the tests.
The root of the repository is mounted into the ckan container as a volume by the Docker compose
configuration, so you should only need to rebuild the ckan image if you change the extension's
dependencies.
docker compose run ckan