220 lines
6.6 KiB
Perl
220 lines
6.6 KiB
Perl
package C4::Suggestions;
|
|
|
|
# $Id$
|
|
|
|
# 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::Context;
|
|
use C4::Output;
|
|
use Mail::Sendmail;
|
|
# use C4::Interface::CGI::Output;
|
|
use vars qw($VERSION @ISA @EXPORT);
|
|
|
|
# set the version for version checking
|
|
$VERSION = 0.01;
|
|
|
|
=head1 NAME
|
|
|
|
C4::Accounts - Functions for dealing with Koha authorities
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
use C4::Suggestions;
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The functions in this module deal with the suggestions :
|
|
* in OPAC
|
|
* in librarian interface
|
|
|
|
A suggestion is done in the OPAC. It has the status "ASKED"
|
|
When a librarian manages the suggestion, he can set the status to "REJECTED" or "ORDERED".
|
|
When a book is ordered and arrived in the library, the status becomes "AVAILABLE"
|
|
All suggestions of a borrower by the borrower itself.
|
|
Suggestions done by other can be seen when not "AVAILABLE"
|
|
|
|
=head1 FUNCTIONS
|
|
|
|
=over 2
|
|
|
|
=cut
|
|
|
|
@ISA = qw(Exporter);
|
|
@EXPORT = qw( &newsuggestion
|
|
&searchsuggestion
|
|
&getsuggestion
|
|
&delsuggestion
|
|
&countsuggestion
|
|
&changestatus
|
|
);
|
|
|
|
=item SearchSuggestion
|
|
|
|
(\@array) = &SearchSuggestion($user)
|
|
|
|
searches for a suggestion
|
|
|
|
C<$user> is the user code (used as suggestor filter)
|
|
|
|
return :
|
|
C<\@array> : the suggestions found. Array of hash.
|
|
Note the status is stored twice :
|
|
* in the status field
|
|
* as parameter ( for example ASKED => 1, or REJECTED => 1) . This is for template & translation purposes.
|
|
|
|
=cut
|
|
sub searchsuggestion {
|
|
my ($user,$author,$title,$publishercode,$status,$suggestedbyme)=@_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query="Select suggestions.*,
|
|
U1.surname as surnamesuggestedby,U1.firstname as firstnamesuggestedby,
|
|
U2.surname as surnamemanagedby,U2.firstname as firstnamemanagedby
|
|
from suggestions
|
|
left join borrowers as U1 on suggestedby=U1.borrowernumber
|
|
left join borrowers as U2 on managedby=U2.borrowernumber
|
|
where 1=1";
|
|
my @sql_params;
|
|
if ($author) {
|
|
push @sql_params,"%".$author."%";
|
|
$query .= " and author like ?";
|
|
}
|
|
if ($title) {
|
|
push @sql_params,"%".$title."%";
|
|
$query .= " and suggestions.title like ?";
|
|
}
|
|
if ($publishercode) {
|
|
push @sql_params,"%".$publishercode."%";
|
|
$query .= " and publishercode like ?";
|
|
}
|
|
if ($status) {
|
|
push @sql_params,$status;
|
|
$query .= " and status=?";
|
|
}
|
|
if ($suggestedbyme) {
|
|
if ($suggestedbyme eq -1) {
|
|
} else {
|
|
push @sql_params,$user;
|
|
$query .= " and suggestedby=?";
|
|
}
|
|
} else {
|
|
$query .= " and managedby is NULL";
|
|
}
|
|
my $sth=$dbh->prepare($query);
|
|
$sth->execute(@sql_params);
|
|
my @results;
|
|
my $even=1; # the even variable is used to set even / odd lines, for highlighting
|
|
while (my $data=$sth->fetchrow_hashref){
|
|
$data->{$data->{STATUS}} = 1;
|
|
if ($even) {
|
|
$even=0;
|
|
$data->{even}=1;
|
|
} else {
|
|
$even=1;
|
|
}
|
|
push(@results,$data);
|
|
}
|
|
return (\@results);
|
|
}
|
|
|
|
sub newsuggestion {
|
|
my ($borrowernumber,$title,$author,$publishercode,$note,$copyrightdate,$volumedesc,$publicationyear,$place,$isbn,$biblionumber) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $sth = $dbh->prepare("insert into suggestions (status,suggestedby,title,author,publishercode,note,copyrightdate,volumedesc,publicationyear,place,isbn,biblionumber) values ('ASKED',?,?,?,?,?,?,?,?,?,?,?)");
|
|
$sth->execute($borrowernumber,$title,$author,$publishercode,$note,$copyrightdate,$volumedesc,$publicationyear,$place,$isbn,$biblionumber);
|
|
}
|
|
|
|
sub getsuggestion {
|
|
my ($suggestionid) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $sth = $dbh->prepare("select * from suggestions where suggestionid=?");
|
|
$sth->execute($suggestionid);
|
|
return($sth->fetchrow_hashref);
|
|
}
|
|
|
|
sub delsuggestion {
|
|
my ($borrowernumber,$suggestionid) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
# check that the suggestion comes from the suggestor
|
|
my $sth = $dbh->prepare("select suggestedby from suggestions where suggestionid=?");
|
|
$sth->execute($suggestionid);
|
|
my ($suggestedby) = $sth->fetchrow;
|
|
if ($suggestedby eq $borrowernumber) {
|
|
$sth = $dbh->prepare("delete from suggestions where suggestionid=?");
|
|
$sth->execute($suggestionid);
|
|
}
|
|
}
|
|
|
|
sub countsuggestion {
|
|
my ($status) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $sth = $dbh->prepare("select count(*) from suggestions where status=?");
|
|
$sth->execute($status);
|
|
my ($result) = $sth->fetchrow;
|
|
return $result;
|
|
}
|
|
|
|
sub changestatus {
|
|
my ($suggestionid,$status,$managedby) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $sth;
|
|
if ($managedby>0) {
|
|
$sth = $dbh->prepare("update suggestions set status=?,managedby=? where suggestionid=?");
|
|
$sth->execute($status,$managedby,$suggestionid);
|
|
} else {
|
|
$sth = $dbh->prepare("update suggestions set status=? where suggestionid=?");
|
|
$sth->execute($status,$suggestionid);
|
|
|
|
}
|
|
# check mail sending.
|
|
$sth = $dbh->prepare("select suggestions.*,
|
|
boby.surname as bysurname, boby.firstname as byfirstname, boby.emailaddress as byemail,
|
|
lib.surname as libsurname,lib.firstname as libfirstname,lib.emailaddress as libemail
|
|
from suggestions left join borrowers as boby on boby.borrowernumber=suggestedby left join borrowers as lib on lib.borrowernumber=managedby where suggestionid=?");
|
|
$sth->execute($suggestionid);
|
|
my $emailinfo = $sth->fetchrow_hashref;
|
|
my $template = gettemplate("suggestion/mail_suggestion_$status.tmpl","intranet");
|
|
# query =>'',
|
|
# authnotrequired => 1,
|
|
# });
|
|
$template->param(byemail => $emailinfo->{byemail},
|
|
libemail => $emailinfo->{libemail},
|
|
status => $emailinfo->{status},
|
|
title => $emailinfo->{title},
|
|
author =>$emailinfo->{author},
|
|
libsurname => $emailinfo->{libsurname},
|
|
libfirstname => $emailinfo->{libfirstname},
|
|
byfirstname => $emailinfo->{byfirstname},
|
|
bysurname => $emailinfo->{bysurname},
|
|
);
|
|
my %mail = ( To => $emailinfo->{byemail},
|
|
From => $emailinfo->{libemail},
|
|
Subject => 'Koha suggestion',
|
|
Message => "".$template->output
|
|
);
|
|
sendmail(%mail);
|
|
# warn "sending email to $emailinfo->{byemail} from $emailinfo->{libemail} to notice new status $emailinfo->{status} for $emailinfo->{title} / $emailinfo->{author}";
|
|
}
|
|
|
|
=back
|
|
|
|
=head1 SEE ALSO
|
|
|
|
=cut
|