Cleanup circulation.pl
[wip/koha-chris_n.git] / circ / branchoverdues.pl
1 #!/usr/bin/perl
2
3 #
4 # This file is part of Koha.
5 #
6 # Koha is free software; you can redistribute it and/or modify it under the
7 # terms of the GNU General Public License as published by the Free Software
8 # Foundation; either version 2 of the License, or (at your option) any later
9 # version.
10 #
11 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
12 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
13 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
14 #
15 # You should have received a copy of the GNU General Public License along with
16 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
17 # Suite 330, Boston, MA  02111-1307 USA
18
19 use strict;
20 # use warnings;  # FIXME
21 use C4::Context;
22 use CGI;
23 use C4::Output;
24 use C4::Auth;
25 use C4::Dates qw/format_date/;
26 use C4::Overdues;    # AddNotifyLine
27 use C4::Biblio;
28 use C4::Koha;
29 use C4::Debug;
30
31 =head1 branchoverdues.pl
32
33  this module is a new interface, allow to the librarian to check all items on overdues (based on the acountlines type 'FU' )
34  this interface is filtered by branches (automatically), and by location (optional) ....
35  all informations are stocked in the notifys BDD
36
37  FIXME for this time, we have only four methods to notify :
38         - mail : work with a batch programm
39         - letter : for us, the letters are generated by an open-office program
40         - phone : Simple method, when the method 'phone' is selected, we consider, that the borrower as been notified, and the notify send date is implemented
41         - considered lost : for us if the document is on the third overduelevel,
42
43  FIXME the methods are actually hardcoded for the levels : (maybe can be improved by a new possibility in overduerule)
44
45         level 1 : three methods are possible : - mail, letter, phone
46         level 2 : only one method is possible : - letter
47         level 3 : only methode is possible  : - Considered Lost
48
49         the documents displayed on this interface, are checked on three points
50         - 1) the document must be on accountlines (Type 'FU')
51         - 2) item issues is not returned
52         - 3) this item as not been already notify
53
54   FIXME: who is the author?
55   FIXME: No privisions (i.e. "actions") for handling notices are implemented.
56   FIXME: This is linked as "Overdue Fines" but the relationship to fines in GetOverduesForBranch is more complicated than that.
57
58 =cut
59
60 my $input       = new CGI;
61 my $dbh = C4::Context->dbh;
62
63 my ( $template, $loggedinuser, $cookie ) = get_template_and_user({
64         template_name   => "circ/branchoverdues.tmpl",
65         query           => $input,
66         type            => "intranet",
67         authnotrequired => 0,
68         flagsrequired   => { circulate => "circulate_remaining_permissions" },
69         debug           => 1,
70 });
71
72 my $default = C4::Context->userenv->{'branch'};
73
74 # Deal with the vars recept from the template
75 my $borrowernumber = $input->param('borrowernumber');
76 my $itemnumber     = $input->param('itemnumber');
77 my $method         = $input->param('method');
78 my $overduelevel   = $input->param('overduelevel');
79 my $notifyId       = $input->param('notifyId');
80 my $location       = $input->param('location');
81
82 # FIXME: better check that borrowernumber is defined and valid.
83 # FIXME: same for itemnumber and other variables passed in here.
84
85 # now create the line in bdd (notifys)
86 if ( $input->param('action') eq 'add' ) {
87     my $addnotify =
88       AddNotifyLine( $borrowernumber, $itemnumber, $overduelevel, $method,
89         $notifyId )    # FIXME: useless variable, no TMPL code for "action" exists.;
90 }
91 elsif ( $input->param('action') eq 'remove' ) {
92     my $notify_date  = $input->param('notify_date');
93     my $removenotify =
94       RemoveNotifyLine( $borrowernumber, $itemnumber, $notify_date );    # FIXME: useless variable, no TMPL code for "action" exists.
95 }
96
97 my @overduesloop;
98 my @getoverdues = GetOverduesForBranch( $default, $location );
99 use Data::Dumper;
100 $debug and warn "HERE : $default / $location" . Dumper(@getoverdues);
101 # search for location authorised value
102 my ($tag,$subfield) = GetMarcFromKohaField('items.location','');
103 my $tagslib = &GetMarcStructure(1,'');
104 if ($tagslib->{$tag}->{$subfield}->{authorised_value}) {
105     my $values= GetAuthorisedValues($tagslib->{$tag}->{$subfield}->{authorised_value});
106     $template->param(locationsloop => $values);
107 }
108 # now display infos
109 foreach my $num (@getoverdues) {
110
111     my %overdueforbranch;
112     $overdueforbranch{'date_due'}          = format_date( $num->{'date_due'} );
113     $overdueforbranch{'title'}             = $num->{'title'};
114     $overdueforbranch{'description'}       = $num->{'description'};
115     $overdueforbranch{'barcode'}           = $num->{'barcode'};
116     $overdueforbranch{'biblionumber'}      = $num->{'biblionumber'};
117     $overdueforbranch{'borrowersurname'}   = $num->{'surname'};
118     $overdueforbranch{'borrowerfirstname'} = $num->{'firstname'};
119     $overdueforbranch{'borrowerphone'}     = $num->{'phone'};
120     $overdueforbranch{'borroweremail'}     = $num->{'email'};
121     $overdueforbranch{'itemcallnumber'}    = $num->{'itemcallnumber'};
122     $overdueforbranch{'borrowernumber'}    = $num->{'borrowernumber'};
123     $overdueforbranch{'itemnumber'}        = $num->{'itemnumber'};
124
125     # now we add on the template, the differents values of notify_level
126     # FIXME: numerical comparison, not string eq.
127     if ( $num->{'notify_level'} eq '1' ) {
128         $overdueforbranch{'overdue1'}     = 1;
129         $overdueforbranch{'overdueLevel'} = 1;
130     }
131     elsif ( $num->{'notify_level'} eq '2' ) {
132         $overdueforbranch{'overdue2'}     = 1;
133         $overdueforbranch{'overdueLevel'} = 2;
134     }
135     elsif ( $num->{'notify_level'} eq '3' ) {
136         $overdueforbranch{'overdue3'}     = 1;
137         $overdueforbranch{'overdueLevel'} = 3;
138     }
139     $overdueforbranch{'notify_id'} = $num->{'notify_id'};
140
141     push( @overduesloop, \%overdueforbranch );
142 }
143
144 # initiate the templates for the overdueloop
145 $template->param(
146     overduesloop => \@overduesloop,
147     show_date    => format_date(C4::Dates->today('iso')),
148     location     => $location,
149 );
150
151 output_html_with_http_headers $input, $cookie, $template->output;