Google Book cover and link on OPAC results

Tags: google_book , book , cover , opac Last Updated: Dec 09, 2011 00:44

• Description
  Displays Google Book link information on OPAC's short results screen using Old API (deprecated as of May 26, 2011) or New Google Book Search API.
  It can be used on all Aleph500 versions.
  ==== Version 2.1: December, 2011 (New Google Books API : http://code.google.com/intl/en/apis/books/).

  ---

• Author: Michelangelo Mazzardo Marques Viana
• Additional author(s):
• Institution: Pontificia Universidade Catolica RS
• Year: 2009

  ---

• License: MPL 1.1 / GPL 2.0
• Short description: Use, modification and distribution of the code are permitted provided the copyright notice, list of conditions and disclaimer appear in all related material.
• Link to terms: MPL 1.1, GPL 2.0

  ---

• Skill required for using this code: intermediate

  ---

State

Stable (in production use)

Programming language

Javascript, New Google Books API (http://code.google.com/intl/en/apis/books/)

Software requirements

Tested with Aleph500 versions 18 and 20, under Linux Red Hat.
Should work in different environments too.
Requires only Javascript + New Google Books API (SEE NOTES).

Screen captures

Author(s) homepage

http://www.linkedin.com/pub/michelangelo-mazzardo-marques-viana/3/723/857

Download

NEW FILE (Dec.2011), to use the New Google Books API:
http://www.exlibrisgroup.org/download/attachments/24610408/GoogleBooksPUCRS_newAPI_dec_2011.zip

Working example

http://verum.pucrs.br/F/?func=find-b&find_code=WLS&request=farmacia&adjacent=N&local_base=gbs
(eg: books with 'subject=pharmacy' in English)

Using the following Ex Libris open interfaces

None so far.

Changes

Version 2.1 (December, 2011)

• Faster release (iframes);
• Using New Google Books API (http://code.google.com/intl/en/apis/books/)
• Add book metadata for the 'title' attribute of the 'A' tag (link to the book).

Release notes

Version 1.0 (2009) was the initial release.
Version 2.0 (2010) is faster, using IFRAME and a new file: google-book.
Version 2.1 (2011) is faster, using IFRAME, a new file: 'google-book' and the New Google Books API (See NOTES inside step 1).

Installation instructions

1. [NEW] Must obtain and save the value of your Google API Key:
    Follow the instructions at http://code.google.com/intl/en/apis/books/docs/v1/using.html#APIKey
    NOTES:  
    # According to Google: "To prevent abuse, Google places limits on API requests. Using a valid OAuth token or API key allows you to exceed anonymous limits by connecting requests back to your project.".
   # This API allows you to define allowed referrers domain(s); 
   # This API has 1,000 queries/day as courtesy limit. You can request more per day in Google API console page.

2. Log in to the server as aleph user

3. Save the new file "google-book" on $alephe_root/www_f_LNG/

4. [NEW] Inside the file "google-book", update the variable value "google_api_user_key"obtained in the step 1;

5. Inside google-book file, change the text that is displayed below the book cover.
Example given:

6. Still inside google-book file, make the necessary adjustments on CSS styles to fit your needs.

7. Save the google-book file and exit.

8. Setup BIB (xxx01) www_tab_short.lng to display ISBN (020##)
/exlibris/aleph/uXX_1/xxx01/tab/www_tab_short.LNG

9. Define a new table head to OPAC short results.
This new "TH" column must be put on:
$alephe_root/www_f_LNG/short-a-head

<th>$1000</th>

10. Define a new table division to OPAC short results.
This new "TD" column must be put on:
$alephe_root/www_f_LNG/short-a-body
and must be at same column position of its respective TH.

11. Verify the Aleph's OPAC variable wich is returning the ISBN after www_tab_short.lng setup:
/exlibris/aleph/uXX_1/xxx01/tab/www_tab_short.LNG

12. Change ISBN variable on following code: there is only one occurence, after "isbn_record".
Example given, PUCRS's Aleph ISBN variable is dollar_1000 (one thousand)

13. Make the necessary adjustments on width and height of IFRAME, to fit CSS styles definitions.

14. Inside the new "TD" on short-a-body, insert the following code:

15. Save the short-a-body file and exit.

16. Upload the attached image "googlebook.png" to www_f_eng/icon . It will be used when no cover is provided:

17. Restart Aleph WWW Server.

18. Make an OPAC search that return books with ISBN for testing.

Configuration

Main configurations are done in:
$alephe_root/www_f_LNG/short-a-body and on
$alephe_root/www_f_LNG/google-book

Summary of actions needed to implement it

• Setup Aleph to display ISBN on search results: BIB01 data_tab directory

  1) Verify what is the ISBN variable and change it in the 'google-book' file (there is only 1 occurrence). 2) Anonymous use of this New Google Books API has a limit too small (just for test purposes). So, to avoid interruption of its use, use it with your API key. Must obtain and save the value of your Google API Key in the 'google-book' file. Follow the instructions at http://code.google.com/intl/en/apis/books/docs/v1/using.html#APIKey

• Save the google-book file on OPAC's www_f_LNG directory
• [NEW] Upload the image googlebook.png" to www_f_eng/icon . I will be used when no cover is provided.
• Adjust the HTML files (short-a-head, short-a-body, google-book) inside www_f_LNG directory
• Restart WWW server
• Testing on different web browsers and versions

Comments