https://github.com/agarrharr/google-bookshelves-widget
📚 Allows you to display the books in your Google Books Library.
https://github.com/agarrharr/google-bookshelves-widget
Last synced: about 2 months ago
JSON representation
📚 Allows you to display the books in your Google Books Library.
- Host: GitHub
- URL: https://github.com/agarrharr/google-bookshelves-widget
- Owner: agarrharr
- License: mit
- Created: 2014-06-02T01:43:14.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2018-03-01T16:50:30.000Z (about 7 years ago)
- Last Synced: 2024-05-21T01:02:19.328Z (about 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 378 KB
- Stars: 5
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
- awesome-static-website-services - Google Books - Allows you to display the books in your Google Books Library. (Books)
README
# Google Bookshelves Widget
This plugin allows you to display the books in your Google Books Library
## Description
With this plugin you can add show off your books from any of the shelves on your Google Books Library. It uses the Google Boooks API to show your Reading Now, Favorites, Have Read, To Read, or your custom shelves. You can also choose the maximum number of books that you want to display.
In order to find your `idNumber`, visit books.google.com and click "My library". Then look in the address bar and it should look something like this:
```
http://books.google.com/books?uid=113720634485746776434
```
Everything after uid= is your idNumber.
To find the shelfNumber for a particular shelf, click on the name of the shelf. The address should look something like this:
```
http://books.google.com/books?as_coll=3&num=10&uid=113720634485746776434&source=gbs_slider_cls_metadata_3_mylibrary_title
```
The number after `as_col=` is your shelfNumber. Note that you have to make sure that you make the shelf public for this to work. To do this, click on the settings button (looks like a gear), click "Edit properties", and next to visibility, click "Make public" if it isn't already public.
## Example Usage
The required options are idNumber, shelfNumber, container. Everything else will default to what is shown below.
limit is the maximum number of books to show
pageCurl is whether or not to show a page curl on the image
imageSize is the size of the image retrieved. Possible options are thumb or smallThumb
layout is the template to use to display the books. It can be any file name that is contined in layouts. The included templates are grid, description, and column
```js
googleBookshelves.showShelf({
idNumber: "113720634485746776434",
shelfNumber: 3,
container: "#readingNow",
limit: 10,
pageCurl: false,
imageSize: "thumb",
layout: "grid"
});
```
## Dependencies
It requires jquery for the ajax call, and handlebars for the templating.