Library Bookshelves

Description

The Library Bookshelves plugin allows you to curate virtual bookshelves just like you would a shelf around a theme in your library. Bookshelves are displayed as customizable Slick carousels, using cover art from, and links to, your library catalog. The plugin creates a Bookshelves post type, shortcode, widget, and custom taxonomy.

This plugin currently supports BiblioCommons, Calibre, EBSCOHost Discovery Service, Evergreen, Innovative Encore and WebPAC PRO, Koha, OpenLibrary.org, Polaris, SirsiDynix Enterprise and Horizon, and TLC catalogs. It supports retrieval of images from these third-party CDNs: Amazon, ChiliFresh, Baker & Taylor, EBSCO, OpenLibrary.org, Syndetics, and TLC. Bookshelves can be populated from SirsiDynix Symphony Web Service requests.

If you would like this plugin to support another catalog system, CDN, or web service email me.

Originally developed by and for staff at the Guilderland Public Library.

Thanks to Gregory Testa of Chesapeake Public Library for feature suggestions and code contributions.

We want to know where our plugin is being used and how you’re using it! Don’t worry, we’re not going to use any tracking code to find out. If you are one of the many libraries using this plugin drop us a line and say “Hi!”

Configuration

  1. Go to Bookshelves>Settings to configure the plugin.
  2. On the Catalog tab enter the domain name of your catalog (default is OpenLibrary.org).
  3. Select your catalog system and image CDN.
    • ChiliFresh users will need to add their website domain to “Covered hosts” in the ChiliFresh Admin Panel for images to display.
    • TLC users will need to enter a Customer ID which can be found in your catalog’s item cover art URLs.
  4. On the Slider Settings tab you can customize bookshelf behavior. Defaults have been set to get you started.
  5. On the CSS Settings tab you can customize some Bookshelf element styles.

Getting Started

Create a new Bookshelf using ISBNs or UPCs from items in your catalog. You can input items manually, from an exported list, or from a web service API. Paste the Bookshelf shortcode into a post or page, or use the Bookshelf widget. Add location tags to your Bookshelves to display them in the widget or just to keep them organized. The widget can organize Bookshelves in tabs, and will sort Bookshelves by the Order attribute.

EBSCOHost users must enter Accession Numbers, and Calibre users must enter book ID numbers instead of ISBNs or UPCs.

Known Issues

There is a known issue using the Bookshelves widget in tabbed mode and the Ultimate Addons for Visual Composer plugin.

FAQ

Q: This plugin doesn’t support my library’s catalog system. Will future versions support it?

A: Yes! But only if you contact me with a link to your catalog! As soon as you do I’ll get working on an update.

Q: I don’t know which CDN my catalog uses for item images. How do I find out?

A: Right click on an item image from your catalog and select View Image or Inspect to see the image URL. If you’re still not sure, email me

Q: I’ve set my catalog settings correctly, so why don’t item images appear?

A: Try an alternate ISBN if possible. Amazon, for example, only supports 10-digit ISBNs. Not all CDNs will have images for every ISBN.

Reviews

December 10, 2018
This plugin works great for our Library, the new evergreen specific config options are very useful. We have had zero issues with the functionality of the plugin. The code seems to be high quality and is easy to read and allows for easy customization.
October 5, 2017
I contacted the plugin author to get our catalog added. We receive our catalog through a consortium that uses "profiles" on the SirsyDynix Enterprise catalog so that each library in the consortium gets their own catalog page. This did not work with the previous version, but Jon was nice enough to update the plugin to work with our catalog and the ability to add profile codes, which pulls up the books on our personal catalog profile. Our staff have even been bringing stacks of books to their desk, starting a new bookshelf, and then scanning in the items ISBN. We're already thinking of all kinds of new possibilities, like creating virtual bookshelves to mirror the themed book displays that we do in our actual library. Do be aware that not every book has cover art in the OpenLibrary.org website, so you may get some missing books in your bookshelf. This can easily be fixed by signing up for an account at https://OpenLibrary.org and adding the book information and cover art.
Read all 2 reviews

Contributors & Developers

“Library Bookshelves” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Library Bookshelves” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

4.4

  • Fixed bugs related to Sierra API requests.

4.3

  • Added support for Sierra API requests. Polaris and WebPAC PRO users can now use ISBNs or UPCs.

4.2

  • Added support for WebPAC PRO catalogs.

4.1

  • Added an option to specify ISBN or UPC item identifiers when using the Syndetics CDN. Minor code improvements.

4.0

  • Added options for processing data from web services. Added support for SirsiDynix Symphony Web Service API. Fixed a DVD image display issue caused by changes in the Syndetics CDN.

3.2

  • Added support for Calibre servers. Some text changes and bug fixes.

3.1

  • Changed some user-editable CSS defaults. Upgraded Slick to 1.9.0. Added option to select HTTP or HTTPS protocol for catalog URLs.

3.0

  • Added a style editor to the settings page. Added Support for TLC catalogs. Added support for optional image ALT attributes to support screen readers. The widget now sorts Bookshelves by post order. Bookshelves now support post revisions. Fixed some bugs.

2.5

  • Fixed URL issue for SyrsiDynix Enterprise catalogs not configured with SSL certificates.

2.4

  • Added support for item record number and UPC in addition to ISBN for Evergreen ILS and CDN.

2.3

  • Added support for EBSCOHost Discovery Service.

2.2

  • Fixed PHP 5.3 incompatibility which affected multi-site installs.

2.0

  • Changed the ISBN input method to allow copy-and-pasting of delimited lists. Added customizable Slick options for each Bookshelf. Added Evergreen support. Fixed a CSS conflict that may occur with themes or plugins that also include Slick. Fixed some other minor bugs.

1.10

  • Fixed a bug preventing some Slick CSS from rendering. Upgraded to Slick 1.8.1.

1.9

  • Fixed a bug which prevented plugin settings from being read on some non-standard WordPress installations.

1.8

  • Added profile support for Polaris catalogs.

1.7

  • Added support for Koha.

1.6

  • Fixed a bug which could occur if profile code field is left blank.

1.5

  • Added a setting for profile code and added profile support for SirsiDynix Enterprise catalogs.

1.4

  • Added support for ChiliFresh CDN. Fixed some Slick settings bugs.

1.3

  • Compatible with PHP 5.3+. Links to Encore catalog are now HTTPS.

1.2

  • Fixed bug with default settings. Added minimum PHP version.

1.1

  • Added support for BiblioCommons, Polaris, and SirsiDynix catalogs.

1.0

  • Initial version.