Update release notes for 19.05.02 release
[koha.git] / C4 / Print.pm
1 package C4::Print;
2
3 # Copyright 2000-2002 Katipo Communications
4 #
5 # This file is part of Koha.
6 #
7 # Koha is free software; you can redistribute it and/or modify it
8 # under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 3 of the License, or
10 # (at your option) any later version.
11 #
12 # Koha is distributed in the hope that it will be useful, but
13 # WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU General Public License for more details.
16 #
17 # You should have received a copy of the GNU General Public License
18 # along with Koha; if not, see <http://www.gnu.org/licenses>.
19
20 use strict;
21 #use warnings; FIXME - Bug 2505
22 use C4::Context;
23
24 use vars qw(@ISA @EXPORT);
25
26 BEGIN {
27         require Exporter;
28         @ISA    = qw(Exporter);
29     @EXPORT = qw(&NetworkPrint);
30 }
31
32 =head1 NAME
33
34 C4::Print - Koha module dealing with printing
35
36 =head1 SYNOPSIS
37
38   use C4::Print;
39
40 =head1 DESCRIPTION
41
42 The functions in this module handle sending text to a printer.
43
44 =head1 FUNCTIONS
45
46 =head2 NetworkPrint
47
48   &NetworkPrint($text)
49
50 Queue some text for printing on the selected branch printer
51
52 =cut
53
54 sub NetworkPrint {
55     my ($text) = @_;
56
57 # FIXME - It'd be nifty if this could generate pretty PostScript.
58
59     my $queue = '';
60
61     # FIXME - If 'queue' is undefined or empty, then presumably it should
62     # mean "use the default queue", whatever the default is. Presumably
63     # the default depends on the physical location of the machine.
64     # FIXME - Perhaps "print to file" should be a supported option. Just
65     # set the queue to "file" (or " file", if real queues aren't allowed
66     # to have spaces in them). Or perhaps if $queue eq "" and
67     # $env->{file} ne "", then that should mean "print to $env->{file}".
68
69     my $fh;
70     if ( $queue eq "" || $queue eq 'nulllp' ) {
71         return;
72         #open( $fh, ">/tmp/kohaiss" );
73     }
74     else {
75
76         # FIXME - This assumes that 'lpr' exists, and works as expected.
77         # This is a reasonable assumption, but only because every other
78         # printing package has a wrapper script called 'lpr'. It'd still
79         # be better to be able to customize this.
80         open( $fh, "-|", "lpr -P $queue > /dev/null" )
81           or die "Couldn't write to queue:$queue!\n";
82     }
83
84     #  print $queue;
85     #open (FILE,">/tmp/$file");
86     print $fh $text;
87     print $fh "\r\n" x 7 ;
88     close $fh;
89
90     #system("lpr /tmp/$file");
91 }
92
93 1;
94 __END__
95
96 =head1 AUTHOR
97
98 Koha Development Team <http://koha-community.org/>
99
100 =head1 SEE ALSO
101
102 C4::Circulation::Circ2(3)
103
104 =cut