Currently Reading

May 14, 2024

Currently Reading Plugin

Displays a cover image of a book with a link to Google Books based on a supplied ISBN-10 or ISBN-13.

Supplying an ISBN (and, optionally, a Title) will display a cover image of the relevant book with a link to that book’s page on Google Books using the Google Books API.

Using the Widget you can choose whether to:

  • Force all calls to Google to be HTTPS, instead of the API returned HTTP
  • Pad the Image (selected by default, uses internal CSS)
  • Display a Box-Shadow (selected by default, uses internal CSS)
  • Choose Alternate Google Country (defaults to “Worldwide”)

as well as

  • Decide whether you would like to use a Title
  • Define the ISBN-10 or ISBN-13 of the book.

Usage

  1. Activate the Plugin via “Plugins” “Currently Reading” “Activate” (if you hadn’t already done so).
  2. Go to “Appearance” “Widgets” and drag the “Reading” widget into whichever Sidebar you choose.
  3. In the “Currently Reading” widget, you can then customise it further.

Installation

Manual Install

  1. Unzip the currently-reading.zip file.
  2. Upload currently-reading.php to the /wp-content/plugins/ directory.
  3. Activate the plugin through the ‘Plugins’ menu in WordPress.
  4. Use the “Currently Reading” widget (found under Appearance Widgets).

Automated Install

  1. Go to “Plugins” “Add New” in your Control Panel.
  2. Search for the keywords “Currently Reading”.
  3. Click the “Install Now” button on “Currently Reading” by “Eugéne Roux”.
  4. When prompted “Are you sure you want to install this plugin?” select “OK”.
  5. Once the installation is finished, you will be prompted to “Activate Plugin”.

Upgrade

  1. Follow your normal installation procedure
  2. Open each Widget’s control panel and re-save

Use the WordPress Plug-in System

  1. Select “Upgrade and Activate”
  2. Congratulate yourself on a sterling job.

Screenshots

  1. The Configuration of a "Currently Reading" section, with Padding enabled.

    The Configuration of a "Currently Reading" section, with Padding enabled.

  2. The default "Widget" configuration, with the Google Country set to South Africa and an ISBN-13.

    The default "Widget" configuration, with the Google Country set to South Africa and an ISBN-13.

  3. The previous configuration as rendered by Safari.

    The previous configuration as rendered by Safari.

  4. The difference between Padding and Box-Shadow Enabled and Disabled.

    The difference between Padding and Box-Shadow Enabled and Disabled.

  5. Widget Configuration location in the Dashboard's sidebar.

    Widget Configuration location in the Dashboard's sidebar.

FAQ

I get a ‘*Warning: file_get_contents … : failed to open stream: HTTP request failed! HTTP/1.0 403 Forbidden*’ Error in my logs and no books are displayed. Why is this happening?

Your web-site has been configure not to allow outgoing HTTP requests and you have ‘Use Google API’ enabled.

Please de-select the ‘Use Google API’ option to use the direct connection instead.

I get a ‘*No Google Books Entry Found for ISBN:NUMBER*’ on my Blog… Why?

Sometimes Google Books does not return any valid responses on ISBNs. Try the following:

  1. See if you can find an alternate ISBN for the book
  2. Toggle the “Use Google API” option
  3. Find the eBook on Google’s Books Web Page and use its ISBN

Are you planing to insert other sources than Google Books to the Currently Reading widget?

I’ll have a look into supporting Amazon, though they do make you jump through hoops to use their API (which is the reason I settled on using Google Books to start with).

Is there a way to get this plugin to do a library of all of your books into WordPress?

It’s not currently possible with this plugin, no.

I’ll give it a bit of thought and see if I can extend it to do that; but it will most likely need the creation of an alternate plugin to do that.

This would likely require its own database table to do properly, as well…

Changelog

4.1.6

  • “My apologies, your honour, my client is an idiot…”

4.1.5

  • Updated for 6.5

4.0.8

  • Add option to open Google Books link in a new Tab/Window

4.0.7

  • Add the option to force the use of SSL (https) on Google’s API links
  • Add the option to force the use of SSL (https) on the Alternate links to Google’s API
  • Tested to WordPress 5.2.3

4.0.6

  • Updated and tested WordPress 5

4.0.5

  • Fix the Google Books API call
  • Tested to WordPress 4.7

4.0.4

  • Check cache before using it
  • Check data validity before writing cache

4.0.2

  • Allow (and default to) not using the Google Books API in preference to the older — direct — connection
  • Since I’m probably the only Saffer using this, default to “books.google.com”

4.0.1

  • Display a message (No Google Books Entry Found for ISBN) when Google has no entry for the book in question
  • Reduce the width of margins so that the book entries fit better into the sidebar
  • Added a screenshot of the Widget Configuration location in the Sidebar (mostly since I keep forgetting where it is)

4.0

  • Use the Google Books API instead of previous deep-linking
  • Fix display of ISBN when updating the widget
  • Allow the selection of Alternate Google Domains (books.google.com causes issues in some countries)
  • Display book’s Title instead of ISBN on mouse-over

3.4

  • Minor fixes to ensure WordPress compatibility

3.3

  • Moved to a ‘<div>’ based layout instead of using Lists (Kudos to James Sumners for the suggestion)

3.2

  • Improved the book spacing a bit in the internal CSS

3.1

  • Added the ability to have drop-shadows around the front-cover images of the books

3.0

  • Release number re-alignment with internal Hg repo

2.0

  • Fixed a potentially embarrassing issue with generated HTML

1.0

  • Initial Public Release

Details

  • Version: 4.1.6
  • Active installations: 90
  • WordPress Version: 6.0
  • Tested up to: 6.5.5

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars