C4/External/Amazon.pm

   1 package C4::External::Amazon;
   2 # Copyright (C) 2006 LibLime
   3 # <jmf at liblime dot com>
   4 #
   5 # This file is part of Koha.
   6 #
   7 # Koha is free software; you can redistribute it and/or modify it under the
   8 # terms of the GNU General Public License as published by the Free Software
   9 # Foundation; either version 2 of the License, or (at your option) any later
  10 # version.
  11 #
  12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  14 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License along with
  17 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
  18 # Suite 330, Boston, MA  02111-1307 USA
  19
  20 use XML::Simple;
  21 use LWP::Simple;
  22 use LWP::UserAgent;
  23 use HTTP::Request::Common;
  24 use C4::Koha;
  25
  26 use strict;
  27 use warnings;
  28
  29 use vars qw($VERSION @ISA @EXPORT);
  30
  31 BEGIN {
  32     require Exporter;
  33     $VERSION = 0.03;
  34     @ISA = qw(Exporter);
  35     @EXPORT = qw(
  36         &get_amazon_details
  37         &check_search_inside
  38         &get_amazon_tld
  39     );
  40 }
  41
  42
  43 sub get_amazon_tld {
  44     my %tld = (
  45         CA => '.ca',
  46         DE => '.de',
  47         FR => '.fr',
  48         JP => '.jp',
  49         UK => '.co.uk',
  50         US => '.com',
  51     );
  52
  53     my $locale = C4::Context->preference('AmazonLocale');
  54     my $tld = $tld{ $locale } || '.com'; # default top level domain is .com
  55     return $tld;
  56 }
  57
  58
  59 =head1 NAME
  60
  61 C4::External::Amazon - Functions for retrieving Amazon.com content in Koha
  62
  63 =head1 FUNCTIONS
  64
  65 This module provides facilities for retrieving Amazon.com content in Koha
  66
  67 =head2 get_amazon_details
  68
  69 =over 4
  70
  71 my $amazon_details = &get_amazon_details( $xisbn, $record, $marcflavour );
  72
  73 =back
  74
  75 Get editorial reviews, customer reviews, and similar products using Amazon Web Services.
  76
  77 =cut
  78
  79 sub get_amazon_details {
  80     my ( $isbn, $record, $marcflavour ) = @_;
  81
  82     # Normalize the fields
  83     $isbn = GetNormalizedISBN($isbn);
  84     my $upc = GetNormalizedUPC($record,$marcflavour);
  85     my $ean = GetNormalizedEAN($record,$marcflavour);
  86
  87     # warn "ISBN: $isbn | UPC: $upc | EAN: $ean";
  88
  89     my ( $id_type, $item_id);
  90     if (defined($isbn) && length($isbn) == 13) { # if the isbn is 13-digit, search Amazon using EAN
  91         $id_type = 'EAN';
  92         $item_id = $isbn;
  93     }
  94     elsif ($isbn) {
  95         $id_type = 'ASIN';
  96         $item_id = $isbn;
  97     }
  98     elsif ($upc) {
  99         $id_type = 'UPC';
 100         $item_id = $upc;
 101     }
 102     elsif ($ean) {
 103         $id_type = 'EAN';
 104         $item_id = $upc;
 105     }
 106     else { # if no ISBN, UPC, or EAN exists, do not even attempt to query Amazon
 107         return undef;
 108     }
 109
 110     my $format = substr $record->leader(), 6, 1; # grab the item format to determine Amazon search index
 111     my $formats;
 112     $formats->{'a'} = 'Books';
 113     $formats->{'g'} = 'Video';
 114     $formats->{'j'} = 'Music';
 115
 116     my $search_index = $formats->{$format};
 117
 118     # Determine which content to grab in the request
 119
 120     # Determine correct locale
 121     my $tld = get_amazon_tld();
 122
 123     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
 124     my $aws_access_key_id = C4::Context->preference('AWSAccessKeyID');
 125
 126     #grab the associates tag: mine is 'kadabox-20'
 127     my $af_tag=C4::Context->preference('AmazonAssocTag');
 128     my $response_group = "Similarities,EditorialReview,Reviews,ItemAttributes,Images";
 129     my $url = "http://ecs.amazonaws$tld/onca/xml?Service=AWSECommerceService&AWSAccessKeyId=$aws_access_key_id&Operation=ItemLookup&AssociateTag=$af_tag&Version=2007-01-15&ItemId=$item_id&IdType=$id_type&ResponseGroup=$response_group";
 130     if ($id_type ne 'ASIN') {
 131         $url .= "&SearchIndex=$search_index";
 132     }
 133     # warn $url;
 134     my $content = get($url);
 135     warn "could not retrieve $url" unless $content;
 136     my $xmlsimple = XML::Simple->new();
 137     my $response = $xmlsimple->XMLin(
 138         $content,
 139         forcearray => [ qw(SimilarProduct EditorialReview Review) ],
 140     ) unless !$content;
 141     return $response;
 142 }
 143
 144 sub check_search_inside {
 145         my $isbn = shift;
 146         my $ua = LWP::UserAgent->new(
 147         agent => "Mozilla/4.76 [en] (Win98; U)",
 148         keep_alive => 1,
 149         env_proxy => 1,
 150         );
 151         my $available = 1;
 152         my $uri = "http://www.amazon.com/gp/reader/$isbn/ref=sib_dp_pt/002-7879865-0184864#reader-link";
 153         my $req = HTTP::Request->new(GET => $uri);
 154         $req->header (
 155                 'Accept' => 'image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, image/png, */*',
 156                 'Accept-Charset' => 'iso-8859-1,*,utf-8',
 157                 'Accept-Language' => 'en-US' );
 158         my $res = $ua->request($req);
 159         my $content = $res->content();
 160         if ($content =~ m/This book is temporarily unavailable/) {
 161             undef $available;
 162         }
 163         return $available;
 164 }
 165
 166 1;
 167 __END__
 168
 169 =head1 NOTES
 170
 171 =head1 AUTHOR
 172
 173 Joshua Ferraro <jmf@liblime.com>
 174
 175 =cut