@eligundry/gatsby-source-goodreads

    1.0.2 • Public • Published

    @eligundry/gatsby-source-goodreads

    Gatsby source that provides Goodreads shelf information.

    Why Use This?

    There are many Gatsby Goodreads sources, why make another? It was fun AND all the sources I'm seeing are using the Goodreads API which is due to be deprecated soon. This plugin scrapes for the publically accessible HTML available on their website. Also, no need to fiddle with API keys to pull the data!

    Installation

    $ npm install -S @eligundry/gatsby-source-goodreads

    Usage

    In gatsby-config.js:

    module.exports = {
      plugins: [
        {
          resolve: '@eligundry/gatsby-source-goodreads',
          options: {
            userID: 123,
            shelves: ['currently-reading', 'read'],
          }
        }
      ]
    }

    Then, you can query it like so (this is what I'm using on my site):

    query UseGoodreadsShelves {
      currentlyReading: allGoodreadsBook(
        filter: { shelf: { eq: "currently-reading" } }
        sort: { fields: started, order: DESC }
        limit: 6
      ) {
        books: nodes {
          title
          author
          isbn
          url
          started
          coverImage {
            childImageSharp {
              gatsbyImageData(width: 175, quality: 90)
            }
          }
        }
      }
      recentlyFinished: allGoodreadsBook(
        filter: { shelf: { eq: "read" } }
        sort: { fields: finished, order: DESC }
        limit: 6
      ) {
        books: nodes {
          finished
          title
          author
          isbn
          url
          started
          coverImage {
            childImageSharp {
              gatsbyImageData(width: 175, quality: 90)
            }
          }
        }
      }
    }

    Install

    npm i @eligundry/gatsby-source-goodreads

    DownloadsWeekly Downloads

    10

    Version

    1.0.2

    License

    MIT

    Unpacked Size

    18.3 kB

    Total Files

    6

    Last publish

    Collaborators

    • eligundry