Koha/Patron/Discharge.pm

   1 package Koha::Patron::Discharge;
   2
   3 use Modern::Perl;
   4 use CGI;
   5 use File::Temp qw( :POSIX );
   6 use Carp;
   7
   8 use C4::Templates qw ( gettemplate );
   9 use C4::Letters qw ( GetPreparedLetter );
  10
  11 use Koha::Database;
  12 use Koha::DateUtils qw( dt_from_string output_pref );
  13 use Koha::Patrons;
  14 use Koha::Patron::Debarments;
  15
  16 sub count {
  17     my ($params) = @_;
  18     my $values = {};
  19
  20     if( $params->{borrowernumber} ) {
  21         $values->{borrower} = $params->{borrowernumber};
  22     }
  23     if( $params->{pending} ) {
  24         $values->{needed} = { '!=', undef };
  25         $values->{validated} = undef;
  26     }
  27     elsif( $params->{validated} ) {
  28         $values->{validated} = { '!=', undef };
  29     }
  30
  31     return search_limited( $values )->count;
  32 }
  33
  34 sub can_be_discharged {
  35     my ($params) = @_;
  36     return unless $params->{borrowernumber};
  37
  38     my $patron = Koha::Patrons->find( $params->{borrowernumber} );
  39     return unless $patron;
  40
  41     my $has_pending_checkouts = $patron->checkouts->count;
  42     return $has_pending_checkouts ? 0 : 1;
  43 }
  44
  45 sub is_discharged {
  46     my ($params) = @_;
  47     return unless $params->{borrowernumber};
  48     my $borrowernumber = $params->{borrowernumber};
  49
  50     my $restricted = Koha::Patrons->find( $borrowernumber )->is_debarred;
  51     my @validated = get_validated({borrowernumber => $borrowernumber});
  52
  53     if ($restricted && @validated) {
  54         return 1;
  55     } else {
  56         return 0;
  57     }
  58 }
  59
  60 sub request {
  61     my ($params) = @_;
  62     my $borrowernumber = $params->{borrowernumber};
  63     return unless $borrowernumber;
  64     return unless can_be_discharged({ borrowernumber => $borrowernumber });
  65
  66     my $rs = Koha::Database->new->schema->resultset('Discharge');
  67     return $rs->create({
  68         borrower => $borrowernumber,
  69         needed   => dt_from_string,
  70     });
  71 }
  72
  73 sub discharge {
  74     my ($params) = @_;
  75     my $borrowernumber = $params->{borrowernumber};
  76     return unless $borrowernumber and can_be_discharged( { borrowernumber => $borrowernumber } );
  77
  78     # Cancel reserves
  79     my $patron = Koha::Patrons->find( $borrowernumber );
  80     my $holds = $patron->holds;
  81     while ( my $hold = $holds->next ) {
  82         $hold->cancel;
  83     }
  84
  85     # Debar the member
  86     Koha::Patron::Debarments::AddDebarment({
  87         borrowernumber => $borrowernumber,
  88         type           => 'DISCHARGE',
  89     });
  90
  91     # Generate the discharge
  92     my $rs = Koha::Database->new->schema->resultset('Discharge');
  93     my $discharge = $rs->search({ borrower => $borrowernumber }, { order_by => { -desc => 'needed' }, rows => 1 });
  94     if( $discharge->count > 0 ) {
  95         $discharge->update({ validated => dt_from_string });
  96     }
  97     else {
  98         $rs->create({
  99             borrower  => $borrowernumber,
 100             validated => dt_from_string,
 101         });
 102     }
 103 }
 104
 105 sub generate_as_pdf {
 106     my ($params) = @_;
 107     return unless $params->{borrowernumber};
 108
 109     my $patron = Koha::Patrons->find( $params->{borrowernumber} );
 110     my $letter = C4::Letters::GetPreparedLetter(
 111         module      => 'members',
 112         letter_code => 'DISCHARGE',
 113         lang        => $patron->lang,
 114         tables      => { borrowers => $params->{borrowernumber}, branches => $params->{'branchcode'}, },
 115     );
 116
 117     my $today = output_pref( dt_from_string() );
 118     $letter->{'title'}   =~ s/<<today>>/$today/g;
 119     $letter->{'content'} =~ s/<<today>>/$today/g;
 120
 121     my $tmpl = C4::Templates::gettemplate('batch/print-notices.tt', 'intranet', new CGI);
 122     $tmpl->param(
 123         stylesheet => C4::Context->preference("NoticeCSS"),
 124         today      => $today,
 125         messages   => [$letter],
 126     );
 127
 128     my $html_path = tmpnam() . '.html';
 129     my $pdf_path = tmpnam() . '.pdf';
 130     my $html_content = $tmpl->output;
 131     open my $html_fh, '>:encoding(utf8)', $html_path;
 132     say $html_fh $html_content;
 133     close $html_fh;
 134     my $output = eval { require PDF::FromHTML; return; } || $@;
 135     if ($output && $params->{testing}) {
 136         carp $output;
 137         $pdf_path = undef;
 138     }
 139     elsif ($output) {
 140         die $output;
 141     }
 142     else {
 143         my $pdf = PDF::FromHTML->new( encoding => 'utf-8' );
 144         $pdf->load_file( $html_path );
 145         $pdf->convert;
 146         $pdf->write_file( $pdf_path );
 147     }
 148
 149     return $pdf_path;
 150 }
 151
 152 sub get_pendings {
 153     my ($params)       = @_;
 154     my $branchcode     = $params->{branchcode};
 155     my $borrowernumber = $params->{borrowernumber};
 156
 157     my $cond = {
 158         'me.needed'    => { '!=', undef },
 159         'me.validated' => undef,
 160         ( defined $borrowernumber ? ( 'me.borrower' => $borrowernumber ) : () ),
 161         ( defined $branchcode ? ( 'borrower.branchcode' => $branchcode ) : () ),
 162     };
 163
 164     return search_limited( $cond );
 165 }
 166
 167 sub get_validated {
 168     my ($params)       = @_;
 169     my $branchcode     = $params->{branchcode};
 170     my $borrowernumber = $params->{borrowernumber};
 171
 172     my $cond = {
 173         'me.validated' => { '!=', undef },
 174         ( defined $borrowernumber ? ( 'me.borrower' => $borrowernumber ) : () ),
 175         ( defined $branchcode ? ( 'borrower.branchcode' => $branchcode ) : () ),
 176     };
 177
 178     return search_limited( $cond );
 179 }
 180
 181 # TODO This module should be based on Koha::Object[s]
 182 sub search_limited {
 183     my ( $params, $attributes ) = @_;
 184     my $userenv = C4::Context->userenv;
 185     my @restricted_branchcodes;
 186     if ( $userenv and $userenv->{number} ) {
 187         my $logged_in_user = Koha::Patrons->find( $userenv->{number} );
 188         @restricted_branchcodes = $logged_in_user->libraries_where_can_see_patrons;
 189     }
 190     $params->{'borrower.branchcode'} = { -in => \@restricted_branchcodes } if @restricted_branchcodes;
 191     $attributes->{join} = 'borrower';
 192
 193     my $rs = Koha::Database->new->schema->resultset('Discharge');
 194     return $rs->search( $params, { join => 'borrower' } );
 195 }
 196
 197 1;