2 # Copyright (C) 2007 LibLime
3 # Joshua Ferraro <jmf@liblime.com>
5 # This file is part of Koha.
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
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.
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
26 use HTTP::Request::Common;
31 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
36 C4::XISBN - Functions for retrieving XISBN content in Koha
40 This module provides facilities for retrieving XISBN, ThingISBN and XISBN content in Koha
47 &get_biblio_from_xisbn
50 sub get_biblio_from_xisbn {
52 my $dbh = C4::Context->dbh;
53 my $query = "SELECT biblionumber FROM biblioitems WHERE isbn=?";
54 my $sth = $dbh->prepare($query);
55 $sth->execute($xisbn);
56 my $xbib_data = $sth->fetchrow_hashref();
58 if ($xbib_data->{biblionumber}) {
59 $xbiblio = GetBiblioData($xbib_data->{biblionumber});
60 $xbiblio->{items} = GetItemsByBiblioitemnumber($xbib_data->{biblionumber});
65 =head1 get_xisbns($isbn);
67 =head2 $isbn is an ISBN string
73 my ($response,$thing_response,$xisbn_response,$gapines_response);
76 if ( C4::Context->preference('ThingISBN') ) {
77 my $url = "http://www.librarything.com/api/thingISBN/".$isbn;
78 $thing_response = _get_url($url,'thingisbn');
82 if ( C4::Context->preference('XISBN') ) {
83 my $affiliate_id=C4::Context->preference('OCLCAffiliateID');
84 my $limit = C4::Context->preference('XISBNDailyLimit') || 499;
85 my $reached_limit = _service_throttle('xisbn',$limit);
86 my $url = "http://xisbn.worldcat.org/webservices/xid/isbn/".$isbn."?method=getEditions&format=xml&fl=form,year,lang,ed";
87 $url.="&ai=".$affiliate_id if $affiliate_id;
88 unless ($reached_limit) {
89 $xisbn_response = _get_url($url,'xisbn');
93 # PINES ISBN (Experimental)
94 #if ( C4::Context->preference('PINESISBN') ) {
95 # my $url = "http://www.librarything.com/api/thingISBN/".$isbn;
96 # $gapines_response = _get_url($url,'thingisbn');
98 $response->{isbn} = [ @{ $xisbn_response->{isbn} or [] }, @{ $thing_response->{isbn} or [] }, @{ $gapines_response->{isbn} or [] } ];
100 my $unique_xisbns; # a hashref
102 # loop through each ISBN and scope to the local collection
103 for my $response_data( @{ $response->{ isbn } } ) {
104 next if $unique_xisbns->{ $response_data->{content} };
105 $unique_xisbns->{ $response_data->{content} }++;
106 my $xbiblio= get_biblio_from_xisbn($response_data->{content});
107 push @xisbns, $xbiblio if $xbiblio; #response_data->{xbiblio}; #->{biblionumber}; # if $xbiblionumber;
113 my ($url,$service_type) = @_;
114 my $ua = LWP::UserAgent->new(
118 my $response = $ua->get($url);
119 if ($response->is_success) {
120 warn "WARNING could not retrieve $service_type $url" unless $response;
122 my $xmlsimple = XML::Simple->new();
123 my $content = $xmlsimple->XMLin(
125 ForceArray => [ qw(isbn) ],
131 warn "WARNING: URL Request Failed " . $response->status_line . "\n";
137 # Throttle services to the specified amount
138 sub _service_throttle {
139 my ($service_type,$daily_limit) = @_;
140 my $dbh = C4::Context->dbh;
141 my $sth = $dbh->prepare("SELECT service_count FROM services_throttle WHERE service_type=?");
142 $sth->execute($service_type);
145 while (my $counter = $sth->fetchrow_hashref()) {
146 $count = $counter->{service_count} if $counter->{service_count};
149 # we're over the limit
150 return 1 if $count >= $daily_limit;
154 $sth = $dbh->do("UPDATE services_throttle SET service_count=$count WHERE service_type='xisbn'");
162 Joshua Ferraro <jmf@liblime.com>