C4/External/Syndetics.pm

   1 package C4::External::Syndetics;
   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
  25 use strict;
  26 use warnings;
  27
  28 use vars qw($VERSION @ISA @EXPORT);
  29
  30 BEGIN {
  31     require Exporter;
  32     $VERSION = 0.03;
  33     @ISA = qw(Exporter);
  34     @EXPORT = qw(
  35         &get_syndetics_index
  36         &get_syndetics_summary
  37         &get_syndetics_toc
  38         &get_syndetics_editions
  39         &get_syndetics_excerpt
  40         &get_syndetics_reviews
  41         &get_syndetics_anotes
  42     );
  43 }
  44
  45 =head1 NAME
  46
  47 C4::External::Syndetics - Functions for retrieving Syndetics content in Koha
  48
  49 =head1 FUNCTIONS
  50
  51 This module provides facilities for retrieving Syndetics.com content in Koha
  52
  53 =head2 get_syndetics_summary
  54
  55 =over 4
  56
  57 my $syndetics_summary= &get_syndetics_summary( $isbn );
  58
  59 =back
  60
  61 Get Summary data from Syndetics
  62
  63 =cut
  64
  65 sub get_syndetics_index {
  66     my ( $isbn,$upc,$oclc ) = @_;
  67
  68     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
  69     my $syndetics_client_code = C4::Context->preference('SyndeticsClientCode');
  70
  71     my $url = "http://syndetics.com/index.aspx?isbn=$isbn/INDEX.XML&client=$syndetics_client_code&type=xw10&upc=$upc&oclc=$oclc";
  72
  73     my $ua = LWP::UserAgent->new;
  74     $ua->timeout(10);
  75     $ua->env_proxy;
  76     my $response = $ua->get($url);
  77     unless ($response->content_type =~ /xml/) {
  78         return;
  79     }
  80
  81     my $content = $response->content;
  82     warn "could not retrieve $url" unless $content;
  83     my $xmlsimple = XML::Simple->new();
  84     $response = $xmlsimple->XMLin(
  85         $content,
  86     ) unless !$content;
  87
  88     my $syndetics_elements;
  89     for my $available_type ('SUMMARY','TOC','FICTION','AWARDS1','SERIES1','SPSUMMARY','SPREVIEW','AVSUMMARY','DBCHAPTER','LJREVIEW','PWREVIEW','SLJREVIEW','CHREVIEW','BLREVIEW','HBREVIEW','KIREVIEW','CRITICASREVIEW','ANOTES') {
  90         if (exists $response->{$available_type} && $response->{$available_type} =~ /$available_type/) {
  91             $syndetics_elements->{$available_type} = $available_type;
  92             #warn "RESPONSE: $available_type : $response->{$available_type}";
  93         }
  94     }
  95     return $syndetics_elements if $syndetics_elements;
  96 }
  97
  98 sub get_syndetics_summary {
  99     my ( $isbn,$upc,$oclc ) = @_;
 100
 101     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
 102     my $syndetics_client_code = C4::Context->preference('SyndeticsClientCode');
 103
 104     my $url = "http://syndetics.com/index.aspx?isbn=$isbn/SUMMARY.XML&client=$syndetics_client_code&type=xw10&upc=$upc&oclc=$oclc";
 105     my $ua = LWP::UserAgent->new;
 106     $ua->timeout(10);
 107     $ua->env_proxy;
 108     my $response = $ua->get($url);
 109     unless ($response->content_type =~ /xml/) {
 110         return;
 111     }
 112
 113     my $content = $response->content;
 114
 115     warn "could not retrieve $url" unless $content;
 116     my $xmlsimple = XML::Simple->new();
 117     $response = $xmlsimple->XMLin(
 118         $content,
 119         forcearray => [ qw(Fld520) ],
 120     ) unless !$content;
 121     # manipulate response USMARC VarFlds VarDFlds Notes Fld520 a
 122     my $summary;
 123     $summary = \@{$response->{VarFlds}->{VarDFlds}->{Notes}->{Fld520}} if $response;
 124     return $summary if $summary;
 125 }
 126
 127 sub get_syndetics_toc {
 128     my ( $isbn,$upc,$oclc ) = @_;
 129
 130     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
 131     my $syndetics_client_code = C4::Context->preference('SyndeticsClientCode');
 132
 133     my $url = "http://syndetics.com/index.aspx?isbn=$isbn/TOC.XML&client=$syndetics_client_code&type=xw10&upc=$upc&oclc=$oclc";
 134     my $ua = LWP::UserAgent->new;
 135     $ua->timeout(10);
 136     $ua->env_proxy;
 137
 138     my $response = $ua->get($url);
 139     unless ($response->content_type =~ /xml/) {
 140         return;
 141     }
 142
 143     my $content = $response->content;
 144     warn "could not retrieve $url" unless $content;
 145     my $xmlsimple = XML::Simple->new();
 146     $response = $xmlsimple->XMLin(
 147         $content,
 148         forcearray => [ qw(Fld970) ],
 149     ) unless !$content;
 150     # manipulate response USMARC VarFlds VarDFlds Notes Fld520 a
 151     my $toc;
 152     $toc = \@{$response->{VarFlds}->{VarDFlds}->{SSIFlds}->{Fld970}} if $response;
 153     return $toc if $toc;
 154 }
 155
 156 sub get_syndetics_excerpt {
 157     my ( $isbn,$upc,$oclc ) = @_;
 158
 159     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
 160     my $syndetics_client_code = C4::Context->preference('SyndeticsClientCode');
 161
 162     my $url = "http://syndetics.com/index.aspx?isbn=$isbn/DBCHAPTER.XML&client=$syndetics_client_code&type=xw10&upc=$upc&oclc=$oclc";
 163     my $ua = LWP::UserAgent->new;
 164     $ua->timeout(10);
 165     $ua->env_proxy;
 166     my $response = $ua->get($url);
 167     unless ($response->content_type =~ /xml/) {
 168         return;
 169     }
 170
 171     my $content = $response->content;
 172     warn "could not retrieve $url" unless $content;
 173     my $xmlsimple = XML::Simple->new();
 174     $response = $xmlsimple->XMLin(
 175         $content,
 176         forcearray => [ qw(Fld520) ],
 177     ) unless !$content;
 178     # manipulate response USMARC VarFlds VarDFlds Notes Fld520 a
 179     my $excerpt;
 180     $excerpt = \@{$response->{VarFlds}->{VarDFlds}->{Notes}->{Fld520}} if $response;
 181     return XMLout($excerpt, NoEscape => 1) if $excerpt;
 182 }
 183
 184 sub get_syndetics_reviews {
 185     my ( $isbn,$upc,$oclc,$syndetics_elements ) = @_;
 186
 187     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
 188     my $syndetics_client_code = C4::Context->preference('SyndeticsClientCode');
 189     my @reviews;
 190     my $review_sources = [
 191     {title => 'Library Journal Review', file => 'LJREVIEW.XML', element => 'LJREVIEW'},
 192     {title => 'Publishers Weekly Review', file => 'PWREVIEW.XML', element => 'PWREVIEW'},
 193     {title => 'School Library Journal Review', file => 'SLJREVIEW.XML', element => 'SLJREVIEW'},
 194     {title => 'CHOICE Review', file => 'CHREVIEW.XML', element => 'CHREVIEW'},
 195     {title => 'Booklist Review', file => 'BLREVIEW.XML', element => 'BLREVIEW'},
 196     {title => 'Horn Book Review', file => 'HBREVIEW.XML', element => 'HBREVIEW'},
 197     {title => 'Kirkus Book Review', file => 'KIREVIEW.XML', element => 'KIREVIEW'},
 198     {title => 'Criticas Review', file => 'CRITICASREVIEW.XML', element => 'CRITICASREVIEW'},
 199     {title => 'Spanish Review', file => 'SPREVIEW.XML', element => 'SPREVIEW'},
 200     ];
 201
 202     for my $source (@$review_sources) {
 203         if ($syndetics_elements->{$source->{element}} and $source->{element} =~ $syndetics_elements->{$source->{element}}) {
 204
 205         } else {
 206             #warn "Skipping $source->{element} doesn't match $syndetics_elements->{$source->{element}} \n";
 207             next;
 208         }
 209         my $url = "http://syndetics.com/index.aspx?isbn=$isbn/$source->{file}&client=$syndetics_client_code&type=xw10&upc=$upc&oclc=$oclc";
 210
 211         my $ua = LWP::UserAgent->new;
 212         $ua->timeout(10);
 213         $ua->env_proxy;
 214
 215         my $response = $ua->get($url);
 216         unless ($response->content_type =~ /xml/) {
 217             next;
 218         }
 219
 220         my $content = $response->content;
 221         warn "could not retrieve $url" unless $content;
 222         my $xmlsimple = XML::Simple->new();
 223         eval {
 224         $response = $xmlsimple->XMLin(
 225             $content,
 226             ForceContent => 1,
 227             forcearray => [ qw(Fld520) ]
 228         ) unless !$content;
 229         };
 230
 231         for my $subfield_a (@{$response->{VarFlds}->{VarDFlds}->{Notes}->{Fld520}}) {
 232             my @content;
 233             # this is absurd, but sometimes this data serializes differently
 234             if(ref($subfield_a->{a}->{content}) eq 'ARRAY') {
 235                 for my $content (@{$subfield_a->{a}->{content}}) {
 236                     push @content, {content => $content};
 237                 }
 238             }
 239             else {
 240                 push @content, {content => $subfield_a->{a}->{content}};
 241             }
 242             push @reviews, {title => $source->{title}, reviews => \@content};
 243         }
 244     }
 245     return \@reviews;
 246 }
 247
 248 sub get_syndetics_editions {
 249     my ( $isbn,$upc,$oclc ) = @_;
 250
 251     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
 252     my $syndetics_client_code = C4::Context->preference('SyndeticsClientCode');
 253
 254     my $url = "http://syndetics.com/index.aspx?isbn=$isbn/FICTION.XML&client=$syndetics_client_code&type=xw10&upc=$upc&oclc=$oclc";
 255     my $ua = LWP::UserAgent->new;
 256     $ua->timeout(10);
 257     $ua->env_proxy;
 258
 259     my $response = $ua->get($url);
 260     unless ($response->content_type =~ /xml/) {
 261         return;
 262     }
 263
 264     my $content = $response->content;
 265
 266     warn "could not retrieve $url" unless $content;
 267     my $xmlsimple = XML::Simple->new();
 268     $response = $xmlsimple->XMLin(
 269         $content,
 270         forcearray => [ qw(Fld020) ],
 271     ) unless !$content;
 272     # manipulate response USMARC VarFlds VarDFlds Notes Fld520 a
 273     my $similar_items;
 274     $similar_items = \@{$response->{VarFlds}->{VarDFlds}->{NumbCode}->{Fld020}} if $response;
 275     return $similar_items if $similar_items;
 276 }
 277
 278 sub get_syndetics_anotes {
 279     my ( $isbn,$upc,$oclc) = @_;
 280
 281     # grab the AWSAccessKeyId: mine is '0V5RRRRJZ3HR2RQFNHR2'
 282     my $syndetics_client_code = C4::Context->preference('SyndeticsClientCode');
 283
 284     my $url = "http://syndetics.com/index.aspx?isbn=$isbn/ANOTES.XML&client=$syndetics_client_code&type=xw10&upc=$upc&oclc=$oclc";
 285     my $ua = LWP::UserAgent->new;
 286     $ua->timeout(10);
 287     $ua->env_proxy;
 288
 289     my $response = $ua->get($url);
 290     unless ($response->content_type =~ /xml/) {
 291         return;
 292     }
 293
 294     my $content = $response->content;
 295
 296     warn "could not retrieve $url" unless $content;
 297     my $xmlsimple = XML::Simple->new();
 298     $response = $xmlsimple->XMLin(
 299         $content,
 300         forcearray => [ qw(Fld980) ],
 301         ForceContent => 1,
 302     ) unless !$content;
 303     my @anotes;
 304     for my $fld980 (@{$response->{VarFlds}->{VarDFlds}->{SSIFlds}->{Fld980}}) {
 305         # this is absurd, but sometimes this data serializes differently
 306         if(ref($fld980->{a}->{content}) eq 'ARRAY') {
 307             for my $content (@{$fld980->{a}->{content}}) {
 308                 push @anotes, {content => $content};
 309
 310             }
 311         }
 312         else {
 313             push @anotes, {content => $fld980->{a}->{content}};
 314         }
 315     }
 316     return \@anotes;
 317 }
 318
 319 1;
 320 __END__
 321
 322 =head1 NOTES
 323
 324 =head1 AUTHOR
 325
 326 Joshua Ferraro <jmf@liblime.com>
 327
 328 =cut