there is a story behind every book

DISCOVERY Wordpress Plugin

This plugin will integrate Jellybooks DISCOVERY samples directly into your product pages by making book covers clickable and launch an inline preview. It is intended to work on any book-related WordPress website. However, in order to integrate the book sample preview feature we assume that each product page contains:

  • Cover image - the plugin will make clicking on the cover trigger the sample preview (as a pop-up)
  • ISBN13 look up - the plug-in can only match a sample if it can locate the associated book ISBN13 within the underlying HTML on the book page

Download

The Jellybooks plugin is available to download via the Official Wordpress Plugin Directory.

Install via Wordpress

The simplest way is to install directly via your Wordpress app.

  1. Log in as admin and open site's Dashboard
  2. Select Plugins from left-hand menu
  3. Enter 'Jellybooks' in the search bar and select the Jellybooks DISCOVERY for Publishers plugin by 'Jellybooks Ltd'
  4. Click Install and Activate button.

Install via zip file

  1. Download the plugin zip file to your PC.
  2. Log in to your WordPress dashboard.
  3. Go to Plugins > Add New.
  4. Click Upload Plugin.
  5. Click Choose File and select the plugin zip file you downloaded in Step 1.
  6. Click Install Now.
  7. Once the plugin is installed, click Activate.

See the official Wordpress plugin install guide for more details.

Setup

  1. Click Jellybooks Discovery from the left-hand admin-menu.
  2. Add your Jellybooks API Key into the form.
  3. Add the segments and XPath settings as provided by Jellybooks. (This is how the website directs the plugin to interact with the relevant data and elements within a product page.
  4. Click Save.

Assuming everything is configured correctly then when a product page is loading, the plugin will:

  1. extract the ISBN13.
  2. send a lookup request to the Jellybooks DISCOVERY API to see if there is a match
  3. if there is a match, it will enhance the page so a preview appears when the the cover is clicked/tapped, else no changes are applied.

Note: that if Jellybooks has only been received the publisher's ebook ONIX feed, then the look-ups performed will be against ebook ISBNs in our database only. i.e., a print ISBN and ebook ISBN will not automatically match. However we can ingest a publishers' print ONIX feed to create an index of print ISBNs matching the relevant ebook ISBN.

Recommendations

Every website is different and the plugin is designed to be flexible. In order to operate effectively, the plugin has to be able to locate the ISBN13 and cover image from within the underlying HTML of a product page. We describe these locations using the XPath XML standard.

The Jellybooks plugin is typically one of many plugins that a website may have installed and therefore it can be difficult to accurately specify the correct XPath settings for a given website. As a consequence, we recommend that website owners do the following:

  1. ISBN: add a hidden div/span with a unique id attribute that contains the book's ISBN13, preferably for the ebook version. E.g.,

    <div id="isbn_for_jellybooks" style="display:none">9780141439518</div>

  2. Cover: add an additional, unique class to the img element that is for the book cover. E.g., add cover_for_jellybooks

    <img class="existing_classes cover_for_jellybooks" src="https://not.a.real/cover.jpg" />