270 lines
8 KiB
Perl
Executable file
270 lines
8 KiB
Perl
Executable file
package C4::Circulation::Renewals;
|
|
|
|
# $Id$
|
|
|
|
#package to deal with Renewals
|
|
#written 7/11/99 by olwen@katipo.co.nz
|
|
|
|
|
|
# Copyright 2000-2002 Katipo Communications
|
|
#
|
|
# This file is part of Koha.
|
|
#
|
|
# Koha is free software; you can redistribute it and/or modify it under the
|
|
# terms of the GNU General Public License as published by the Free Software
|
|
# Foundation; either version 2 of the License, or (at your option) any later
|
|
# version.
|
|
#
|
|
# Koha is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
# A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License along with
|
|
# Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
|
|
# Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
use strict;
|
|
require Exporter;
|
|
use DBI;
|
|
use C4::Format;
|
|
use C4::Accounts;
|
|
use C4::InterfaceCDK;
|
|
use C4::Interface::RenewalsCDK;
|
|
use C4::Circulation::Issues;
|
|
use C4::Circulation::Main;
|
|
# FIXME - C4::Circulation::Main and C4::Circulation::Renewals
|
|
# use each other, so functions get redefined.
|
|
use C4::Search;
|
|
use C4::Scan;
|
|
use C4::Stats;
|
|
use vars qw($VERSION @ISA @EXPORT);
|
|
|
|
# set the version for version checking
|
|
$VERSION = 0.01;
|
|
|
|
=head1 NAME
|
|
|
|
C4::Circulation::Renewals - Old Koha module dealing with renewals
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
use C4::Circulation::Renewals;
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This module contains a function for checking whether a book may be
|
|
renewed.
|
|
|
|
=head1 FUNCTIONS
|
|
|
|
=over 2
|
|
|
|
=cut
|
|
|
|
@ISA = qw(Exporter);
|
|
@EXPORT = qw(&renewstatus &renewbook &bulkrenew);
|
|
|
|
=item renewstatus
|
|
|
|
$ok = &renewstatus($env, $dbh, $borrowernumber, $itemnumber);
|
|
|
|
Find out whether a borrowed item may be renewed.
|
|
|
|
C<$env> is ignored.
|
|
|
|
C<$dbh> is a DBI handle to the Koha database.
|
|
|
|
C<$borrowernumber> is the borrower number of the patron who currently
|
|
has the item on loan.
|
|
|
|
C<$itemnumber> is the number of the item to renew.
|
|
|
|
C<$renewstatus> returns a true value iff the item may be renewed. The
|
|
item must currently be on loan to the specified borrower; renewals
|
|
must be allowed for the item's type; and the borrower must not have
|
|
already renewed the loan.
|
|
|
|
=cut
|
|
#'
|
|
# FIXME - This is identical to &C4::Circulation::Circ2::renewstatus,
|
|
# and virtually identical to &C4::Circulation::Renewals2::renewstatus.
|
|
# Pick one and stick with it.
|
|
sub renewstatus {
|
|
# check renewal status
|
|
# FIXME - Two people can't borrow the same book at once, so
|
|
# presumably we can get $bornum from $itemno.
|
|
my ($env,$dbh,$bornum,$itemno)=@_;
|
|
my $renews = 1; # FIXME - I think this is the maximum
|
|
# number of allowed renewals.
|
|
# FIXME - I think this function could be redone to use only one SQL
|
|
# call.
|
|
my $renewokay = 0;
|
|
# Look in the issues table for this item, lent to this borrower,
|
|
# and not yet returned.
|
|
my $q1 = "select * from issues
|
|
where (borrowernumber = '$bornum')
|
|
and (itemnumber = '$itemno')
|
|
and returndate is null";
|
|
my $sth1 = $dbh->prepare($q1);
|
|
$sth1->execute;
|
|
# Found a matching item
|
|
if (my $data1 = $sth1->fetchrow_hashref) {
|
|
# See if this item may be renewed. This query is convoluted
|
|
# because it's a bit messy: given the item number, we need to find
|
|
# the biblioitem, which gives us the itemtype, which tells us
|
|
# whether it may be renewed.
|
|
my $q2 = "select renewalsallowed from items,biblioitems,itemtypes
|
|
where (items.itemnumber = '$itemno')
|
|
and (items.biblioitemnumber = biblioitems.biblioitemnumber)
|
|
and (biblioitems.itemtype = itemtypes.itemtype)";
|
|
my $sth2 = $dbh->prepare($q2);
|
|
$sth2->execute;
|
|
if (my $data2=$sth2->fetchrow_hashref) {
|
|
$renews = $data2->{'renewalsallowed'};
|
|
}
|
|
if ($renews > $data1->{'renewals'}) {
|
|
$renewokay = 1;
|
|
}
|
|
$sth2->finish;
|
|
}
|
|
$sth1->finish;
|
|
return($renewokay);
|
|
}
|
|
|
|
# FIXME - A different version of this function appears in
|
|
# C4::Circulation::Renewals2. Pick one and stick with it.
|
|
# FIXME - This function doesn't appear to be used. Presumably it's
|
|
# obsolete.
|
|
# Otherwise, it needs a POD.
|
|
sub renewbook {
|
|
# mark book as renewed
|
|
# FIXME - Get $dbh from C4::Context->dbh, instead of requiring
|
|
# an additional argument.
|
|
my ($env,$dbh,$bornum,$itemno,$datedue)=@_;
|
|
if ($datedue eq "" ) {
|
|
my $loanlength=21;
|
|
my $query= "Select * from biblioitems,items,itemtypes
|
|
where (items.itemnumber = '$itemno')
|
|
and (biblioitems.biblioitemnumber = items.biblioitemnumber)
|
|
and (biblioitems.itemtype = itemtypes.itemtype)";
|
|
my $sth=$dbh->prepare($query);
|
|
$sth->execute;
|
|
if (my $data=$sth->fetchrow_hashref) {
|
|
$loanlength = $data->{'loanlength'}
|
|
}
|
|
$sth->finish;
|
|
my $ti = time;
|
|
my $datedu = time + ($loanlength * 86400);
|
|
my @datearr = localtime($datedu);
|
|
$datedue = (1900+$datearr[5])."-".($datearr[4]+1)."-".$datearr[3];
|
|
}
|
|
my @date = split("-",$datedue);
|
|
my $odatedue = (@date[2]+0)."-".(@date[1]+0)."-".@date[0];
|
|
my $issquery = "select * from issues where borrowernumber='$bornum' and
|
|
itemnumber='$itemno' and returndate is null";
|
|
my $sth=$dbh->prepare($issquery);
|
|
$sth->execute;
|
|
my $issuedata=$sth->fetchrow_hashref;
|
|
$sth->finish;
|
|
my $renews = $issuedata->{'renewals'} +1;
|
|
my $updquery = "update issues
|
|
set date_due = '$datedue', renewals = '$renews'
|
|
where borrowernumber='$bornum' and
|
|
itemnumber='$itemno' and returndate is null";
|
|
my $sth=$dbh->prepare($updquery);
|
|
|
|
$sth->execute;
|
|
$sth->finish;
|
|
return($odatedue);
|
|
}
|
|
|
|
# FIXME - Only used in C4:InterfaceCDK. Presumably this function is
|
|
# obsolete.
|
|
# Otherwise, it needs a POD.
|
|
sub bulkrenew {
|
|
my ($env,$dbh,$bornum,$amount,$borrower,$odues) = @_;
|
|
my $query = "select * from issues
|
|
where borrowernumber = '$bornum' and returndate is null order by date_due";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute();
|
|
my @items;
|
|
my @issues;
|
|
my @renewdef;
|
|
my $x;
|
|
my @barcodes;
|
|
my @rstatuses;
|
|
while (my $issrec = $sth->fetchrow_hashref) {
|
|
my $itemdata = C4::Search::itemnodata($env,$dbh,$issrec->{'itemnumber'});
|
|
my @date = split("-",$issrec->{'date_due'});
|
|
#my $line = $issrec->{'date_due'}." ";
|
|
my $line = @date[2]."-".@date[1]."-".@date[0]." ";
|
|
my $renewstatus = renewstatus($env,$dbh,$bornum,$issrec->{'itemnumber'});
|
|
my ($resbor,$resrec) = C4::Circulation::Main::checkreserve($env,
|
|
$dbh,$issrec->{'itemnumber'});
|
|
if ($resbor ne "") {
|
|
$line .= "R";
|
|
$rstatuses[$x] ="R";
|
|
} elsif ($renewstatus == 0) {
|
|
$line .= "N";
|
|
$rstatuses[$x] = "N";
|
|
} else {
|
|
$line .= "Y";
|
|
$rstatuses[$x] = "Y";
|
|
}
|
|
$line .= fmtdec($env,$issrec->{'renewals'},"20")." ";
|
|
$line .= $itemdata->{'barcode'}." ".$itemdata->{'itemtype'}." ".$itemdata->{'title'};
|
|
$items[$x] = $line;
|
|
#debug_msg($env,$line);
|
|
$issues[$x] = $issrec;
|
|
$barcodes[$x] = $itemdata->{'barcode'};
|
|
my $rdef = 1;
|
|
if ($issrec->{'renewals'} > 0) {
|
|
$rdef = 0;
|
|
}
|
|
$renewdef[$x] = $rdef;
|
|
$x++;
|
|
}
|
|
if ($x < 1) {
|
|
return;
|
|
}
|
|
my $renews = C4::Interface::RenewalsCDK::renew_window($env,
|
|
\@items,$borrower,$amount,$odues);
|
|
my $isscnt = $x;
|
|
$x =0;
|
|
my $y = 0;
|
|
my @renew_errors = "";
|
|
while ($x < $isscnt) {
|
|
if (@$renews[$x] == 1) {
|
|
my $issrec = $issues[$x];
|
|
if ($rstatuses[$x] eq "Y") {
|
|
renewbook($env,$dbh,$issrec->{'borrowernumber'},$issrec->{'itemnumber'},"");
|
|
my $charge = C4::Circulation::Issues::calc_charges($env,$dbh,
|
|
$issrec->{'itemnumber'},$issrec->{'borrowernumber'});
|
|
if ($charge > 0) {
|
|
C4::Circulation::Issues::createcharge($env,$dbh,
|
|
$issrec->{'itemnumber'},$issrec->{'borrowernumber'},$charge);
|
|
}
|
|
&UpdateStats($env,$env->{'branchcode'},'renew',$charge,'',$issrec->{'itemnumber'});
|
|
} elsif ($rstatuses[$x] eq "N") {
|
|
C4::InterfaceCDK::info_msg($env,
|
|
"</S>$barcodes[$x] - can't renew");
|
|
} else {
|
|
C4::InterfaceCDK::info_msg($env,
|
|
"</S>$barcodes[$x] - on reserve");
|
|
}
|
|
}
|
|
$x++;
|
|
}
|
|
$sth->finish();
|
|
}
|
|
|
|
1;
|
|
__END__
|
|
|
|
=back
|
|
|
|
=head1 AUTHOR
|
|
|
|
Koha Developement team <info@koha.org>
|
|
|
|
=cut
|