Bug 13851: Fix typo in POD
[koha.git] / catalogue / detail.pl
blobb7ba9a4266dd663e60f0512b87b71b4bd8c57609
1 #!/usr/bin/perl
3 # This file is part of Koha.
5 # Koha is free software; you can redistribute it and/or modify it
6 # under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 3 of the License, or
8 # (at your option) any later version.
10 # Koha is distributed in the hope that it will be useful, but
11 # WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with Koha; if not, see <http://www.gnu.org/licenses>.
19 use strict;
20 use warnings;
22 use CGI qw ( -utf8 );
23 use C4::Acquisition qw( GetHistory );
24 use C4::Auth;
25 use C4::Dates qw/format_date/;
26 use C4::Koha;
27 use C4::Serials; #uses getsubscriptionfrom biblionumber
28 use C4::Output;
29 use C4::Biblio;
30 use C4::Items;
31 use C4::Circulation;
32 use C4::Branch;
33 use C4::Reserves;
34 use C4::Members; # to use GetMember
35 use C4::Serials;
36 use C4::XISBN qw(get_xisbns get_biblionumber_from_isbn);
37 use C4::External::Amazon;
38 use C4::Search; # enabled_staff_search_views
39 use C4::Tags qw(get_tags);
40 use C4::VirtualShelves;
41 use C4::XSLT;
42 use C4::Images;
43 use Koha::DateUtils;
44 use C4::HTML5Media;
45 use C4::CourseReserves qw(GetItemCourseReservesInfo);
46 use C4::Acquisition qw(GetOrdersByBiblionumber);
48 my $query = CGI->new();
50 my $analyze = $query->param('analyze');
52 my ( $template, $borrowernumber, $cookie, $flags ) = get_template_and_user(
54 template_name => 'catalogue/detail.tt',
55 query => $query,
56 type => "intranet",
57 authnotrequired => 0,
58 flagsrequired => { catalogue => 1 },
62 my $biblionumber = $query->param('biblionumber');
63 my $record = GetMarcBiblio($biblionumber);
65 if ( not defined $record ) {
66 # biblionumber invalid -> report and exit
67 $template->param( unknownbiblionumber => 1,
68 biblionumber => $biblionumber );
69 output_html_with_http_headers $query, $cookie, $template->output;
70 exit;
73 if($query->cookie("holdfor")){
74 my $holdfor_patron = GetMember('borrowernumber' => $query->cookie("holdfor"));
75 $template->param(
76 holdfor => $query->cookie("holdfor"),
77 holdfor_surname => $holdfor_patron->{'surname'},
78 holdfor_firstname => $holdfor_patron->{'firstname'},
79 holdfor_cardnumber => $holdfor_patron->{'cardnumber'},
83 my $fw = GetFrameworkCode($biblionumber);
84 my $showallitems = $query->param('showallitems');
85 my $marcflavour = C4::Context->preference("marcflavour");
87 # XSLT processing of some stuff
88 if (C4::Context->preference("XSLTDetailsDisplay") ) {
89 $template->param('XSLTDetailsDisplay' =>'1',
90 'XSLTBloc' => XSLTParse4Display($biblionumber, $record, "XSLTDetailsDisplay") );
93 $template->param( 'SpineLabelShowPrintOnBibDetails' => C4::Context->preference("SpineLabelShowPrintOnBibDetails") );
94 $template->param( ocoins => GetCOinSBiblio($record) );
96 # some useful variables for enhanced content;
97 # in each case, we're grabbing the first value we find in
98 # the record and normalizing it
99 my $upc = GetNormalizedUPC($record,$marcflavour);
100 my $ean = GetNormalizedEAN($record,$marcflavour);
101 my $oclc = GetNormalizedOCLCNumber($record,$marcflavour);
102 my $isbn = GetNormalizedISBN(undef,$record,$marcflavour);
104 $template->param(
105 normalized_upc => $upc,
106 normalized_ean => $ean,
107 normalized_oclc => $oclc,
108 normalized_isbn => $isbn,
111 my $marcnotesarray = GetMarcNotes( $record, $marcflavour );
112 my $marcisbnsarray = GetMarcISBN( $record, $marcflavour );
113 my $marcauthorsarray = GetMarcAuthors( $record, $marcflavour );
114 my $marcsubjctsarray = GetMarcSubjects( $record, $marcflavour );
115 my $marcseriesarray = GetMarcSeries($record,$marcflavour);
116 my $marcurlsarray = GetMarcUrls ($record,$marcflavour);
117 my $marchostsarray = GetMarcHosts($record,$marcflavour);
118 my $subtitle = GetRecordValue('subtitle', $record, $fw);
120 # Get Branches, Itemtypes and Locations
121 my $branches = GetBranches();
122 my $itemtypes = GetItemTypes();
123 my $dbh = C4::Context->dbh;
125 my @all_items = GetItemsInfo( $biblionumber );
126 my @items;
127 for my $itm (@all_items) {
128 push @items, $itm unless ( $itm->{itemlost} && GetHideLostItemsPreference($borrowernumber) && !$showallitems);
131 # flag indicating existence of at least one item linked via a host record
132 my $hostrecords;
133 # adding items linked via host biblios
134 my @hostitems = GetHostItemsInfo($record);
135 if (@hostitems){
136 $hostrecords =1;
137 push (@items,@hostitems);
140 my $dat = &GetBiblioData($biblionumber);
142 #coping with subscriptions
143 my $subscriptionsnumber = CountSubscriptionFromBiblionumber($biblionumber);
144 my @subscriptions = SearchSubscriptions({ biblionumber => $biblionumber, orderby => 'title' });
145 my @subs;
147 foreach my $subscription (@subscriptions) {
148 my %cell;
149 my $serials_to_display;
150 $cell{subscriptionid} = $subscription->{subscriptionid};
151 $cell{subscriptionnotes} = $subscription->{internalnotes};
152 $cell{missinglist} = $subscription->{missinglist};
153 $cell{librariannote} = $subscription->{librariannote};
154 $cell{branchcode} = $subscription->{branchcode};
155 $cell{branchname} = GetBranchName($subscription->{branchcode});
156 $cell{hasalert} = $subscription->{hasalert};
157 $cell{callnumber} = $subscription->{callnumber};
158 $cell{closed} = $subscription->{closed};
159 #get the three latest serials.
160 $serials_to_display = $subscription->{staffdisplaycount};
161 $serials_to_display = C4::Context->preference('StaffSerialIssueDisplayCount') unless $serials_to_display;
162 $cell{staffdisplaycount} = $serials_to_display;
163 $cell{latestserials} =
164 GetLatestSerials( $subscription->{subscriptionid}, $serials_to_display );
165 push @subs, \%cell;
169 # Get acquisition details
170 if ( C4::Context->preference('AcquisitionDetails') ) {
171 my $orders = C4::Acquisition::GetHistory( biblionumber => $biblionumber, get_canceled_order => 1 );
172 $template->param(
173 orders => $orders,
177 if ( defined $dat->{'itemtype'} ) {
178 $dat->{imageurl} = getitemtypeimagelocation( 'intranet', $itemtypes->{ $dat->{itemtype} }{imageurl} );
181 $dat->{'count'} = scalar @all_items + @hostitems;
182 $dat->{'showncount'} = scalar @items + @hostitems;
183 $dat->{'hiddencount'} = scalar @all_items + @hostitems - scalar @items;
185 my $shelflocations = GetKohaAuthorisedValues('items.location', $fw);
186 my $collections = GetKohaAuthorisedValues('items.ccode' , $fw);
187 my $copynumbers = GetKohaAuthorisedValues('items.copynumber', $fw);
188 my (@itemloop, @otheritemloop, %itemfields);
189 my $norequests = 1;
190 my $authvalcode_items_itemlost = GetAuthValCode('items.itemlost',$fw);
191 my $authvalcode_items_damaged = GetAuthValCode('items.damaged', $fw);
193 my $analytics_flag;
194 my $materials_flag; # set this if the items have anything in the materials field
195 my $currentbranch = C4::Context->userenv ? C4::Context->userenv->{branch} : undef;
196 if ($currentbranch and C4::Context->preference('SeparateHoldings')) {
197 $template->param(SeparateHoldings => 1);
199 my $separatebranch = C4::Context->preference('SeparateHoldingsBranch') || 'homebranch';
200 foreach my $item (@items) {
201 my $itembranchcode = $item->{$separatebranch};
202 $item->{homebranch} = GetBranchName($item->{homebranch});
204 # can place holds defaults to yes
205 $norequests = 0 unless ( ( $item->{'notforloan'} > 0 ) || ( $item->{'itemnotforloan'} > 0 ) );
207 $item->{imageurl} = defined $item->{itype} ? getitemtypeimagelocation('intranet', $itemtypes->{ $item->{itype} }{imageurl})
208 : '';
210 foreach (qw(datelastseen onloan)) {
211 $item->{$_} = format_date($item->{$_});
213 $item->{datedue} = format_sqldatetime($item->{datedue});
214 # item damaged, lost, withdrawn loops
215 $item->{itemlostloop} = GetAuthorisedValues($authvalcode_items_itemlost, $item->{itemlost}) if $authvalcode_items_itemlost;
216 if ($item->{damaged}) {
217 $item->{itemdamagedloop} = GetAuthorisedValues($authvalcode_items_damaged, $item->{damaged}) if $authvalcode_items_damaged;
219 #get shelf location and collection code description if they are authorised value.
220 # same thing for copy number
221 my $shelfcode = $item->{'location'};
222 $item->{'location'} = $shelflocations->{$shelfcode} if ( defined( $shelfcode ) && defined($shelflocations) && exists( $shelflocations->{$shelfcode} ) );
223 my $ccode = $item->{'ccode'};
224 $item->{'ccode'} = $collections->{$ccode} if ( defined( $ccode ) && defined($collections) && exists( $collections->{$ccode} ) );
225 my $copynumber = $item->{'copynumber'};
226 $item->{'copynumber'} = $copynumbers->{$copynumber} if ( defined($copynumber) && defined($copynumbers) && exists( $copynumbers->{$copynumber} ) );
227 foreach (qw(ccode enumchron copynumber stocknumber itemnotes uri)) {
228 $itemfields{$_} = 1 if ( $item->{$_} );
231 # checking for holds
232 my ($reservedate,$reservedfor,$expectedAt,undef,$wait) = GetReservesFromItemnumber($item->{itemnumber});
233 my $ItemBorrowerReserveInfo = GetMemberDetails( $reservedfor, 0);
235 if (C4::Context->preference('HidePatronName')){
236 $item->{'hidepatronname'} = 1;
239 if ( defined $reservedate ) {
240 $item->{backgroundcolor} = 'reserved';
241 $item->{reservedate} = format_date($reservedate);
242 $item->{ReservedForBorrowernumber} = $reservedfor;
243 $item->{ReservedForSurname} = $ItemBorrowerReserveInfo->{'surname'};
244 $item->{ReservedForFirstname} = $ItemBorrowerReserveInfo->{'firstname'};
245 $item->{ExpectedAtLibrary} = $branches->{$expectedAt}{branchname};
246 $item->{Reservedcardnumber} = $ItemBorrowerReserveInfo->{'cardnumber'};
247 # Check waiting status
248 $item->{waitingdate} = $wait;
252 # Check the transit status
253 my ( $transfertwhen, $transfertfrom, $transfertto ) = GetTransfers($item->{itemnumber});
254 if ( defined( $transfertwhen ) && ( $transfertwhen ne '' ) ) {
255 $item->{transfertwhen} = format_date($transfertwhen);
256 $item->{transfertfrom} = $branches->{$transfertfrom}{branchname};
257 $item->{transfertto} = $branches->{$transfertto}{branchname};
258 $item->{nocancel} = 1;
261 # item has a host number if its biblio number does not match the current bib
262 if ($item->{biblionumber} ne $biblionumber){
263 $item->{hostbiblionumber} = $item->{biblionumber};
264 $item->{hosttitle} = GetBiblioData($item->{biblionumber})->{title};
267 #count if item is used in analytical bibliorecords
268 my $countanalytics= GetAnalyticsCount($item->{itemnumber});
269 if ($countanalytics > 0){
270 $analytics_flag=1;
271 $item->{countanalytics} = $countanalytics;
274 if (defined($item->{'materials'}) && $item->{'materials'} =~ /\S/){
275 $materials_flag = 1;
278 if ( C4::Context->preference('UseCourseReserves') ) {
279 $item->{'course_reserves'} = GetItemCourseReservesInfo( itemnumber => $item->{'itemnumber'} );
282 if ($currentbranch and $currentbranch ne "NO_LIBRARY_SET"
283 and C4::Context->preference('SeparateHoldings')) {
284 if ($itembranchcode and $itembranchcode eq $currentbranch) {
285 push @itemloop, $item;
286 } else {
287 push @otheritemloop, $item;
289 } else {
290 push @itemloop, $item;
294 # Display only one tab if one items list is empty
295 if (scalar(@itemloop) == 0 || scalar(@otheritemloop) == 0) {
296 $template->param(SeparateHoldings => 0);
297 if (scalar(@itemloop) == 0) {
298 @itemloop = @otheritemloop;
302 $template->param( norequests => $norequests );
303 $template->param(
304 MARCNOTES => $marcnotesarray,
305 MARCSUBJCTS => $marcsubjctsarray,
306 MARCAUTHORS => $marcauthorsarray,
307 MARCSERIES => $marcseriesarray,
308 MARCURLS => $marcurlsarray,
309 MARCISBNS => $marcisbnsarray,
310 MARCHOSTS => $marchostsarray,
311 subtitle => $subtitle,
312 itemdata_ccode => $itemfields{ccode},
313 itemdata_enumchron => $itemfields{enumchron},
314 itemdata_uri => $itemfields{uri},
315 itemdata_copynumber => $itemfields{copynumber},
316 itemdata_stocknumber => $itemfields{stocknumber},
317 volinfo => $itemfields{enumchron},
318 itemdata_itemnotes => $itemfields{itemnotes},
319 z3950_search_params => C4::Search::z3950_search_args($dat),
320 hostrecords => $hostrecords,
321 analytics_flag => $analytics_flag,
322 C4::Search::enabled_staff_search_views,
323 materials => $materials_flag,
326 if (C4::Context->preference("AlternateHoldingsField") && scalar @items == 0) {
327 my $fieldspec = C4::Context->preference("AlternateHoldingsField");
328 my $subfields = substr $fieldspec, 3;
329 my $holdingsep = C4::Context->preference("AlternateHoldingsSeparator") || ' ';
330 my @alternateholdingsinfo = ();
331 my @holdingsfields = $record->field(substr $fieldspec, 0, 3);
333 for my $field (@holdingsfields) {
334 my %holding = ( holding => '' );
335 my $havesubfield = 0;
336 for my $subfield ($field->subfields()) {
337 if ((index $subfields, $$subfield[0]) >= 0) {
338 $holding{'holding'} .= $holdingsep if (length $holding{'holding'} > 0);
339 $holding{'holding'} .= $$subfield[1];
340 $havesubfield++;
343 if ($havesubfield) {
344 push(@alternateholdingsinfo, \%holding);
348 $template->param(
349 ALTERNATEHOLDINGS => \@alternateholdingsinfo,
353 my @results = ( $dat, );
354 foreach ( keys %{$dat} ) {
355 $template->param( "$_" => defined $dat->{$_} ? $dat->{$_} : '' );
358 # does not work: my %views_enabled = map { $_ => 1 } $template->query(loop => 'EnableViews');
359 # method query not found?!?!
360 $template->param( AmazonTld => get_amazon_tld() ) if ( C4::Context->preference("AmazonCoverImages"));
361 $template->param(
362 itemloop => \@itemloop,
363 otheritemloop => \@otheritemloop,
364 biblionumber => $biblionumber,
365 ($analyze? 'analyze':'detailview') =>1,
366 subscriptions => \@subs,
367 subscriptionsnumber => $subscriptionsnumber,
368 subscriptiontitle => $dat->{title},
369 searchid => $query->param('searchid'),
372 # $debug and $template->param(debug_display => 1);
374 # Lists
376 if (C4::Context->preference("virtualshelves") ) {
377 $template->param( 'GetShelves' => GetBibliosShelves( $biblionumber ) );
380 # XISBN Stuff
381 if (C4::Context->preference("FRBRizeEditions")==1) {
382 eval {
383 $template->param(
384 XISBNS => get_xisbns($isbn)
387 if ($@) { warn "XISBN Failed $@"; }
390 if ( C4::Context->preference("LocalCoverImages") == 1 ) {
391 my @images = ListImagesForBiblio($biblionumber);
392 $template->{VARS}->{localimages} = \@images;
395 # HTML5 Media
396 if ( (C4::Context->preference("HTML5MediaEnabled") eq 'both') or (C4::Context->preference("HTML5MediaEnabled") eq 'staff') ) {
397 $template->param( C4::HTML5Media->gethtml5media($record));
400 # Displaying tags
402 my $tag_quantity;
403 if (C4::Context->preference('TagsEnabled') and $tag_quantity = C4::Context->preference('TagsShowOnDetail')) {
404 $template->param(
405 TagsEnabled => 1,
406 TagsShowOnDetail => $tag_quantity
408 $template->param(TagLoop => get_tags({biblionumber=>$biblionumber, approved=>1,
409 'sort'=>'-weight', limit=>$tag_quantity}));
412 #we only need to pass the number of holds to the template
413 my $holds = C4::Reserves::GetReservesFromBiblionumber({ biblionumber => $biblionumber, all_dates => 1 });
414 $template->param( holdcount => scalar ( @$holds ) );
416 my $StaffDetailItemSelection = C4::Context->preference('StaffDetailItemSelection');
417 if ($StaffDetailItemSelection) {
418 # Only enable item selection if user can execute at least one action
419 if (
420 $flags->{superlibrarian}
421 || (
422 ref $flags->{tools} eq 'HASH' && (
423 $flags->{tools}->{items_batchmod} # Modify selected items
424 || $flags->{tools}->{items_batchdel} # Delete selected items
427 || ( ref $flags->{tools} eq '' && $flags->{tools} )
430 $template->param(
431 StaffDetailItemSelection => $StaffDetailItemSelection );
435 my @allorders_using_biblio = GetOrdersByBiblionumber ($biblionumber);
436 my @deletedorders_using_biblio;
437 my @orders_using_biblio;
438 my @baskets_orders;
439 my @baskets_deletedorders;
441 foreach my $myorder (@allorders_using_biblio) {
442 my $basket = $myorder->{'basketno'};
443 if ((defined $myorder->{'datecancellationprinted'}) and ($myorder->{'datecancellationprinted'} ne '0000-00-00') ){
444 push @deletedorders_using_biblio, $myorder;
445 unless (grep(/^$basket$/, @baskets_deletedorders)){
446 push @baskets_deletedorders,$myorder->{'basketno'};
449 else {
450 push @orders_using_biblio, $myorder;
451 unless (grep(/^$basket$/, @baskets_orders)){
452 push @baskets_orders,$myorder->{'basketno'};
457 my $count_orders_using_biblio = scalar @orders_using_biblio ;
458 $template->param (countorders => $count_orders_using_biblio);
460 my $count_deletedorders_using_biblio = scalar @deletedorders_using_biblio ;
461 $template->param (countdeletedorders => $count_deletedorders_using_biblio);
463 $template->param (basketsorders => \@baskets_orders);
464 $template->param (basketsdeletedorders => \@baskets_deletedorders);
466 output_html_with_http_headers $query, $cookie, $template->output;