Koha/misc/cronjobs/gather_print_notices.pl
Jonathan Druart 82716a0172
Bug 23084: Replace grep {^$var$} with grep {$_ eq $var}
We certainly faced 3 similar bugs due to this syntax: bug 23006, bug
22941 and bug 17526.

To prevent other issues related to this syntax this patch suggests to
replace them all in one go.

Test plan:
Confirm that the 2 syntaxes are similar
Eyeball the patch and confirm that there is no typo!

Signed-off-by: Bernardo Gonzalez Kriegel <bgkriegel@gmail.com>
Signed-off-by: Katrin Fischer <katrin.fischer.83@web.de>
Signed-off-by: Martin Renvoize <martin.renvoize@ptfs-europe.com>
2020-02-17 10:44:45 +00:00

423 lines
11 KiB
Perl
Executable file

#!/usr/bin/perl -w
use Modern::Perl;
BEGIN {
# find Koha's Perl modules
# test carefully before changing this
use FindBin;
eval { require "$FindBin::Bin/../kohalib.pl" };
}
use CGI qw( utf8 ); # NOT a CGI script, this is just to keep C4::Templates::gettemplate happy
use Koha::Script -cron;
use C4::Context;
use C4::Debug;
use C4::Letters;
use C4::Templates;
use File::Spec;
use Pod::Usage;
use Getopt::Long;
use C4::Log;
use Koha::DateUtils;
use Koha::Util::OpenDocument;
use MIME::Lite;
my (
$stylesheet,
$help,
$split,
$html,
$csv,
$ods,
$delimiter,
@letter_codes,
$send,
@emails,
);
$send = 1;
GetOptions(
'h|help' => \$help,
's|split' => \$split,
'html' => \$html,
'csv' => \$csv,
'ods' => \$ods,
'd|delimiter:s' => \$delimiter,
'letter_code:s' => \@letter_codes,
'send!' => \$send,
'e|email:s' => \@emails,
) || pod2usage(1);
pod2usage(0) if $help;
my $output_directory = $ARGV[0];
if ( !$output_directory || !-d $output_directory || !-w $output_directory ) {
pod2usage({
-exitval => 1,
-msg => qq{\nError: You must specify a valid and writeable directory to dump the print notices in.\n},
});
}
# Default value is html
$html = 1 if not $html and not $csv and not $ods;
if ( $csv and @letter_codes != 1 ) {
pod2usage({
-exitval => 1,
-msg => qq{\nIt is not consistent to use --csv without one (and only one) letter_code\n},
});
}
if ( $ods and @letter_codes != 1 ) {
pod2usage({
-exitval => 1,
-msg => qq{\nIt is not consistent to use --ods without one (and only one) letter_code\n},
});
}
$delimiter ||= q|,|;
cronlogaction();
my $today_iso = output_pref( { dt => dt_from_string, dateonly => 1, dateformat => 'iso' } ) ;
my $today_syspref = output_pref( { dt => dt_from_string, dateonly => 1 } );
my @all_messages = @{ GetPrintMessages() };
# Filter by letter_code
@all_messages = map {
my $letter_code = $_->{letter_code};
(
grep { $_ eq $letter_code } @letter_codes
) ? $_ : ()
} @all_messages if @letter_codes;
exit unless @all_messages;
my ( $html_filenames, $csv_filenames, $ods_filenames );
$csv_filenames = print_notices({
messages => \@all_messages,
split => $split,
output_directory => $output_directory,
format => 'csv',
}) if $csv;
$ods_filenames = print_notices({
messages => \@all_messages,
split => $split,
output_directory => $output_directory,
format => 'ods',
}) if $ods;
if ( $html ) {
## carriage return replaced by <br/> as output is html
foreach my $message (@all_messages) {
local $_ = $message->{'content'};
s/\n/<br \/>/g;
s/\r//g;
$message->{'content'} = $_;
}
$html_filenames = print_notices({
messages => \@all_messages,
split => $split,
output_directory => $output_directory,
format => 'html',
});
}
if ( @emails ) {
my $files = {
html => $html_filenames,
csv => $csv_filenames,
ods => $ods_filenames,
};
for my $email ( @emails ) {
send_files({
directory => $output_directory,
files => $files,
to => $email,
from => C4::Context->preference('KohaAdminEmailAddress'), # Should be replaced if bug 8000 is pushed
});
}
}
sub print_notices {
my ( $params ) = @_;
my $messages = $params->{messages};
my $split = $params->{split};
my $output_directory = $params->{output_directory};
my $format = $params->{format} // 'html';
die "Format $format is not known"
unless $format =~ m[^html$|^csv$|^ods$];
my ( @filenames, $messages_by_branch );
if ( $split ) {
foreach my $message (@$messages) {
push( @{ $messages_by_branch->{ $message->{'branchcode'} } }, $message );
}
} else {
$messages_by_branch->{all_branches} = $messages;
}
while ( my ( $branchcode, $branch_messages ) = each %$messages_by_branch ) {
my $letter_codes = @letter_codes == 0 ? 'all' : join '_', @letter_codes;
my $filename = $split
? "notices_$letter_codes-" . $today_iso . "-$branchcode.$format"
: "notices_$letter_codes-" . $today_iso . ".$format";
my $filepath = File::Spec->catdir( $output_directory, $filename );
if ( $format eq 'html' ) {
generate_html({
messages => $branch_messages,
filepath => $filepath,
});
} elsif ( $format eq 'csv' ) {
generate_csv ({
messages => $branch_messages,
filepath => $filepath,
});
} elsif ( $format eq 'ods' ) {
_generate_ods ({
messages => $branch_messages,
filepath => $filepath,
});
}
if ( $send ) {
foreach my $message ( @$branch_messages ) {
C4::Letters::_set_message_status(
{
message_id => $message->{'message_id'},
status => 'sent'
}
);
}
}
push @filenames, $filename;
}
return \@filenames;
}
sub generate_html {
my ( $params ) = @_;
my $messages = $params->{messages};
my $filepath = $params->{filepath};
my $template =
C4::Templates::gettemplate( 'batch/print-notices.tt', 'intranet',
new CGI );
$template->param(
stylesheet => C4::Context->preference("NoticeCSS"),
today => $today_syspref,
messages => $messages,
);
open my $OUTPUT, '>encoding(utf-8)', $filepath
or die "Could not open $filepath: $!";
print $OUTPUT $template->output;
close $OUTPUT;
}
sub generate_csv {
my ( $params ) = @_;
my $messages = $params->{messages};
my $filepath = $params->{filepath};
open my $OUTPUT, '>encoding(utf-8)', $filepath
or die "Could not open $filepath: $!";
my ( @csv_lines, $headers );
foreach my $message ( @$messages ) {
my @lines = split /\n/, $message->{content};
chomp for @lines;
# We don't have headers, get them
unless ( $headers ) {
$headers = $lines[0];
say $OUTPUT $headers;
}
shift @lines;
for my $line ( @lines ) {
next if $line =~ /^\s$/;
say $OUTPUT $line;
}
}
}
sub _generate_ods {
my ( $params ) = @_;
my $messages = $params->{messages};
my $ods_filepath = $params->{filepath};
# Prepare sheet
my $ods_content;
my $has_headers;
foreach my $message ( @$messages ) {
my @message_lines = split /\n/, $message->{content};
chomp for @message_lines;
# Get headers from first message
if ($has_headers) {
shift @message_lines;
} else {
$has_headers = 1;
}
foreach my $message_line ( @message_lines ) {
my @content_row;
my @message_cells = split $delimiter, $message_line;
foreach ( @message_cells ) {
push @content_row, Encode::encode( 'UTF8', $_ );
}
push @$ods_content, \@content_row;
}
}
# Process
generate_ods($ods_filepath, $ods_content);
}
sub send_files {
my ( $params ) = @_;
my $directory = $params->{directory};
my $files = $params->{files};
my $to = $params->{to};
my $from = $params->{from};
return unless $to and $from;
my $mail = MIME::Lite->new(
From => $from,
To => $to,
Subject => 'Print notices for ' . $today_syspref,
Type => 'multipart/mixed',
);
while ( my ( $type, $filenames ) = each %$files ) {
for my $filename ( @$filenames ) {
my $mimetype = $type eq 'html'
? 'text/html'
: $type eq 'csv'
? 'text/csv'
: $type eq 'ods'
? 'application/vnd.oasis.opendocument.spreadsheet'
: undef;
next unless $mimetype;
my $filepath = File::Spec->catdir( $directory, $filename );
next unless $filepath or -f $filepath;
$mail->attach(
Type => $mimetype,
Path => $filepath,
Filename => $filename,
Encoding => 'base64',
);
}
}
$mail->send;
}
=head1 NAME
gather_print_notices - Print waiting print notices
=head1 SYNOPSIS
gather_print_notices output_directory [-s|--split] [--html] [--csv] [--ods] [--letter_code=LETTER_CODE] [-e|--email=your_email@example.org] [-h|--help]
Will print all waiting print notices to the output_directory.
The generated filename will be notices-TODAY.[csv|html|ods] or notices-TODAY-BRANCHCODE.[csv|html|ods] if the --split parameter is given.
=head1 OPTIONS
=over
=item B<output_directory>
Define the output directory where the files will be generated.
=item B<--send|--nosend>
After files have been generated, messages status is changed from 'pending' to
'sent'. This is the default action, without this parameter or with --send.
Using --nosend, the message status is not changed.
=item B<-s|--split>
Split messages into separate files by borrower home library to OUTPUT_DIRECTORY/notices-CURRENT_DATE-BRANCHCODE.[csv|html|ods]
=item B<--html>
Generate the print notices in a html file (default is --html, if --csv and --ods are not given).
=item B<--csv>
Generate the print notices in a csv file.
If you use this parameter, the template should contain 2 lines.
The first one the csv headers and the second one the value list.
For example:
cardnumber:patron:email:item
<<borrowers.cardnumber>>:<<borrowers.firstname>> <<borrowers.surname>>:<<borrowers.email>>:<<items.barcode>>
You have to combine this option with one (and only one) letter_code.
=item B<--ods>
Generate the print notices in a ods file.
This is the same as the csv parameter but using csv2odf to generate an ods file instead of a csv file.
=item B<--letter_code>
Filter print messages by letter_code.
Several letter_code parameters can be given.
=item B<-e|--email>
Repeatable.
E-mail address to send generated files to.
=item B<-h|--help>
Print a brief help message
=back
=head1 AUTHOR
Jesse Weaver <pianohacker@gmail.com>
Jonathan Druart <jonathan.druart@biblibre.com>
=head1 COPYRIGHT
Copyright 2009 Jesse Weaver
Copyright 2014 BibLibre
=head1 LICENSE
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 3 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, see <http://www.gnu.org/licenses>.
=cut