Repository is archived
No commit activity in last 3 years
No release in over 3 years
Europeana REST API adapter for Blacklight
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.8
~> 10.0
~> 1.21

Runtime

~> 6.0.0
>= 1.0, < 2.0
~> 0.2.5
>= 1.0.0, < 2
>= 4.2.2, < 5
 Project Readme

Europeana::Blacklight

Build Status Security Maintainability Test Coverage

Ruby gem providing an adapter to use the Europeana REST API as a data source for Blacklight.

Usage

See the Quick Start Guide.

Features

Supported Blacklight features

  • Search
  • View record
  • Pagination of search results
  • Field facets
  • Query facets
  • Facet limits
  • Fielded search
  • Bookmarks
  • Range queries

Unsupported Blacklight features

  • Result sorting :(
  • "Did you mean" spellcheck
  • MLT Solr-style (but see custom features)

Custom features

  • Nested EDM field names
  • MLT by record ID in :mlt URL parameter
  • Query facets with arbitrary API parameters

Query facets

In the configuration for query facet fields, the :fq option is a Hash, to permit specification of multiple parameters to be passed to the API:

configure_blacklight do |config|
  config.add_facet_field 'Cities (reusable content)', query: {
    paris: { label: 'Paris', fq: { qf: 'paris', reusability: 'open' } },
    berlin: { label: 'Berlin', fq: { qf: 'berlin', reusability: 'open' } }
  }
end

Warning: query facets are achieved by sending additional queries to the API. If you configure 2 query facets each with 10 facet values, this will result in an additional 20 queries being sent to the API.

License

Licensed under the EUPL v1.2.

For full details, see LICENSE.md.