LT Unleashed

Description

That plugin offers shortcodes and widgets so you can display any public
LibraryThing books collection in WordPress.

[books username=”username”]

Displays the books of the given LibraryThing user. This shortcode only uses the
LibraryThing API and will work even if you don’t provide an AWS key pair.

Optional attributes are:

  • count: Maximum number of books to show (default 20)
  • sort_by: Sort order, either entry_REV or random
  • template: Template to use to render the list of books. Either cover or list
  • tags: Comma separated list of tags

[book isbn=”isbn”]

Displays the book with the given ISBN number. This shortcode uses the Amazon
Product Advertising API and will not work if you don’t provide an AWS key pair.
Also, not all ISBN can be found on all Amazon stores so you will have to carefully
choose which store to use in the settings.

Optional attributes are:

  • template: Template to use to render the list of books. Only book-single

Customization

You can add new template or customize the existing ones by adding your own
version in a folder named librarything in the wp-content folder on your
server or in your theme folder. The name of the template file id the name of
the template with the .php extension (e.g: the covers template file name
is covers.php).

Disclaimer

This plugin is not endorsed by LibraryThing, it has not been developed by
the LibraryThing team and its developer is not related in any manner to the
LibraryThing team.

Image Credits: University of Scranton Weinberg Memorial Library (cropped)
License: Creative Commons Attribution 2.0 Generic

Screenshots

  • Output of the [books] shortcode with the covers template (widget in the right sidebar)
  • Output of the [books] shortcode with the list template
  • Example of a book with a review when using the listtemplate
  • Single book page. Also, output of the [book] shortcode with the book-single template

Installation

This plugin follows the standard WordPress installation
method
:

  1. Upload the librarything-unleashed folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. You can now use the widget and the [books] shortcode

Optionally, if you want to show book details in single book pages or use
the [book] shortcode, you will need the following:

  1. Go to the Amazon AWS security credentails management page
    and create a new key/secret pair
  2. Enter the pair on the plugin’s options page
  3. Choose or create a new page to support displaying single books
  4. Save the options
  5. You can now use the [book] shortcode and are hosting single book pages
    instead of sending visitors to LibraryThing

Also, if you have your own LibraryThing API key you can use it by adding the
following line in your wp-config.php file:

define('LIBRARYTHING_API_KEY', 'your key here');

This is optional, by default the plugin does not use any key. To find your
LibraryThing API key check this page.

FAQ

Installation Instructions

This plugin follows the standard WordPress installation
method
:

  1. Upload the librarything-unleashed folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. You can now use the widget and the [books] shortcode

Optionally, if you want to show book details in single book pages or use
the [book] shortcode, you will need the following:

  1. Go to the Amazon AWS security credentails management page
    and create a new key/secret pair
  2. Enter the pair on the plugin’s options page
  3. Choose or create a new page to support displaying single books
  4. Save the options
  5. You can now use the [book] shortcode and are hosting single book pages
    instead of sending visitors to LibraryThing

Also, if you have your own LibraryThing API key you can use it by adding the
following line in your wp-config.php file:

define('LIBRARYTHING_API_KEY', 'your key here');

This is optional, by default the plugin does not use any key. To find your
LibraryThing API key check this page.

Reviews

Great plugin but doesn’t work on HTTPS unless you use this hack

Great plugin and works well although I still can’t get the single book feature working.

An issue is that LibraryThing don’t supply the URLs from Amazon using HTTPS so if you have an SSL on your WP site the covers will be broken. Unless you do this:

Install ‘Real-Time Find and Replace’ and configure as follows:

Find ‘ecx.images-amazon.com’ and replace with ‘images-na.ssl-images-amazon.com’

All covers will now be served via HTTPS.

Finally!

Finally a good and fresh plugin for users of librarythings…
And it works well…
Thanks for that!

Read all 2 reviews

Contributors & Developers

“LT Unleashed” is open source software. The following people have contributed to this plugin.

Contributors

Translate “LT Unleashed” into your language.

Interested in development?

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

Changelog

Version 1.1

  • Similarities on a single book page are now linked locally instead of going
    directly to Amazon

Version 1.0.5

  • Protect from AWS API returning inconsistent data structures

Version 1.0.4

  • Fixing a bug that makes some books look like they were not found by the AWS API

Version 1.0.3

  • Fixing book base in settings being partially taken into consideration
  • Automatically converting cover sources to their HTTPS version when WordPress uses HTTPS

Version 1.0.2

  • Fixing a bug that prevented the book shortcode to work in certain circumstances.
  • Changed the book-single template to use a table and display multiple authors.

Version 1.0.1

  • Preparing for language packs

Version 1.0

  • Initial release.