Features

• Move analytics rendering from footer into head (#2761)

Improvements

• Symbolize our strings used in paths (#2754)
• Guard against the bulk updates visibility column not appearing in the spreadsheet (#2758)
• Cache the search#count value (#2759)
• A11y improvements (#2764)

Bug Fixes

• Allow as_json to accept arguments (#2756)
• Update install generator to use the destination_root to support generating a new app with the template (#2763)
• ReindexExhibitJob#perform: fix when object count is 0 (#2760)
• Explicitly re-enable p tags for text all of our custom blocks (#2765)

Thanks

• @camillevilla
• @cbeer
• @dunn
• @mjgiarlo

Features

• Blacklight 7 support
• Bootstrap 4
• Rails 6.1 support
• New Arabic, Brazilian Portuguese, and Spanish translations, and improved RTL display
• Accessibility improvements
• Support bulk updates and bulk actions for adding/removing tags and public/private visibility to many exhibit items at once
• New exhibit item indexing ETL framework, and other indexing improvements to provide better performance and visibility into the indexing background jobs for the exhibit builders
• New browse groups for organizing long lists of browse categories

Improvements

• Include the site title in feedback emails (#2282)
• Use the :long date format consistently (to include the year) (#2355)
• Allow the engine configuration to limit which themes are available for a given exhibit (#2372)
• Updated Exhibit cards on home page (#2481)
• Improve rendering of browse categories, saved searches, and pages widgets (#2571)
• Removes the require.js / almond.js conversion of ES6 JavaScript from amd to umd modules #2599
• Improved OpenSeadragon ("ZPR") viewer styling
• Add a query facet for public items
• More granular exhibit export configuration for configuring what parts of an exhibit should be included in an export

Bug Fixes

• Fix an issue with the analytics component and multiple analytics profiles (#2312)
• Address a race condition when updating sidecar data (#2316 + #2320)
• Have feedback emails come addressed from the service, not the feedback submitter (#2301)
• Fix a navigation issue using the search result widget (#2347)
• Fix an issue with empty custom field data being indexed as an empty string (instead of removing the data from Solr) (#2356)
• Follow HTTP redirects when retrieving IIIF resources
• Reserve page + exhibit slugs that conflict with application routing
• Image uploads should be associated with an exhibit

Upgrading

In this major release, Spotlight 3 has updated its upstream dependencies to support the latest releases of Rails, Blacklight and Bootstrap. As such, it's important to review those upgrade guides and address deprecation warnings from your application either before or as part of upgrading to Spotlight 3.

1. Review the Blacklight 7 upgrade guide
2. Review the Bootstrap 3 to 4 migration guide for any local customizations
3. Convert any local custom JavaScript from using require.js syntax to the umd version. See #2599

Additionally, there are some changes you need to make to your application to support new features or configurations in Spotlight 3:

4. Add the SirTrevor initializer to your application
5. Update local indexing code to use the new ETL framework (see below)
6. Update your SearchBuilder to replace Spotlight::AccessControlsEnforcementSearchBuilder with Spotlight::SearchBuilder
7. Install + run the new spotlight migrations: rake spotlight:install:migrations && rake db:migrate

ETL

Spotlight::SolrDocumentBuilder has been removed in Spotlight 3, and your Resource model is now responsible for all steps in the indexing process. Spotlight now provides an indexing pipeline framework to make it relatively easy to build your indexing rules into the resource.

Each resource class has indexing_pipeline method that defines the ETL steps for creating solr documents from your resource instance. In your local resource class, you'll want to add additional configuration to the pipeline to perform appropriate extract and load steps.

The pipeline source configuration is an array of extraction steps. These steps can return/yield one or more source objects that will be transformed later in the pipeline. In general, these objects should be 1:1 to the documents. By default, Spotlight assumes the resource object is the object to index, but e.g. if you had a resource instance that represented a collection containing 5 constituent object, the source would yield an object representing the collection and 5 additional objects for each part of the collection.

The pipeline transform configuration take the sources and turns it into a solr document-style hash. By default, Spotlight provides some steps that augment a document with fields that enable spotlight-specific features, but you'll need to add a transform step to appropriately transform your source object to any number of application-specific metadata fields.

Here's an example of overriding the indexing pipeline for a contrived resource class.

class MyResourceClass < Spotlight::Resource
  def self.indexing_pipeline
    @indexing_pipeline ||= super.dup.tap do |pipeline|
      # Override the default indexing pipeline to add our application-specific logic; in this case, the `#to_solr` method will be
      # called on the source object (which.. because we don't override the `pipeline.sources` at all.. is just the resource instance itself) 
      pipeline.transforms = [Spotlight::Etl::Transforms::SourceMethodTransform(:to_solr)] + pipeline.transforms
    end
  end

  def to_solr
    { id: id, title_field: xml_document.xpath('//title'), ...  }
  end
end

Other examples of this new pattern include:

• https://github.com/projectblacklight/spotlight/blob/master/app/models/spotlight/resources/iiif_harvester.rb
• https://github.com/projectblacklight/spotlight/blob/master/app/models/spotlight/resources/upload.rb
• https://github.com/sul-dlss/exhibits/blob/master/app/models/dor_harvester.rb
• https://github.com/sul-dlss/exhibits/blob/master/app/models/canvas_resource.rb

Other backwards compatibility notes

• Spotlight 2 exhibit exports may not import cleanly into Spotlight 3 applications

Thanks

• @camillevilla
• @mejackreed
• @jkeck
• @ggeisler
• @jvine
• @cbeer
• @dunn
• @tampakis
• @elrayle

https://github.com/projectblacklight/spotlight/compare/v2.12.1...v2.13.0

https://github.com/projectblacklight/spotlight/compare/v2.12.0...v2.12.1

https://github.com/projectblacklight/spotlight/compare/v2.11.0...v2.12.0

• Fixes bug where uploaded images are no longer able to be viewed in a IIIF viewer #2222
• HTML lang attribute should now reflect the current i18n locale #2247

Thank you to all release contributors!
@camillevilla @cbeer @dunn @mejackreed

https://github.com/projectblacklight/spotlight/compare/v2.10.0...v2.11.0

• Add UI controls for making a user a site administrator #2215
• Fix a regression in generating IIIF manifests for sites served over https (#2217)

Thank you to all release contributors!
@camillevilla @dunn

https://github.com/projectblacklight/spotlight/compare/v2.9.0...v2.10.0

• Allow importing IIIF manifests with multilingual metadata #2209
• Allow curators to specify exhibit-specific configuration for search fields #2208
• Add some configuration to allow uploaded field mappings to provide processing directives #2110
• Allow Spotlight applications to use an external (non-riiif) IIIF server for image derivative requests #2203

Thank you to all release contributors!
@camillevilla @cbeer @dunn @jkeck @mejackreed

• Add French locale file
• Add an Arabic locale file
• Fix a bug with paginating through search results embedded on a feature page (#2207)
• Fix a bug rendering the edit form for a feature page that tries to display a deleted page

Upgrade notes:

Upgraders will need to run rake spotlight:install:migrations.

Added

Bugs

https://github.com/projectblacklight/spotlight/compare/v2.5.2...v2.6.0

Updates:

#2168 Adds help block text for image upload areas

https://github.com/projectblacklight/spotlight/compare/v2.4.1...v2.5.0

Upgrade Notes:

Upgraders may need to update their config in:

# config/initializers/riiif.rb
- Riiif::Engine.config.cache_duration_in_days = 365
+ Riiif::Engine.config.cache_duration = 365.days

Updates:

#1986 Updates riiif to 2.0
#2158 Sets up anonymizeIP configuration for Google Analytics

Bugfixes:

#2161 Fixes a bug where urls in some feature page widgets that had underscores would be converted to italics

Bugfixes:

• Use the same logic as the rest of the app for determining whether to render the search bar or not. (#2123)
• Fixed typo in method name for CarrierwaveFileResolver (#2134)
• Includes flash when redirecting from exhibits home page. (#2139)

#2121 Fixes a bug that prevents changes on page edit forms from persisting (see sul-dlss/exhibits#1326 for more info)

#2105 Enable facets in newly generated applications
#2113 Increase the maximum number of feature pages
#2115 Fix the caption fallback for the slideshow feature block

https://github.com/projectblacklight/spotlight/compare/v2.2.1...v2.3.0

Update notes

The bugfix in #2100 adds a new migration. Adopters should run:

rake spotlight:install:migrations

#2109 Added the ability to explicitly configure which Solr fields an upload field belongs to
#2100 Changed Taggable id type and fixed an Exhibit tags bug (h/t @dunn)

#2097 fixes an issue where show fields were not showing up as sorted in the metadata administrator panel.

https://github.com/projectblacklight/spotlight/compare/v2.2.0...v2.2.1

https://github.com/projectblacklight/spotlight/compare/v2.1.0...v2.2.0

This release has several notable changes.

Update notes

Adopters wanting to take advantage of the enhancements in #2092 which could potentially prevent users from saving large pages should run:

$ rails generate spotlight:increase_paper_trail_column_size

#2091 and #2088 make several changes to fix the build, including updating our Rubocop todo, and requiring i18n < 1.1 as i18n introduced a backwards incompatible change with Rails (https://github.com/rails/rails/pull/33574)
#2094 Updates our CI to build with Rails 5.2.1
#2086 adds new locale files for Chinese and Italian languages
#2092 Update the PaperTrails versions table to be larger to accommodate large Spotlight::Page
#2082 Uses textarea for free form text input

https://github.com/projectblacklight/spotlight/compare/v2.0.2...v2.1.0

This release has two notable changes, allowing for great customizability for a Spotlight application.

#2079 Allows the application catalog config to provide values for custom fields
#2078 Enables a Spotlight application to add custom attributes to be shown on a SirTrevor Widget edit form

This release primarily includes two notable changes.

1. Fixes an issue where you could browse though the Previous/Next record pagination from browse categories into negative numbers (or past the number of documents in the browse category). #2062
2. Changes the field type of the the content column for Pages to increase the size from text to mediumtext. #2067

Note that 2 introduces a database migration so you'll want to run the spotlight:install:migrations and db:migrate rake tasks once updating.

Full changes: https://github.com/projectblacklight/spotlight/compare/v2.0.1...v2.0.2

#2065 Fixes an issue where IIIF resources that did not respond to HEAD requests were not harvestable.