Goodreads

Overview

Goodreads is a social networking website for readers and claims to be the largest site for book recommendations. As of the end of 2011, Goodreads had 6,800,000 members who added more than 240,000,000 books to their “shelves.” Goodreads members have created about 20 billion reviews (which can be as short as a star rating) according to Read Write Web.  A lot of the book data itself comes from a number of sources, including Amazon, Barnes and Noble, Ingram, Library of Congress, Worldcat and others along with data submitted by individual publishers and Goodreads users that become librarians.

This module, along with its bundled submodules, let you integrate that Goodreads data onto your Drupal website.

Most of the module is a mapping of the Goodreads APIs into PHP functions that module developers can use to integrate Goodreads data into Drupal websites. In addition to the API, two submodules add integration of data via a Drupal input filter and views integration with users' Goodreads books/bookshelves.

Features

• Implementation of all Goodreads API calls via PHP functions.
• OAuth integration on a user by user level.
• Flexible input filter allows inserting Goodreads data into content.
• Views integration of users' books and bookshelves.
• Currently available for Drupal 6 and 7

Requirements

This module is currently available for Drupal 6 and 7

The basic Goodreads module and the Goodreads filter submodule have no external module dependencies.

The Goodreads views submodule has external dependencies on:

• Views
• Drupal Queue

The Goodreads OAuth submodule has external dependencies on:

• OAuth
• Http Client
• Autoload

Known problems

Some of the Goodreads APIs have bugs and return errors or the wrong results. We are waiting for corrections to be released. APIs affected are:

• events.list   —   Events in your area.
• followers.create-OAuth   —   Follow a user.
• notifications-OAuth   —   See the current user's notifications.
• user.followers   —   Get a user's followers.
• user.following   —   Get people a user is following.

Credits

This project was sponsored by the
Columbus Metropolitan Library.

Similar projects

There is one (or two) add on submodule(s) for the Activity Stream module which can integrate data available via RSS feeds from Goodreads. This module is an implementation of the Goodreads restful API and offers an implementation of most of the API's functions to module developers.