Upgrading to Blacklight 9

Blacklight 9 includes some backwards-incompatible changes. Follow this guide to upgrade a Blacklight 8 application to Blacklight 9.

1. Ensure your local application has a passing test suite. If needed, add automated tests for any important functionality, to make it obvious when something is broken.

2. Upgrade to the latest 8.x release so you can see any recent deprecation warnings.

3. Take note of any deprecation warnings originating from Blacklight in the logs and make the suggested changes.

4. Upgrade to Blacklight 9 and follow the Upgrade Notes below.

Plugin status against Blacklight 9

To test a plugin and validate it Run the plugin with the latest version of blacklight/main.

Tested and known to work

TODO: Add to this list the release of gem compatible with BL9

None yet

Tested and in need of upgrade

None yet

Testing in progress

None yet

Not yet tested

1. blacklight-hierarchy
2. blacklight_oai_provider
3. arclight
4. spotlight
5. blacklight-gallery
6. blacklight_marc
7. blacklight_iiif_search
8. blacklight_range_limit - the javascript for the histogram does not work, needs attention. Note that Bootstrap slider claims to only work with bootstrap 4, although it seems to work with Bootstrap 5.
9. blacklight_advanced_search - release needed
10. geoblacklight - a number of UI issues, in progress PR open

---

Upgrade Notes

1. The shared/header_navbar partial no longer exists. If you used this in your application, then render blacklight_config.header_component.new(blacklight_config: blacklight_config) instead.