/islandora_solr_search

Islandora Solr Search module

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

Islandora Solr Build Status

Introduction

Islandora Solr provides a highly configurable interface to perform Solr queries and display Solr data in different ways.

Requirements

This module requires the following modules/libraries:

Installation

Install as usual, see this for further information.

Configuration

Set the 'Solr URL' and select a 'Request handler' in Administration » Islandora » Solr Index (admin/islandora/search/islandora_solr).

Configuration

Islandora Solr offers many more configuration options in Administration » Islandora » Solr Index » Solr settings (admin/islandora/search/islandora_solr/settings). These settings are explained in detail on the Solr Settings page on the wiki.

Configuration of the labels attached to the Islandora Simple Search can be done via the block's configuration settings.

Islandora Solr also implements the query backend that allows the Islandora Basic Collection solution pack to drive the collection display using Solr instead of SPARQL/Fedora. This functionality can be applied on the collection solution pack's configuration page (admin/islandora/solution_pack_config/basic_collection), and that same page provides settings for sorting the Solr collection view globally and per-collection. The query backend relies on the relationship fields in the "Required Solr Fields" section of the Solr settings; the fields in that section should be confirmed before using Solr to drive the display.

Breadcrumbs

To enable breadcrumbs, browse to Administration » Islandora » Configuration and choose Islandora Solr under Breadcrumb generation. Configuration

Documentation

Further documentation for this module is available at our wiki.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

FAQ

Q. Why are some dates not rendered correctly?

A. On 32 bit systems, the PHP function strtotime() has a limited range. Typically from Fri, 13 Dec 1901 20:45:54 UTC to Tue, 19 Jan 2038 03:14:07 UTC. For more info see the notes for strtotime().

Q: Why can't I connect to Solr via https?

A: The Apache Solr PHP Client that we use does not support https connections to Solr. ISLANDORA-646 documents this issue, but it will not be fixed.

Q: Advanced search on PID worked in 6.x. Why do I get no results for the same search in 7.x?

A: In 7.x the colon in a PID must be escaped with a backslash (i.e., islandora:34 becomes islandora:34) or the entire query must be wrapped in quotation marks (i,e., "islandora:34").

Q. Can I use Solr search results when setting up 'Page specific visibility settings' for blocks?

A. Due to URL escape characters in Solr searches, Drupal does not respect 'Page specific visibility settings' for blocks. You will have to manually un-escape the URL when configuring where your blocks are placed. This example (which involves patching Drupal core) may help.

Maintainers/Sponsors

Current maintainers:

Development

If you would like to contribute to this module, please check out CONTRIBUTING.md. In addition, we have helpful Documentation for Developers info, as well as our Developers section on the Islandora.ca site.

License

GPLv3