C4/XSLT.pm

   1 package C4::XSLT;
   2 # Copyright (C) 2006 LibLime
   3 # <jmf at liblime dot com>
   4 # Parts Copyright Katrin Fischer 2011
   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
  17 # with Koha; if not, write to the Free Software Foundation, Inc.,
  18 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19
  20 use strict;
  21 use warnings;
  22
  23 use C4::Context;
  24 use C4::Branch;
  25 use C4::Items;
  26 use C4::Koha;
  27 use C4::Biblio;
  28 use C4::Circulation;
  29 use C4::Reserves;
  30 use C4::Output qw//;
  31 use Encode;
  32 use XML::LibXML;
  33 use XML::LibXSLT;
  34
  35 use vars qw($VERSION @ISA @EXPORT);
  36
  37 BEGIN {
  38     require Exporter;
  39     $VERSION = 0.03;
  40     @ISA = qw(Exporter);
  41     @EXPORT = qw(
  42         &XSLTParse4Display
  43     );
  44 }
  45
  46 =head1 NAME
  47
  48 C4::XSLT - Functions for displaying XSLT-generated content
  49
  50 =head1 FUNCTIONS
  51
  52 =head2 transformMARCXML4XSLT
  53
  54 Replaces codes with authorized values in a MARC::Record object
  55
  56 =cut
  57
  58 sub transformMARCXML4XSLT {
  59     my ($biblionumber, $record) = @_;
  60     my $frameworkcode = GetFrameworkCode($biblionumber);
  61     my $tagslib = &GetMarcStructure(1,$frameworkcode);
  62     my @fields;
  63     # FIXME: wish there was a better way to handle exceptions
  64     eval {
  65         @fields = $record->fields();
  66     };
  67     if ($@) { warn "PROBLEM WITH RECORD"; next; }
  68     my $av = getAuthorisedValues4MARCSubfields($frameworkcode);
  69     foreach my $tag ( keys %$av ) {
  70         foreach my $field ( $record->field( $tag ) ) {
  71             if ( $av->{ $tag } ) {
  72                 my @new_subfields = ();
  73                 for my $subfield ( $field->subfields() ) {
  74                     my ( $letter, $value ) = @$subfield;
  75                     $value = GetAuthorisedValueDesc( $tag, $letter, $value, '', $tagslib )
  76                         if $av->{ $tag }->{ $letter };
  77                     push( @new_subfields, $letter, $value );
  78                 }
  79                 $field ->replace_with( MARC::Field->new(
  80                     $tag,
  81                     $field->indicator(1),
  82                     $field->indicator(2),
  83                     @new_subfields
  84                 ) );
  85             }
  86         }
  87     }
  88     return $record;
  89 }
  90
  91 =head2 getAuthorisedValues4MARCSubfields
  92
  93 Returns a ref of hash of ref of hash for tag -> letter controled by authorised values
  94
  95 =cut
  96
  97 # Cache for tagfield-tagsubfield to decode per framework.
  98 # Should be preferably be placed in Koha-core...
  99 my %authval_per_framework;
 100
 101 sub getAuthorisedValues4MARCSubfields {
 102     my ($frameworkcode) = @_;
 103     unless ( $authval_per_framework{ $frameworkcode } ) {
 104         my $dbh = C4::Context->dbh;
 105         my $sth = $dbh->prepare("SELECT DISTINCT tagfield, tagsubfield
 106                                  FROM marc_subfield_structure
 107                                  WHERE authorised_value IS NOT NULL
 108                                    AND authorised_value!=''
 109                                    AND frameworkcode=?");
 110         $sth->execute( $frameworkcode );
 111         my $av = { };
 112         while ( my ( $tag, $letter ) = $sth->fetchrow() ) {
 113             $av->{ $tag }->{ $letter } = 1;
 114         }
 115         $authval_per_framework{ $frameworkcode } = $av;
 116     }
 117     return $authval_per_framework{ $frameworkcode };
 118 }
 119
 120 my $stylesheet;
 121
 122 sub XSLTParse4Display {
 123     my ( $biblionumber, $orig_record, $xsl_suffix, $interface, $fixamps ) = @_;
 124     $interface = 'opac' unless $interface;
 125     # grab the XML, run it through our stylesheet, push it out to the browser
 126     my $record = transformMARCXML4XSLT($biblionumber, $orig_record);
 127     #return $record->as_formatted();
 128     my $itemsxml  = buildKohaItemsNamespace($biblionumber);
 129     my $xmlrecord = $record->as_xml(C4::Context->preference('marcflavour'));
 130     my $sysxml = "<sysprefs>\n";
 131     foreach my $syspref ( qw/ hidelostitems OPACURLOpenInNewWindow
 132                               DisplayOPACiconsXSLT URLLinkText viewISBD
 133                               OPACBaseURL TraceCompleteSubfields
 134                               UseAuthoritiesForTracings TraceSubjectSubdivisions
 135                               Display856uAsImage OPACDisplay856uAsImage
 136                               UseControlNumber / )
 137     {
 138         my $sp = C4::Context->preference( $syspref );
 139         next unless defined($sp);
 140         $sysxml .= "<syspref name=\"$syspref\">$sp</syspref>\n";
 141     }
 142     $sysxml .= "</sysprefs>\n";
 143     $xmlrecord =~ s/\<\/record\>/$itemsxml$sysxml\<\/record\>/;
 144     if ($fixamps) { # We need to correct the ampersand entities that Zebra outputs
 145         $xmlrecord =~ s/\&amp;amp;/\&amp;/g;
 146     }
 147     $xmlrecord =~ s/\& /\&amp\; /;
 148     $xmlrecord =~ s/\&amp\;amp\; /\&amp\; /;
 149
 150     my $parser = XML::LibXML->new();
 151     # don't die when you find &, >, etc
 152     $parser->recover_silently(0);
 153     my $source = $parser->parse_string($xmlrecord);
 154     unless ( $stylesheet ) {
 155         my $xslt = XML::LibXSLT->new();
 156         my $xslfile;
 157         if ($interface eq 'intranet') {
 158             $xslfile = C4::Context->config('intrahtdocs') .
 159                       '/' . C4::Context->preference("template") .
 160                       '/' . C4::Output::_current_language() .
 161                       '/xslt/' .
 162                       C4::Context->preference('marcflavour') .
 163                       "slim2intranet$xsl_suffix.xsl";
 164         } else {
 165             $xslfile = C4::Context->config('opachtdocs') .
 166                       '/' . C4::Context->preference("opacthemes") .
 167                       '/' . C4::Output::_current_language() .
 168                       '/xslt/' .
 169                       C4::Context->preference('marcflavour') .
 170                       "slim2OPAC$xsl_suffix.xsl";
 171         }
 172         my $style_doc = $parser->parse_file($xslfile);
 173         $stylesheet = $xslt->parse_stylesheet($style_doc);
 174     }
 175     my $results = $stylesheet->transform($source);
 176     my $newxmlrecord = $stylesheet->output_string($results);
 177     return $newxmlrecord;
 178 }
 179
 180 sub buildKohaItemsNamespace {
 181     my ($biblionumber) = @_;
 182     my @items = C4::Items::GetItemsInfo($biblionumber);
 183     my $branches = GetBranches();
 184     my $itemtypes = GetItemTypes();
 185     my $xml = '';
 186     for my $item (@items) {
 187         my $status;
 188
 189         my ( $transfertwhen, $transfertfrom, $transfertto ) = C4::Circulation::GetTransfers($item->{itemnumber});
 190
 191         my ( $reservestatus, $reserveitem ) = C4::Reserves::CheckReserves($item->{itemnumber});
 192
 193         if ( $itemtypes->{ $item->{itype} }->{notforloan} || $item->{notforloan} || $item->{onloan} || $item->{wthdrawn} || $item->{itemlost} || $item->{damaged} ||
 194              (defined $transfertwhen && $transfertwhen ne '') || $item->{itemnotforloan} || (defined $reservestatus && $reservestatus eq "Waiting") ){
 195             if ( $item->{notforloan} < 0) {
 196                 $status = "On order";
 197             }
 198             if ( $item->{itemnotforloan} > 0 || $item->{notforloan} > 0 || $itemtypes->{ $item->{itype} }->{notforloan} == 1 ) {
 199                 $status = "reference";
 200             }
 201             if ($item->{onloan}) {
 202                 $status = "Checked out";
 203             }
 204             if ( $item->{wthdrawn}) {
 205                 $status = "Withdrawn";
 206             }
 207             if ($item->{itemlost}) {
 208                 $status = "Lost";
 209             }
 210             if ($item->{damaged}) {
 211                 $status = "Damaged";
 212             }
 213             if (defined $transfertwhen && $transfertwhen ne '') {
 214                 $status = 'In transit';
 215             }
 216             if (defined $reservestatus && $reservestatus eq "Waiting") {
 217                 $status = 'Waiting';
 218             }
 219         } else {
 220             $status = "available";
 221         }
 222         my $homebranch = xml_escape($branches->{$item->{homebranch}}->{'branchname'});
 223             my $itemcallnumber = xml_escape($item->{itemcallnumber});
 224         $xml.= "<item><homebranch>$homebranch</homebranch>".
 225                 "<status>$status</status>".
 226                 "<itemcallnumber>".$itemcallnumber."</itemcallnumber>"
 227         . "</item>";
 228
 229     }
 230     $xml = "<items xmlns=\"http://www.koha-community.org/items\">".$xml."</items>";
 231     return $xml;
 232 }
 233
 234
 235
 236 1;
 237 __END__
 238
 239 =head1 NOTES
 240
 241 =cut
 242
 243 =head1 AUTHOR
 244
 245 Joshua Ferraro <jmf@liblime.com>
 246
 247 =cut