3 # Please use 8-character tabs for this file (indents are every 4 characters)
5 # written 8/5/2002 by Finlay
6 # script to execute issuing of books
8 # Copyright 2000-2002 Katipo Communications
10 # This file is part of Koha.
12 # Koha is free software; you can redistribute it and/or modify it under the
13 # terms of the GNU General Public License as published by the Free Software
14 # Foundation; either version 2 of the License, or (at your option) any later
17 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
18 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
19 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
21 # You should have received a copy of the GNU General Public License along with
22 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
23 # Suite 330, Boston, MA 02111-1307 USA
31 use C4::Branch; # GetBranches
32 use C4::Koha; # GetPrinter
54 # new op dev the branch and the printer are now defined by the userenv
55 # but first we have to check if someone has tried to change them
57 my $branch = $query->param('branch');
59 # update our session so the userenv is updated
60 my $dbh=C4::Context->dbh;
61 my $sessionID = $query->cookie("CGISESSID") ;
62 my $session = new CGI::Session("driver:MySQL", $sessionID, {Handle=>$dbh});
63 $session->param('branch',$branch);
64 my $branchname = GetBranchName($branch);
65 $session->param('branchname',$branchname);
68 my $printer = $query->param('printer');
70 # update our session so the userenv is updated
71 my $dbh=C4::Context->dbh;
72 my $sessionID = $query->cookie("CGISESSID") ;
73 my $session = new CGI::Session("driver:MySQL", $sessionID, {Handle=>$dbh});
74 $session->param('branchprinter',$printer);
79 my ( $template, $loggedinuser, $cookie ) = get_template_and_user (
81 template_name => 'circ/circulation.tmpl',
85 flagsrequired => { circulate => 1 },
88 my $branches = GetBranches();
90 my $printers = GetPrinters();
93 my $findborrower = $query->param('findborrower');
94 $findborrower =~ s|,| |g;
95 #$findborrower =~ s|'| |g;
96 my $borrowernumber = $query->param('borrowernumber');
98 $branch = C4::Context->userenv->{'branch'};
99 $printer = C4::Context->userenv->{'branchprinter'};
102 # If Autolocated is not activated, we show the Circulation Parameters to chage settings of librarian
103 if (C4::Context->preference("AutoLocation") ne 1)
110 my $barcode = $query->param('barcode') || '';
111 my $year = $query->param('year');
112 my $month = $query->param('month');
113 my $day = $query->param('day');
114 my $stickyduedate = $query->param('stickyduedate');
115 my $issueconfirmed = $query->param('issueconfirmed');
116 my $cancelreserve = $query->param('cancelreserve');
117 my $organisation = $query->param('organisations');
118 my $print = $query->param('print');
123 # if ($query->param('setcookies')) {
124 # $branchcookie = $query->cookie(-name=>'branch', -value=>"$branch", -expires=>'+1y');
125 # $printercookie = $query->cookie(-name=>'printer', -value=>"$printer", -expires=>'+1y');
130 my @datearr = localtime( time() );
132 # FIXME - Could just use POSIX::strftime("%Y%m%d", localtime);
134 ( 1900 + $datearr[5] )
135 . sprintf( "%0.2d", ( $datearr[4] + 1 ) )
136 . sprintf( "%0.2d", ( $datearr[3] ) );
138 # check and see if we should print
139 if ( $barcode eq '' && $print eq 'maybe' ) {
143 my $inprocess = $query->param('inprocess');
144 if ( $barcode eq '' ) {
150 if ( $barcode eq '' && $query->param('charges') eq 'yes' ) {
153 borrowernumber => $borrowernumber
157 if ( $print eq 'yes' && $borrowernumber ne '' ) {
158 printslip( $borrowernumber );
159 $query->param( 'borrowernumber', '' );
160 $borrowernumber = '';
164 # STEP 2 : FIND BORROWER
165 # if there is a list of find borrowers....
170 my ( $count, $borrowers ) =
171 SearchMember($findborrower, 'cardnumber', 'web' );
172 my @borrowers = @$borrowers;
173 if ( $#borrowers == -1 ) {
174 $query->param( 'findborrower', '' );
175 $message = "'$findborrower'";
177 elsif ( $#borrowers == 0 ) {
178 $query->param( 'borrowernumber', $borrowers[0]->{'borrowernumber'} );
179 $query->param( 'barcode', '' );
180 $borrowernumber = $borrowers[0]->{'borrowernumber'};
183 $borrowerslist = \@borrowers;
187 # get the borrower information.....
191 if ($borrowernumber) {
192 $borrower = GetMemberDetails( $borrowernumber, 0 );
193 my ( $od, $issue, $fines ) = GetMemberIssuesAndFines( $borrowernumber );
195 # Warningdate is the date that the warning starts appearing
196 my ( $today_year, $today_month, $today_day ) = Today();
197 my ( $warning_year, $warning_month, $warning_day ) = split /-/,
198 $borrower->{'dateexpiry'};
199 my ( $enrol_year, $enrol_month, $enrol_day ) = split /-/,
200 $borrower->{'dateenrolled'};
201 # Renew day is calculated by adding the enrolment period to today
202 my ( $renew_year, $renew_month, $renew_day ) =
203 Add_Delta_YM( $enrol_year, $enrol_month, $enrol_day,
204 0 , $borrower->{'enrolmentperiod'}) if ($enrol_year*$enrol_month*$enrol_day>0);
205 # if the expiry date is before today
206 if ( Date_to_Days( $today_year, $today_month, $today_day ) >
207 Date_to_Days( $warning_year, $warning_month, $warning_day ) )
210 #borrowercard expired or nearly expired, warn the librarian
213 warndeparture => format_date("$warning_year-$warning_month-$warning_day"),
214 renewaldate => "$renew_year-$renew_month-$renew_day"
217 # check for NotifyBorrowerDeparture
218 if (C4::Context->preference('NotifyBorrowerDeparture') &&
219 Date_to_Days(Add_Delta_Days($warning_year,$warning_month,$warning_day,- C4::Context->preference('NotifyBorrowerDeparture'))) <
220 Date_to_Days( $today_year, $today_month, $today_day ) )
222 $template->param("warndeparture" => 1);
226 issuecount => $issue,
237 $barcode = cuecatbarcodedecode($barcode);
238 my ( $datedue, $invalidduedate ) = fixdate( $year, $month, $day );
239 if ($issueconfirmed) {
240 AddIssue( $borrower, $barcode, $datedue, $cancelreserve );
244 my ( $error, $question ) =
245 CanBookBeIssued( $borrower, $barcode, $year, $month, $day,
249 # Get the item title for more information
250 my $getmessageiteminfo = GetBiblioFromItemNumber( undef, $barcode );
252 foreach my $impossible ( keys %$error ) {
254 $impossible => $$error{$impossible},
259 foreach my $needsconfirmation ( keys %$question ) {
261 $needsconfirmation => $$question{$needsconfirmation},
262 getTitleMessageIteminfo => $getmessageiteminfo->{'title'},
263 NEEDSCONFIRMATION => 1
272 if ( $noerror && ( $noquestion || $issueconfirmed ) ) {
273 AddIssue( $borrower, $barcode, $datedue );
278 # FIXME If the issue is confirmed, we launch another time borrdata2, now display the issue count after issue
279 my ( $od, $issue, $fines ) = GetMemberIssuesAndFines( $borrowernumber );
281 issuecount => $issue,
285 # reload the borrower info for the sake of reseting the flags.....
286 if ($borrowernumber) {
287 $borrower = GetMemberDetails( $borrowernumber, 0 );
290 ##################################################################################
292 # show all reserves of this borrower, and the position of the reservation ....
293 if ($borrowernumber) {
296 # now we show the status of the borrower's reservations
297 my @borrowerreserv = GetReservesFromBorrowernumber($borrowernumber );
299 my @WaitingReserveLoop;
301 foreach my $num_res (@borrowerreserv) {
303 my %getWaitingReserveInfo;
304 my $getiteminfo = GetBiblioFromItemNumber( $num_res->{'itemnumber'} );
305 my $itemtypeinfo = getitemtypeinfo( $getiteminfo->{'itemtype'} );
306 my ( $transfertwhen, $transfertfrom, $transfertto ) =
307 GetTransfers( $num_res->{'itemnumber'} );
309 $getreserv{waiting} = 0;
310 $getreserv{transfered} = 0;
311 $getreserv{nottransfered} = 0;
313 $getreserv{reservedate} = format_date( $num_res->{'reservedate'} );
314 $getreserv{biblionumber} = $getiteminfo->{'biblionumber'};
315 $getreserv{title} = $getiteminfo->{'title'};
316 $getreserv{itemtype} = $itemtypeinfo->{'description'};
317 $getreserv{author} = $getiteminfo->{'author'};
318 $getreserv{barcodereserv} = $getiteminfo->{'barcode'};
319 $getreserv{itemcallnumber} = $getiteminfo->{'itemcallnumber'};
321 # check if we have a waiting status for reservations
322 if ( $num_res->{'found'} eq 'W' ) {
323 $getreserv{color} = 'reserved';
324 $getreserv{waiting} = 1;
325 # genarate information displaying only waiting reserves
326 $getWaitingReserveInfo{title} = $getiteminfo->{'title'};
327 $getWaitingReserveInfo{itemtype} = $itemtypeinfo->{'description'};
328 $getWaitingReserveInfo{author} = $getiteminfo->{'author'};
329 $getWaitingReserveInfo{reservedate} = format_date( $num_res->{'reservedate'} );
330 if ($getiteminfo->{'holdingbranch'} ne $num_res->{'branchcode'} ) {
331 $getWaitingReserveInfo{waitingat} = GetBranchName( $num_res->{'branchcode'} );
335 # check transfers with the itemnumber foud in th reservation loop
336 if ($transfertwhen) {
337 $getreserv{color} = 'transfered';
338 $getreserv{transfered} = 1;
339 $getreserv{datesent} = format_date($transfertwhen);
340 $getreserv{frombranch} = GetBranchName($transfertfrom);
343 if ( ( $getiteminfo->{'holdingbranch'} ne $num_res->{'branchcode'} )
344 and not $transfertwhen )
346 $getreserv{nottransfered} = 1;
347 $getreserv{nottransferedby} =
348 GetBranchName( $getiteminfo->{'holdingbranch'} );
351 # if we don't have a reserv on item, we put the biblio infos and the waiting position
352 if ( $getiteminfo->{'title'} eq '' ) {
353 my $getbibinfo = GetBiblioItemData( $num_res->{'biblionumber'} );
354 my $getbibtype = getitemtypeinfo( $getbibinfo->{'itemtype'} );
355 $getreserv{color} = 'inwait';
356 $getreserv{title} = $getbibinfo->{'title'};
357 $getreserv{waitingposition} = $num_res->{'priority'};
358 $getreserv{nottransfered} = 0;
359 $getreserv{itemtype} = $getbibtype->{'description'};
360 $getreserv{author} = $getbibinfo->{'author'};
361 $getreserv{itemcallnumber} = '----------';
364 push( @reservloop, \%getreserv );
366 # if we have a reserve waiting, initiate waitingreserveloop
367 if ($getreserv{waiting} eq 1) {
368 push (@WaitingReserveLoop, \%getWaitingReserveInfo)
373 # return result to the template
375 countreserv => scalar @reservloop,
376 reservloop => \@reservloop ,
377 WaitingReserveLoop => \@WaitingReserveLoop,
381 # make the issued books table.
382 my $todaysissues = '';
387 ## ADDED BY JF: new itemtype issuingrules counter stuff
388 my $issued_itemtypes_loop;
389 my $issued_itemtypes_count;
390 my $issued_itemtypes_allowed_count; # hashref with total allowed by itemtype
391 my $issued_itemtypes_remaining; # hashref with remaining
392 my $issued_itemtypes_flags; #hashref that stores flags
396 # get each issue of the borrower & separate them in todayissues & previous issues
399 my ($countissues,$issueslist) = GetPendingIssues($borrower->{'borrowernumber'});
401 # split in 2 arrays for today & previous
402 my $dbh = C4::Context->dbh;
403 foreach my $it ( @$issueslist ) {
404 my $issuedate = $it->{'timestamp'};
405 $issuedate =~ s/-//g;
406 $issuedate = substr( $issuedate, 0, 8 );
408 # to let perl sort this correctly
409 $it->{'timestamp'} =~ s/(-|\:| )//g;
411 if ( $todaysdate == $issuedate ) {
414 $it->{'itemtype_charge'}
418 $borrower->{'borrowernumber'}
421 sprintf( "%.2f", $it->{'charge'} );
424 $it->{'can_renew_error'}
427 $borrower->{'borrowernumber'},
430 my ( $restype, $reserves ) =
431 CheckReserves( $it->{'itemnumber'} );
433 $it->{'can_renew'} = 0;
435 push @todaysissues, $it;
440 $it->{'itemtype_charge'}
444 $borrower->{'borrowernumber'}
447 sprintf( "%.2f", $it->{'charge'} );
450 $it->{'can_renew_error'}
453 $borrower->{'borrowernumber'},
456 my ( $restype, $reserves ) =
457 CheckReserves( $it->{'itemnumber'} );
459 $it->{'can_renew'} = 0;
461 push @previousissues, $it;
468 # parses today & build Template array
469 foreach my $book ( sort { $b->{'timestamp'} <=> $a->{'timestamp'} }
472 #warn "TIMESTAMP".$book->{'timestamp'};
473 # ADDED BY JF: NEW ITEMTYPE COUNT DISPLAY
474 $issued_itemtypes_count->{ $book->{'itemtype'} }++;
476 my $dd = $book->{'date_due'};
477 my $datedue = $book->{'date_due'};
479 #$dd=format_date($dd);
481 if ( $datedue < $todaysdate ) {
493 $book->{'togglecolor'} = $togglecolor;
494 $book->{'od'} = format_date($od);
495 $book->{'dd'} = format_date($dd);
496 if ( $book->{'author'} eq '' ) {
497 $book->{'author'} = ' ';
499 push @realtodayissues, $book;
503 # parses previous & build Template array
505 foreach my $book ( sort { $a->{'date_due'} cmp $b->{'date_due'} }
509 # ADDED BY JF: NEW ITEMTYPE COUNT DISPLAY
510 $issued_itemtypes_count->{ $book->{'itemtype'} }++;
512 my $dd = format_date($book->{'date_due'});
513 my $datedue = format_date($book->{'date_due'});
515 #$dd=format_date($dd);
519 if ( $datedue < $todaysdate ) {
531 $book->{'togglecolor'} = $togglecolor;
534 if ( $book->{'author'} eq '' ) {
535 $book->{'author'} = ' ';
537 push @realprevissues, $book;
542 #### ADDED BY JF FOR COUNTS BY ITEMTYPE RULES
543 # FIXME: This should utilize all the issuingrules options rather than just the defaults
544 # and it should be moved to a module
545 my $dbh = C4::Context->dbh;
547 # how many of each is allowed?
548 my $issueqty_sth = $dbh->prepare( "
549 SELECT itemtypes.description AS description,issuingrules.itemtype,maxissueqty
551 LEFT JOIN itemtypes ON (itemtypes.itemtype=issuingrules.itemtype)
554 my @issued_itemtypes_count;
555 $issueqty_sth->execute("*");
556 while ( my $data = $issueqty_sth->fetchrow_hashref() ) {
558 # subtract how many of each this borrower has
559 $data->{'count'} = $issued_itemtypes_count->{ $data->{'description'} };
561 ( $data->{'maxissueqty'} -
562 $issued_itemtypes_count->{ $data->{'description'} } );
564 # can't have a negative number of remaining
565 if ( $data->{'left'} < 0 ) { $data->{'left'} = "0" }
566 $data->{'flag'} = 1 unless ( $data->{'maxissueqty'} > $data->{'count'} );
567 unless ( ( $data->{'maxissueqty'} < 1 )
568 || ( $data->{'itemtype'} eq "*" )
569 || ( $data->{'itemtype'} eq "CIRC" ) )
571 push @issued_itemtypes_count, $data;
574 $issued_itemtypes_loop = \@issued_itemtypes_count;
580 my $CGIselectborrower;
581 if ($borrowerslist) {
585 . $a->{'firstname'} cmp $b->{'surname'}
590 push @values, $_->{'borrowernumber'};
591 $labels{ $_->{'borrowernumber'} } =
592 "$_->{'surname'}, $_->{'firstname'} ... ($_->{'cardnumber'} - $_->{'categorycode'}) ... $_->{'address'} ";
594 $CGIselectborrower = CGI::scrolling_list(
595 -name => 'borrowernumber',
605 my $flags = $borrower->{'flags'};
608 foreach $flag ( sort keys %$flags ) {
610 $flags->{$flag}->{'message'} =~ s/\n/<br>/g;
611 if ( $flags->{$flag}->{'noissues'} ) {
616 if ( $flag eq 'GNA' ) {
617 $template->param( gna => 'true' );
619 if ( $flag eq 'LOST' ) {
620 $template->param( lost => 'true' );
622 if ( $flag eq 'DBARRED' ) {
623 $template->param( dbarred => 'true' );
625 if ( $flag eq 'CHARGES' ) {
628 chargesmsg => $flags->{'CHARGES'}->{'message'}
631 if ( $flag eq 'CREDITS' ) {
634 creditsmsg => $flags->{'CREDITS'}->{'message'}
639 if ( $flag eq 'CHARGES' ) {
643 chargesmsg => $flags->{'CHARGES'}->{'message'}
646 if ( $flag eq 'CREDITS' ) {
649 creditsmsg => $flags->{'CREDITS'}->{'message'}
652 if ( $flag eq 'ODUES' ) {
656 oduesmsg => $flags->{'ODUES'}->{'message'}
659 my $items = $flags->{$flag}->{'itemlist'};
663 # foreach my $item (@$items) {
664 # my ($iteminformation) =
665 # getiteminformation( $item->{'itemnumber'}, 0 );
666 # push @itemswaiting, $iteminformation;
669 if ( $query->param('module') ne 'returns' ) {
670 $template->param( nonreturns => 'true' );
673 if ( $flag eq 'NOTES' ) {
677 notesmsg => $flags->{'NOTES'}->{'message'}
683 my $amountold = $borrower->{flags}->{'CHARGES'}->{'message'} || 0;
684 my @temp = split( /\$/, $amountold );
686 my $CGIorganisations;
687 my $member_of_institution;
688 if ( C4::Context->preference("memberofinstitution") ) {
689 my $organisations = get_institutions();
692 foreach my $organisation ( keys %$organisations ) {
693 push @orgs, $organisation;
694 $org_labels{$organisation} =
695 $organisations->{$organisation}->{'surname'};
697 $member_of_institution = 1;
698 $CGIorganisations = CGI::popup_menu(
699 -id => 'organisations',
700 -name => 'organisations',
701 -labels => \%org_labels,
706 $amountold = $temp[1];
709 issued_itemtypes_count_loop => $issued_itemtypes_loop,
710 findborrower => $findborrower,
711 borrower => $borrower,
712 borrowernumber => $borrowernumber,
715 printername => $printer,
716 firstname => $borrower->{'firstname'},
717 surname => $borrower->{'surname'},
719 $borrower->{'dateexpiry'}, #format_date($borrower->{'dateexpiry'}),
720 categorycode => $borrower->{'categorycode'},
721 streetaddress => $borrower->{'address'},
722 emailaddress => $borrower->{'emailaddress'},
723 borrowernotes => $borrower->{'borrowernotes'},
724 city => $borrower->{'city'},
725 phone => $borrower->{'phone'} || $borrower->{'mobile'},
726 cardnumber => $borrower->{'cardnumber'},
727 amountold => $amountold,
729 stickyduedate => $stickyduedate,
731 CGIselectborrower => $CGIselectborrower,
732 todayissues => \@realtodayissues,
733 previssues => \@realprevissues,
734 inprocess => $inprocess,
735 memberofinstution => $member_of_institution,
736 CGIorganisations => $CGIorganisations,
739 # set return date if stickyduedate
740 if ($stickyduedate) {
741 my $t_year = "year" . $year;
742 my $t_month = "month" . $month;
743 my $t_day = "day" . $day;
751 #if ($branchcookie) {
752 #$cookie=[$cookie, $branchcookie, $printercookie];
756 SpecifyDueDate => C4::Context->preference("SpecifyDueDate")
758 output_html_with_http_headers $query, $cookie, $template->output;