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     my @notify   = NumberNotifyId($borrowernumber);
 138
 139     my $notify_groups = [];
 140     for my $notify_id (@notify) {
 141         my ( $acct_total, $accountlines, undef ) =
 142           GetBorNotifyAcctRecord( $borrowernumber, $notify_id );
 143         if ( @{$accountlines} ) {
 144             my $totalnotify = AmountNotify( $notify_id, $borrowernumber );
 145             push @{$accounts},
 146               { accountlines => $accountlines,
 147                 notify       => $notify_id,
 148                 total        => $totalnotify,
 149               };
 150         }
 151     }
 152     borrower_add_additional_fields($borrower);
 153
 154     $template->param(%$borrower);
 155
 156     my $patron_image = Koha::Patron::Images->find($borrower->{borrowernumber});
 157     $template->param( picture => 1 ) if $patron_image;
 158     $template->param(
 159         accounts => $accounts,
 160         borrower => $borrower,
 161         categoryname => $borrower->{'description'},
 162         total    => $total,
 163     );
 164     return;
 165
 166 }
 167
 168 sub get_for_redirect {
 169     my ( $name, $name_in, $money ) = @_;
 170     my $s     = q{&} . $name . q{=};
 171     my $value = uri_escape_utf8( $input->param($name_in) );
 172     if ( !defined $value ) {
 173         $value = ( $money == 1 ) ? 0 : q{};
 174     }
 175     if ($money) {
 176         $s .= sprintf '%.2f', $value;
 177     } else {
 178         $s .= $value;
 179     }
 180     return $s;
 181 }
 182
 183 sub redirect_to_paycollect {
 184     my ( $action, $line_no ) = @_;
 185     my $redirect =
 186       "/cgi-bin/koha/members/paycollect.pl?borrowernumber=$borrowernumber";
 187     $redirect .= q{&};
 188     $redirect .= "$action=1";
 189     $redirect .= get_for_redirect( 'accounttype', "accounttype$line_no", 0 );
 190     $redirect .= get_for_redirect( 'amount', "amount$line_no", 1 );
 191     $redirect .=
 192       get_for_redirect( 'amountoutstanding', "amountoutstanding$line_no", 1 );
 193     $redirect .= get_for_redirect( 'description', "description$line_no", 0 );
 194     $redirect .= get_for_redirect( 'title', "title$line_no", 0 );
 195     $redirect .= get_for_redirect( 'itemnumber',   "itemnumber$line_no",   0 );
 196     $redirect .= get_for_redirect( 'notify_id',    "notify_id$line_no",    0 );
 197     $redirect .= get_for_redirect( 'notify_level', "notify_level$line_no", 0 );
 198     $redirect .= get_for_redirect( 'accountlines_id', "accountlines_id$line_no", 0 );
 199     $redirect .= q{&} . 'payment_note' . q{=} . uri_escape_utf8( $input->param("payment_note_$line_no") );
 200     $redirect .= '&remote_user=';
 201     $redirect .= $user;
 202     return print $input->redirect($redirect);
 203 }
 204
 205 sub writeoff_all {
 206     my @params = @_;
 207     my @wo_lines = grep { /^accountlines_id\d+$/ } @params;
 208
 209     my $borrowernumber = $input->param('borrowernumber');
 210
 211     for (@wo_lines) {
 212         if (/(\d+)/) {
 213             my $value           = $1;
 214             my $amount          = $input->param("amountoutstanding$value");
 215             my $accountlines_id = $input->param("accountlines_id$value");
 216             my $payment_note    = $input->param("payment_note_$value");
 217             Koha::Account->new( { patron_id => $borrowernumber } )->pay(
 218                 {
 219                     amount => $amount,
 220                     lines  => [ scalar Koha::Account::Lines->find($accountlines_id) ],
 221                     type   => 'writeoff',
 222                     note   => $payment_note,
 223                     library_id => $branch,
 224                 }
 225             );
 226         }
 227     }
 228
 229     print $input->redirect("/cgi-bin/koha/members/boraccount.pl?borrowernumber=$borrowernumber");
 230     return;
 231 }
 232
 233 sub borrower_add_additional_fields {
 234     my $b_ref = shift;
 235
 236 # some borrower info is not returned in the standard call despite being assumed
 237 # in a number of templates. It should not be the business of this script but in lieu of
 238 # a revised api here it is ...
 239     if ( $b_ref->{category_type} eq 'C' ) {
 240         my $patron_categories = Koha::Patron::Categories->search_limited({ category_type => 'A' }, {order_by => ['categorycode']});
 241         $template->param( 'CATCODE_MULTI' => 1) if $patron_categories->count > 1;
 242         $template->param( 'catcode' => $patron_categories->next )  if $patron_categories->count == 1;
 243     } elsif ( $b_ref->{category_type} eq 'A' || $b_ref->{category_type} eq 'I' ) {
 244         $b_ref->{adultborrower} = 1;
 245     }
 246
 247     if (C4::Context->preference('ExtendedPatronAttributes')) {
 248         $b_ref->{extendedattributes} = GetBorrowerAttributes($borrowernumber);
 249         $template->param(
 250             ExtendedPatronAttributes => 1,
 251         );
 252     }
 253
 254     return;
 255 }
 256
 257 sub payselected {
 258     my @params = @_;
 259     my $amt    = 0;
 260     my @lines_to_pay;
 261     foreach (@params) {
 262         if (/^incl_par_(\d+)$/) {
 263             my $index = $1;
 264             push @lines_to_pay, $input->param("accountlines_id$index");
 265             $amt += $input->param("amountoutstanding$index");
 266         }
 267     }
 268     $amt = '&amt=' . $amt;
 269     my $sel = '&selected=' . join ',', @lines_to_pay;
 270     my $notes = '&notes=' . join("%0A", map { $input->param("payment_note_$_") } @lines_to_pay );
 271     my $redirect =
 272         "/cgi-bin/koha/members/paycollect.pl?borrowernumber=$borrowernumber"
 273       . $amt
 274       . $sel
 275       . $notes;
 276
 277     print $input->redirect($redirect);
 278     return;
 279 }