Koha/C4/Stats.pm

245 lines
7 KiB
Perl

package C4::Stats;
# $Id$
# Modified by TG
# 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 C4::Context;
use vars qw($VERSION @ISA @EXPORT);
# set the version for version checking
$VERSION = 0.01;
=head1 NAME
C4::Stats - Update Koha statistics (log)
=head1 SYNOPSIS
use C4::Stats;
=head1 DESCRIPTION
The C<&UpdateStats> function adds an entry to the statistics table in
the Koha database, which acts as an activity log.
=head1 FUNCTIONS
=over 2
=cut
@ISA = qw(Exporter);
@EXPORT = qw(&UpdateStats &statsreport &TotalOwing
&TotalPaid &getcharges &Getpaidbranch &unfilledreserves &getcredits &getinvoices);
=item UpdateStats
&UpdateStats($env, $branch, $type, $value, $other, $itemnumber,
$itemtype, $borrowernumber);
Adds a line to the statistics table of the Koha database. In effect,
it logs an event.
C<$branch>, C<$type>, C<$value>, C<$other>, C<$itemnumber>,
C<$itemtype>, and C<$borrowernumber> correspond to the fields of the
statistics table in the Koha database.
If C<$branch> is the empty string, the branch code will be taken from
C<$env-E<gt>{branchcode}>.
C<$env-E<gt>{usercode}> specifies the value of the C<usercode> field.
=cut
#'
sub UpdateStats {
#module to insert stats data into stats table
my ($env,$branch,$type,$amount,$other,$itemnum,$itemtype,$borrowernumber,$accountno)=@_;
my $dbh = C4::Context->dbh;
$env=C4::Context->userenv unless $env;
if ($branch eq ''){
$branch=$env->{'branchcode'};
}
my $user = C4::Context->userenv;
# print $borrowernumber;
my $userid=$user->{'cardnumber'} if $user;
# FIXME - Use $dbh->do() instead
my $sth=$dbh->prepare("Insert into statistics (datetime,branch,type,usercode,value,
other,itemnumber,itemtype,borrowernumber,proccode) values (now(),?,?,?,?,?,?,?,?,?)");
$sth->execute($branch,$type,$userid,$amount,$other,$itemnum,$itemtype,$borrowernumber,$accountno);
$sth->finish;
}
# Otherwise, it'd need a POD.
sub TotalPaid {
my ($time,$time2)=@_;
$time2=$time unless $time2;
my $dbh = C4::Context->dbh;
my $query="Select * from accountlines,borrowers where (accounttype = 'Pay' or accounttype='W')
and accountlines.borrowernumber = borrowers.borrowernumber";
my @bind = ();
if ($time eq 'today'){
$query .= " and date = now()";
} else {
$query.=" and date>=? and date<=?";
@bind = ($time,$time2);
}
$query.=" order by timestamp";
# print $query;
my $sth=$dbh->prepare($query);
# $sth->execute();
$sth->execute(@bind);
my @results;
my $i=0;
while (my $data=$sth->fetchrow_hashref){
$results[$i]=$data;
$i++;
}
$sth->finish;
# print $query;
return(@results);
}
# Otherwise, it needs a POD.
sub getcharges{
my($borrowerno,$offset,$accountno)=@_;
my $dbh = C4::Context->dbh;
my $query="";
my $sth;
# getcharges is now taking accountno. as an argument
if ($offset){
$sth=$dbh->prepare("Select * from accountlines where borrowernumber=?
and accountno = ? and amount>0");
$sth->execute($borrowerno,$offset);
# this bit left in for old 2 arg usage of getcharges
} else {
$sth=$dbh->prepare("Select * from accountlines where borrowernumber=?
and accountno = ?");
$sth->execute($borrowerno,$accountno);
}
# print $query,"<br>";
my $i=0;
my @results;
while (my $data=$sth->fetchrow_hashref){
# if ($data->{'timestamp'} == $timestamp){
$results[$i]=$data;
$i++;
# }
}
return(@results);
}
# Otherwise, it needs a POD.
sub getcredits{
my ($date,$date2)=@_;
my $dbh = C4::Context->dbh;
my $sth=$dbh->prepare("Select * from accountlines,borrowers where (( (accounttype <> 'Pay'))
and amount < 0 and accountlines.borrowernumber = borrowers.borrowernumber
and date >=? and date <=?)");
$sth->execute($date, $date2);
my $i=0;
my @results;
while (my $data=$sth->fetchrow_hashref){
$results[$i]=$data;
$i++;
}
return(@results);
}
sub getinvoices{
my ($date,$date2)=@_;
my $dbh = C4::Context->dbh;
my $sth=$dbh->prepare("Select * from accountlines,borrowers where amount>0 and amountoutstanding > 0 and accountlines.borrowernumber = borrowers.borrowernumber
and (date >=? and date <=?)");
$sth->execute($date, $date2);
my $i=0;
my @results;
while (my $data=$sth->fetchrow_hashref){
$results[$i]=$data;
$i++;
}
return(@results);
}
# Otherwise, this needs a POD.
sub Getpaidbranch{
my($date,$borrno)=@_;
my $dbh = C4::Context->dbh;
my $sth=$dbh->prepare("select * from statistics where type='payment' and datetime >? and borrowernumber=?");
$sth->execute($date,$borrno);
# print $query;
my $data=$sth->fetchrow_hashref;
$sth->finish;
return($data->{'branch'});
}
# FIXME - This is only used in reservereport.pl and reservereport.xls,
# neither of which is used.
# Otherwise, it needs a POD.
sub unfilledreserves {
my $dbh = C4::Context->dbh;
my $i=0;
my @results;
my $sth=$dbh->prepare("select *,biblio.title from reserves,biblio,borrowers where (found <> '1' or found is NULL) and cancellationdate
is NULL and biblio.biblionumber=reserves.biblionumber and
reserves.borrowernumber=borrowers.borrowernumber
order by
reserves.reservedate,biblio.title");
$sth->execute;
while (my $data=$sth->fetchrow_hashref){
$results[$i]=$data;
$i++;
}
$sth->finish;
return($i,\@results);
}
1;
__END__
=back
=head1 AUTHOR
Koha Developement team <info@koha.org>
=cut