C4/Print.pm

   1 package C4::Print; #assumes C4/Print.pm
   2
   3
   4 # Copyright 2000-2002 Katipo Communications
   5 #
   6 # This file is part of Koha.
   7 #
   8 # Koha is free software; you can redistribute it and/or modify it under the
   9 # terms of the GNU General Public License as published by the Free Software
  10 # Foundation; either version 2 of the License, or (at your option) any later
  11 # version.
  12 #
  13 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  14 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  15 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License along with
  18 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
  19 # Suite 330, Boston, MA  02111-1307 USA
  20
  21 use strict;
  22 require Exporter;
  23 #use C4::InterfaceCDK;
  24
  25 use C4::Context;
  26 use C4::Circulation::Circ2;
  27
  28 use vars qw($VERSION @ISA @EXPORT);
  29
  30 # set the version for version checking
  31 $VERSION = 0.01;
  32
  33 =head1 NAME
  34
  35 C4::Print - Koha module dealing with printing
  36
  37 =head1 SYNOPSIS
  38
  39   use C4::Print;
  40
  41 =head1 DESCRIPTION
  42
  43 The functions in this module handle sending text to a printer.
  44
  45 =head1 FUNCTIONS
  46
  47 =over 2
  48
  49 =cut
  50
  51 @ISA = qw(Exporter);
  52 @EXPORT = qw(&remoteprint &printreserve &printslip);
  53
  54 =item remoteprint
  55
  56   &remoteprint($env, $items, $borrower);
  57
  58 Prints the list of items in C<$items> to a printer.
  59
  60 C<$env> is a reference-to-hash. C<$env-E<gt>{queue}> specifies the
  61 queue to print to; if it is empty or has the special value C<nulllp>,
  62 C<&remoteprint> will print to the file F</tmp/kohaiss>.
  63
  64 C<$borrower> is a reference-to-hash giving information about a patron.
  65 This may be gotten from C<&getpatroninformation>. The patron's name
  66 will be printed in the output.
  67
  68 C<$items> is a reference-to-list, where each element is a
  69 reference-to-hash describing a borrowed item. C<$items> may be gotten
  70 from C<&currentissues>.
  71
  72 =cut
  73 #'
  74 # FIXME - It'd be nifty if this could generate pretty PostScript.
  75 sub remoteprint {
  76   my ($env,$items,$borrower)=@_;
  77
  78   (return) unless (C4::Context->boolean_preference('printcirculationslips'));
  79   my $queue = $env->{'queue'};
  80   # FIXME - If 'queue' is undefined or empty, then presumably it should
  81   # mean "use the default queue", whatever the default is. Presumably
  82   # the default depends on the physical location of the machine.
  83   # FIXME - Perhaps "print to file" should be a supported option. Just
  84   # set the queue to "file" (or " file", if real queues aren't allowed
  85   # to have spaces in them). Or perhaps if $queue eq "" and
  86   # $env->{file} ne "", then that should mean "print to $env->{file}".
  87   if ($queue eq "" || $queue eq 'nulllp') {
  88     open (PRINTER,">/tmp/kohaiss");
  89   } else {
  90     # FIXME - This assumes that 'lpr' exists, and works as expected.
  91     # This is a reasonable assumption, but only because every other
  92     # printing package has a wrapper script called 'lpr'. It'd still
  93     # be better to be able to customize this.
  94     open(PRINTER, "| lpr -P $queue > /dev/null") or die "Couldn't write to queue:$queue!\n";
  95   }
  96 #  print $queue;
  97   #open (FILE,">/tmp/$file");
  98   my $i=0;
  99   my $brdata = $env->{'brdata'};        # FIXME - Not used
 100   # FIXME - This is HLT-specific. Put this stuff in a customizable
 101   # site-specific file somewhere.
 102   print PRINTER "Horowhenua Library Trust\r\n";
 103 #  print PRINTER "$brdata->{'branchname'}\r\n";
 104   print PRINTER "Phone: 368-1953\r\n";
 105   print PRINTER "Fax:    367-9218\r\n";
 106   print PRINTER "Email:  renewals\@library.org.nz\r\n\r\n\r\n";
 107   print PRINTER "$borrower->{'cardnumber'}\r\n";
 108   print PRINTER "$borrower->{'title'} $borrower->{'initials'} $borrower->{'surname'}\r\n";
 109   # FIXME - Use   for ($i = 0; $items->[$i]; $i++)
 110   # Or better yet,   foreach $item (@{$items})
 111   while ($items->[$i]){
 112 #    print $i;
 113     my $itemdata = $items->[$i];
 114     # FIXME - This is just begging for a Perl format.
 115     print PRINTER "$i $itemdata->{'title'}\r\n";
 116     print PRINTER "$itemdata->{'barcode'}";
 117     print PRINTER " "x15;
 118     print PRINTER "$itemdata->{'date_due'}\r\n";
 119     $i++;
 120   }
 121   print PRINTER "\r\n\r\n\r\n\r\n\r\n\r\n\r\n";
 122   if ($env->{'printtype'} eq "docket"){
 123     #print chr(27).chr(105);
 124   }
 125   close PRINTER;
 126   #system("lpr /tmp/$file");
 127 }
 128
 129 sub printreserve {
 130   my($env, $branchname, $bordata, $itemdata)=@_;
 131   my $file=time;
 132   my $printer = $env->{'printer'};
 133   (return) unless (C4::Context->boolean_preference('printreserveslips'));
 134   if ($printer eq "" || $printer eq 'nulllp') {
 135     open (PRINTER,">>/tmp/kohares");
 136   } else {
 137     open (PRINTER, "| lpr -P $printer >/dev/null") or die "Couldn't write to queue:$!\n";
 138   }
 139   my @da = localtime(time());
 140   my $todaysdate = "$da[2]:$da[1]  $da[3]/$da[4]/$da[5]";
 141
 142 #(1900+$datearr[5]).sprintf ("%0.2d", ($datearr[4]+1)).sprintf ("%0.2d", $datearr[3]);
 143   my $slip = <<"EOF";
 144 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 145 Date: $todaysdate;
 146
 147 ITEM RESERVED:
 148 $itemdata->{'title'} ($itemdata->{'author'})
 149 barcode: $itemdata->{'barcode'}
 150
 151 COLLECT AT: $branchname
 152
 153 BORROWER:
 154 $bordata->{'surname'}, $bordata->{'firstname'}
 155 card number: $bordata->{'cardnumber'}
 156 Phone: $bordata->{'phone'}
 157 $bordata->{'streetaddress'}
 158 $bordata->{'suburb'}
 159 $bordata->{'town'}
 160 $bordata->{'emailaddress'}
 161
 162
 163 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 164 EOF
 165     print PRINTER $slip;
 166   close PRINTER;
 167   return $slip;
 168 }
 169
 170 =item printslip
 171
 172   &printslip($env, $borrowernumber)
 173
 174   print a slip for the given $borrowernumber
 175
 176 =cut
 177 #'
 178 sub printslip {
 179     my ($env,$borrowernumber)=@_;
 180     my ($borrower, $flags) = getpatroninformation($env,$borrowernumber,0);
 181     $env->{'todaysissues'}=1;
 182     my ($borrowerissues) = currentissues($env, $borrower);
 183     $env->{'nottodaysissues'}=1;
 184     $env->{'todaysissues'}=0;
 185     my ($borroweriss2)=currentissues($env, $borrower);
 186     $env->{'nottodaysissues'}=0;
 187     my $i=0;
 188     my @issues;
 189     foreach (sort {$a <=> $b} keys %$borrowerissues) {
 190         $issues[$i]=$borrowerissues->{$_};
 191         my $dd=$issues[$i]->{'date_due'};
 192         #convert to nz style dates
 193         #this should be set with some kinda config variable
 194         my @tempdate=split(/-/,$dd);
 195         $issues[$i]->{'date_due'}="$tempdate[2]/$tempdate[1]/$tempdate[0]";
 196         $i++;
 197     }
 198     foreach (sort {$a <=> $b} keys %$borroweriss2) {
 199         $issues[$i]=$borroweriss2->{$_};
 200         my $dd=$issues[$i]->{'date_due'};
 201         #convert to nz style dates
 202         #this should be set with some kinda config variable
 203         my @tempdate=split(/-/,$dd);
 204         $issues[$i]->{'date_due'}="$tempdate[2]/$tempdate[1]/$tempdate[0]";
 205         $i++;
 206     }
 207     remoteprint($env,\@issues,$borrower);
 208 }
 209
 210 END { }       # module clean-up code here (global destructor)
 211
 212 1;
 213 __END__
 214
 215 =back
 216
 217 =head1 AUTHOR
 218
 219 Koha Developement team <info@koha.org>
 220
 221 =head1 SEE ALSO
 222
 223 C4::Circulation::Circ2(3)
 224
 225 =cut