members/pay.pl

   1 #!/usr/bin/perl
   2
   3 # Copyright 2000-2002 Katipo Communications
   4 # Copyright 2010 BibLibre
   5 # Copyright 2010,2011 PTFS-Europe Ltd
   6 #
   7 # This file is part of Koha.
   8 #
   9 # Koha is free software; you can redistribute it and/or modify it
  10 # under the terms of the GNU General Public License as published by
  11 # the Free Software Foundation; either version 3 of the License, or
  12 # (at your option) any later version.
  13 #
  14 # Koha is distributed in the hope that it will be useful, but
  15 # WITHOUT ANY WARRANTY; without even the implied warranty of
  16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17 # GNU General Public License for more details.
  18 #
  19 # You should have received a copy of the GNU General Public License
  20 # along with Koha; if not, see <http://www.gnu.org/licenses>.
  21
  22 =head1 pay.pl
  23
  24  written 11/1/2000 by chris@katipo.oc.nz
  25  part of the koha library system, script to facilitate paying off fines
  26
  27 =cut
  28
  29 use strict;
  30 use warnings;
  31
  32 use URI::Escape;
  33 use C4::Context;
  34 use C4::Auth;
  35 use C4::Output;
  36 use CGI qw ( -utf8 );
  37 use C4::Members;
  38 use C4::Accounts;
  39 use C4::Stats;
  40 use C4::Koha;
  41 use C4::Overdues;
  42 use C4::Members::Attributes qw(GetBorrowerAttributes);
  43 use Koha::Patrons;
  44 use Koha::Patron::Images;
  45
  46 use Koha::Patron::Categories;
  47 use URI::Escape;
  48
  49 our $input = CGI->new;
  50
  51 my $updatecharges_permissions = $input->param('woall') ? 'writeoff' : 'remaining_permissions';
  52 our ( $template, $loggedinuser, $cookie ) = get_template_and_user(
  53     {   template_name   => 'members/pay.tt',
  54         query           => $input,
  55         type            => 'intranet',
  56         authnotrequired => 0,
  57         flagsrequired   => { borrowers => 1, updatecharges => $updatecharges_permissions },
  58         debug           => 1,
  59     }
  60 );
  61
  62 my @names = $input->param;
  63
  64 our $borrowernumber = $input->param('borrowernumber');
  65 if ( !$borrowernumber ) {
  66     $borrowernumber = $input->param('borrowernumber0');
  67 }
  68
  69 # get borrower details
  70 my $patron = Koha::Patrons->find( $borrowernumber );
  71 unless ( $patron ) {
  72     print $input->redirect("/cgi-bin/koha/circ/circulation.pl?borrowernumber=$borrowernumber");
  73     exit;
  74 }
  75 my $category = $patron->category;
  76 our $borrower = $patron->unblessed;
  77 $borrower->{description} = $category->description;
  78 $borrower->{category_type} = $category->category_type;
  79 our $user = $input->remote_user;
  80 $user ||= q{};
  81
  82 our $branch = C4::Context->userenv->{'branch'};
  83
  84 my $writeoff_item = $input->param('confirm_writeoff');
  85 my $paycollect    = $input->param('paycollect');
  86 if ($paycollect) {
  87     print $input->redirect(
  88         "/cgi-bin/koha/members/paycollect.pl?borrowernumber=$borrowernumber");
  89 }
  90 my $payselected = $input->param('payselected');
  91 if ($payselected) {
  92     payselected(@names);
  93 }
  94
  95 my $writeoff_all = $input->param('woall');    # writeoff all fines
  96 if ($writeoff_all) {
  97     writeoff_all(@names);
  98 } elsif ($writeoff_item) {
  99     my $accountlines_id = $input->param('accountlines_id');
 100     my $amount       = $input->param('amountoutstanding');
 101     my $payment_note = $input->param("payment_note");
 102
 103     Koha::Account->new( { patron_id => $borrowernumber } )->pay(
 104         {
 105             amount     => $amount,
 106             lines      => [ scalar Koha::Account::Lines->find($accountlines_id) ],
 107             type       => 'writeoff',
 108             note       => $payment_note,
 109             library_id => $branch,
 110         }
 111     );
 112 }
 113
 114 for (@names) {
 115     if (/^pay_indiv_(\d+)$/) {
 116         my $line_no = $1;
 117         redirect_to_paycollect( 'pay_individual', $line_no );
 118     } elsif (/^wo_indiv_(\d+)$/) {
 119         my $line_no = $1;
 120         redirect_to_paycollect( 'writeoff_individual', $line_no );
 121     }
 122 }
 123
 124 $template->param(
 125     finesview => 1,
 126     RoutingSerials => C4::Context->preference('RoutingSerials'),
 127 );
 128
 129 add_accounts_to_template();
 130
 131 output_html_with_http_headers $input, $cookie, $template->output;
 132
 133 sub add_accounts_to_template {
 134
 135     my ( $total, undef, undef ) = GetMemberAccountRecords($borrowernumber);
 136     my $accounts = [];
 137     borrower_add_additional_fields($borrower);
 138
 139     $template->param(%$borrower);
 140
 141     my $patron_image = Koha::Patron::Images->find($borrower->{borrowernumber});
 142     $template->param( picture => 1 ) if $patron_image;
 143     $template->param(
 144         accounts => $accounts,
 145         borrower => $borrower,
 146         categoryname => $borrower->{'description'},
 147         total    => $total,
 148     );
 149     return;
 150
 151 }
 152
 153 sub get_for_redirect {
 154     my ( $name, $name_in, $money ) = @_;
 155     my $s     = q{&} . $name . q{=};
 156     my $value;
 157     if (defined $input->param($name_in)) {
 158         $value = uri_escape_utf8( scalar $input->param($name_in) );
 159     }
 160     if ( !defined $value ) {
 161         $value = ( $money == 1 ) ? 0 : q{};
 162     }
 163     if ($money) {
 164         $s .= sprintf '%.2f', $value;
 165     } else {
 166         $s .= $value;
 167     }
 168     return $s;
 169 }
 170
 171 sub redirect_to_paycollect {
 172     my ( $action, $line_no ) = @_;
 173     my $redirect =
 174       "/cgi-bin/koha/members/paycollect.pl?borrowernumber=$borrowernumber";
 175     $redirect .= q{&};
 176     $redirect .= "$action=1";
 177     $redirect .= get_for_redirect( 'accounttype', "accounttype$line_no", 0 );
 178     $redirect .= get_for_redirect( 'amount', "amount$line_no", 1 );
 179     $redirect .=
 180       get_for_redirect( 'amountoutstanding', "amountoutstanding$line_no", 1 );
 181     $redirect .= get_for_redirect( 'description', "description$line_no", 0 );
 182     $redirect .= get_for_redirect( 'title', "title$line_no", 0 );
 183     $redirect .= get_for_redirect( 'itemnumber',   "itemnumber$line_no",   0 );
 184     $redirect .= get_for_redirect( 'accountlines_id', "accountlines_id$line_no", 0 );
 185     $redirect .= q{&} . 'payment_note' . q{=} . uri_escape_utf8( scalar $input->param("payment_note_$line_no") );
 186     $redirect .= '&remote_user=';
 187     $redirect .= $user;
 188     return print $input->redirect($redirect);
 189 }
 190
 191 sub writeoff_all {
 192     my @params = @_;
 193     my @wo_lines = grep { /^accountlines_id\d+$/ } @params;
 194
 195     my $borrowernumber = $input->param('borrowernumber');
 196
 197     for (@wo_lines) {
 198         if (/(\d+)/) {
 199             my $value           = $1;
 200             my $amount          = $input->param("amountoutstanding$value");
 201             my $accountlines_id = $input->param("accountlines_id$value");
 202             my $payment_note    = $input->param("payment_note_$value");
 203             Koha::Account->new( { patron_id => $borrowernumber } )->pay(
 204                 {
 205                     amount => $amount,
 206                     lines  => [ scalar Koha::Account::Lines->find($accountlines_id) ],
 207                     type   => 'writeoff',
 208                     note   => $payment_note,
 209                     library_id => $branch,
 210                 }
 211             );
 212         }
 213     }
 214
 215     print $input->redirect("/cgi-bin/koha/members/boraccount.pl?borrowernumber=$borrowernumber");
 216     return;
 217 }
 218
 219 sub borrower_add_additional_fields {
 220     my $b_ref = shift;
 221
 222 # some borrower info is not returned in the standard call despite being assumed
 223 # in a number of templates. It should not be the business of this script but in lieu of
 224 # a revised api here it is ...
 225     if ( $b_ref->{category_type} eq 'C' ) {
 226         my $patron_categories = Koha::Patron::Categories->search_limited({ category_type => 'A' }, {order_by => ['categorycode']});
 227         $template->param( 'CATCODE_MULTI' => 1) if $patron_categories->count > 1;
 228         $template->param( 'catcode' => $patron_categories->next )  if $patron_categories->count == 1;
 229     } elsif ( $b_ref->{category_type} eq 'A' || $b_ref->{category_type} eq 'I' ) {
 230         $b_ref->{adultborrower} = 1;
 231     }
 232
 233     if (C4::Context->preference('ExtendedPatronAttributes')) {
 234         $b_ref->{extendedattributes} = GetBorrowerAttributes($borrowernumber);
 235         $template->param(
 236             ExtendedPatronAttributes => 1,
 237         );
 238     }
 239
 240     return;
 241 }
 242
 243 sub payselected {
 244     my @params = @_;
 245     my $amt    = 0;
 246     my @lines_to_pay;
 247     foreach (@params) {
 248         if (/^incl_par_(\d+)$/) {
 249             my $index = $1;
 250             push @lines_to_pay, scalar $input->param("accountlines_id$index");
 251             $amt += $input->param("amountoutstanding$index");
 252         }
 253     }
 254     $amt = '&amt=' . $amt;
 255     my $sel = '&selected=' . join ',', @lines_to_pay;
 256     my $notes = '&notes=' . join("%0A", map { scalar $input->param("payment_note_$_") } @lines_to_pay );
 257     my $redirect =
 258         "/cgi-bin/koha/members/paycollect.pl?borrowernumber=$borrowernumber"
 259       . $amt
 260       . $sel
 261       . $notes;
 262
 263     print $input->redirect($redirect);
 264     return;
 265 }