deutsche kommentare und blogposts entfernt.
[kivitendo-erp.git] / SL / Common.pm
1 #====================================================================
2 # LX-Office ERP
3 # Copyright (C) 2004
4 # Based on SQL-Ledger Version 2.1.9
5 # Web http://www.lx-office.org
6 #
7 #====================================================================
8
9 package Common;
10
11 use utf8;
12 use strict;
13
14 use Carp;
15 use Time::HiRes qw(gettimeofday);
16 use Data::Dumper;
17 use File::Copy;
18 use File::stat;
19 use File::Slurp;
20
21 use SL::DBUtils;
22
23 sub unique_id {
24   my ($a, $b) = gettimeofday();
25   return "${a}-${b}-${$}";
26 }
27
28 sub tmpname {
29   return "/tmp/kivitendo-tmp-" . unique_id();
30 }
31
32 sub truncate {
33   my ($text, %params) = @_;
34
35   $params{at}       //= 50;
36   $params{at}         =  3 if 3 > $params{at};
37
38   $params{strip}    //= '';
39
40   $text =~ s/[\r\n]+$//g if $params{strip} =~ m/^(?: 1 | newlines? | full )$/x;
41   $text =~ s/[\r\n]+/ /g if $params{strip} =~ m/^(?:     newlines? | full )$/x;
42
43   return $text if length($text) <= $params{at};
44   return substr($text, 0, $params{at} - 3) . '...';
45 }
46
47 sub retrieve_parts {
48   $main::lxdebug->enter_sub();
49
50   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
51
52   my $dbh = $form->dbconnect($myconfig);
53
54   my (@filter_values, $filter);
55
56   foreach (qw(partnumber description ean)) {
57     next unless $form->{$_};
58
59     $filter .= qq| AND ($_ ILIKE ?)|;
60     push @filter_values, '%' . $form->{$_} . '%';
61   }
62
63   if ($form->{no_assemblies}) {
64     $filter .= qq| AND (NOT COALESCE(assembly, FALSE))|;
65   }
66   if ($form->{assemblies}) {
67     $filter .= qq| AND assembly=TRUE|;
68   }
69
70   if ($form->{no_services}) {
71     $filter .= qq| AND (inventory_accno_id is not NULL or assembly=TRUE)|;
72   }
73
74   substr($filter, 1, 3) = "WHERE" if ($filter);
75
76   $order_by =~ s/[^a-zA-Z_]//g;
77   $order_dir = $order_dir ? "ASC" : "DESC";
78
79   my $query =
80     qq|SELECT id, partnumber, description, ean, | .
81     qq|       warehouse_id, bin_id | .
82     qq|FROM parts $filter | .
83     qq|ORDER BY $order_by $order_dir|;
84   my $sth = $dbh->prepare($query);
85   $sth->execute(@filter_values) || $form->dberror($query . " (" . join(", ", @filter_values) . ")");
86   my $parts = [];
87   while (my $ref = $sth->fetchrow_hashref()) {
88     push(@{$parts}, $ref);
89   }
90   $sth->finish();
91   $dbh->disconnect();
92
93   $main::lxdebug->leave_sub();
94
95   return $parts;
96 }
97
98 sub retrieve_projects {
99   $main::lxdebug->enter_sub();
100
101   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
102
103   my $dbh = $form->dbconnect($myconfig);
104
105   my (@filter_values, $filter);
106   if ($form->{"projectnumber"}) {
107     $filter .= qq| AND (projectnumber ILIKE ?)|;
108     push(@filter_values, '%' . $form->{"projectnumber"} . '%');
109   }
110   if ($form->{"description"}) {
111     $filter .= qq| AND (description ILIKE ?)|;
112     push(@filter_values, '%' . $form->{"description"} . '%');
113   }
114   substr($filter, 1, 3) = "WHERE" if ($filter);
115
116   $order_by =~ s/[^a-zA-Z_]//g;
117   $order_dir = $order_dir ? "ASC" : "DESC";
118
119   my $query =
120     qq|SELECT id, projectnumber, description | .
121     qq|FROM project $filter | .
122     qq|ORDER BY $order_by $order_dir|;
123   my $sth = $dbh->prepare($query);
124   $sth->execute(@filter_values) || $form->dberror($query . " (" . join(", ", @filter_values) . ")");
125   my $projects = [];
126   while (my $ref = $sth->fetchrow_hashref()) {
127     push(@{$projects}, $ref);
128   }
129   $sth->finish();
130   $dbh->disconnect();
131
132   $main::lxdebug->leave_sub();
133
134   return $projects;
135 }
136
137 sub retrieve_employees {
138   $main::lxdebug->enter_sub();
139
140   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
141
142   my $dbh = $form->dbconnect($myconfig);
143
144   my (@filter_values, $filter);
145   if ($form->{"name"}) {
146     $filter .= qq| AND (name ILIKE ?)|;
147     push(@filter_values, '%' . $form->{"name"} . '%');
148   }
149   substr($filter, 1, 3) = "WHERE" if ($filter);
150
151   $order_by =~ s/[^a-zA-Z_]//g;
152   $order_dir = $order_dir ? "ASC" : "DESC";
153
154   my $query =
155     qq|SELECT id, name | .
156     qq|FROM employee $filter | .
157     qq|ORDER BY $order_by $order_dir|;
158   my $sth = $dbh->prepare($query);
159   $sth->execute(@filter_values) || $form->dberror($query . " (" . join(", ", @filter_values) . ")");
160   my $employees = [];
161   while (my $ref = $sth->fetchrow_hashref()) {
162     push(@{$employees}, $ref);
163   }
164   $sth->finish();
165   $dbh->disconnect();
166
167   $main::lxdebug->leave_sub();
168
169   return $employees;
170 }
171
172 sub retrieve_customers_or_vendors {
173   $main::lxdebug->enter_sub();
174
175   my ($self, $myconfig, $form, $order_by, $order_dir, $is_vendor, $allow_both) = @_;
176
177   my $dbh = $form->dbconnect($myconfig);
178
179   my (@filter_values, $filter);
180   if ($form->{"name"}) {
181     $filter .= " AND (TABLE.name ILIKE ?)";
182     push(@filter_values, '%' . $form->{"name"} . '%');
183   }
184   if (!$form->{"obsolete"}) {
185     $filter .= " AND NOT TABLE.obsolete";
186   }
187   substr($filter, 1, 3) = "WHERE" if ($filter);
188
189   $order_by =~ s/[^a-zA-Z_]//g;
190   $order_dir = $order_dir ? "ASC" : "DESC";
191
192   my (@queries, @query_parameters);
193
194   if ($allow_both || !$is_vendor) {
195     my $c_filter = $filter;
196     $c_filter =~ s/TABLE/c/g;
197     push(@queries, qq|SELECT
198                         c.id, c.name, 0 AS customer_is_vendor,
199                         c.street, c.zipcode, c.city,
200                         ct.cp_gender, ct.cp_title, ct.cp_givenname, ct.cp_name
201                       FROM customer c
202                       LEFT JOIN contacts ct ON (c.id = ct.cp_cv_id)
203                       $c_filter|);
204     push(@query_parameters, @filter_values);
205   }
206
207   if ($allow_both || $is_vendor) {
208     my $v_filter = $filter;
209     $v_filter =~ s/TABLE/v/g;
210     push(@queries, qq|SELECT
211                         v.id, v.name, 1 AS customer_is_vendor,
212                         v.street, v.zipcode, v.city,
213                         ct.cp_gender, ct.cp_title, ct.cp_givenname, ct.cp_name
214                       FROM vendor v
215                       LEFT JOIN contacts ct ON (v.id = ct.cp_cv_id)
216                       $v_filter|);
217     push(@query_parameters, @filter_values);
218   }
219
220   my $query = join(" UNION ", @queries) . " ORDER BY $order_by $order_dir";
221   my $sth = $dbh->prepare($query);
222   $sth->execute(@query_parameters) || $form->dberror($query . " (" . join(", ", @query_parameters) . ")");
223   my $customers = [];
224   while (my $ref = $sth->fetchrow_hashref()) {
225     push(@{$customers}, $ref);
226   }
227   $sth->finish();
228   $dbh->disconnect();
229
230   $main::lxdebug->leave_sub();
231
232   return $customers;
233 }
234
235 sub retrieve_delivery_customer {
236   $main::lxdebug->enter_sub();
237
238   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
239
240   my $dbh = $form->dbconnect($myconfig);
241
242   my (@filter_values, $filter);
243   if ($form->{"name"}) {
244     $filter .= qq| (name ILIKE ?) AND|;
245     push(@filter_values, '%' . $form->{"name"} . '%');
246   }
247
248   $order_by =~ s/[^a-zA-Z_]//g;
249   $order_dir = $order_dir ? "ASC" : "DESC";
250
251   my $query =
252     qq!SELECT id, name, customernumber, (street || ', ' || zipcode || city) AS address ! .
253     qq!FROM customer ! .
254     qq!WHERE $filter business_id = (SELECT id FROM business WHERE description = 'Endkunde') ! .
255     qq!ORDER BY $order_by $order_dir!;
256   my $sth = $dbh->prepare($query);
257   $sth->execute(@filter_values) ||
258     $form->dberror($query . " (" . join(", ", @filter_values) . ")");
259   my $delivery_customers = [];
260   while (my $ref = $sth->fetchrow_hashref()) {
261     push(@{$delivery_customers}, $ref);
262   }
263   $sth->finish();
264   $dbh->disconnect();
265
266   $main::lxdebug->leave_sub();
267
268   return $delivery_customers;
269 }
270
271 sub retrieve_vendor {
272   $main::lxdebug->enter_sub();
273
274   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
275
276   my $dbh = $form->dbconnect($myconfig);
277
278   my (@filter_values, $filter);
279   if ($form->{"name"}) {
280     $filter .= qq| (name ILIKE ?) AND|;
281     push(@filter_values, '%' . $form->{"name"} . '%');
282   }
283
284   $order_by =~ s/[^a-zA-Z_]//g;
285   $order_dir = $order_dir ? "ASC" : "DESC";
286
287   my $query =
288     qq!SELECT id, name, customernumber, (street || ', ' || zipcode || city) AS address FROM customer ! .
289     qq!WHERE $filter business_id = (SELECT id FROM business WHERE description = ?') ! .
290     qq!ORDER BY $order_by $order_dir!;
291   push @filter_values, $::locale->{iconv_utf8}->convert('Händler');
292   my $sth = $dbh->prepare($query);
293   $sth->execute(@filter_values) ||
294     $form->dberror($query . " (" . join(", ", @filter_values) . ")");
295   my $vendors = [];
296   while (my $ref = $sth->fetchrow_hashref()) {
297     push(@{$vendors}, $ref);
298   }
299   $sth->finish();
300   $dbh->disconnect();
301
302   $main::lxdebug->leave_sub();
303
304   return $vendors;
305 }
306
307 sub mkdir_with_parents {
308   $main::lxdebug->enter_sub();
309
310   my ($full_path) = @_;
311
312   my $path = "";
313
314   $full_path =~ s|/+|/|;
315
316   foreach my $part (split(m|/|, $full_path)) {
317     $path .= "/" if ($path);
318     $path .= $part;
319
320     die("Could not create directory '$path' because a file exists with " .
321         "the same name.\n") if (-f $path);
322
323     if (! -d $path) {
324       mkdir($path, 0770) || die("Could not create the directory '$path'. " .
325                                 "OS error: $!\n");
326     }
327   }
328
329   $main::lxdebug->leave_sub();
330 }
331
332 sub webdav_folder {
333   $main::lxdebug->enter_sub();
334
335   my ($form) = @_;
336
337   return $main::lxdebug->leave_sub()
338     unless ($::instance_conf->get_webdav && $form->{id});
339
340
341
342   $form->{WEBDAV} = [];
343
344   my ($path, $number) = get_webdav_folder($form);
345   return $main::lxdebug->leave_sub() unless ($path && $number);
346
347   if (!-d $path) {
348     mkdir_with_parents($path);
349
350   } else {
351     my $base_path = $ENV{'SCRIPT_NAME'};
352     $base_path =~ s|[^/]+$||;
353     if (opendir my $dir, $path) {
354       foreach my $file (sort { lc $a cmp lc $b } readdir $dir) {
355         next if (($file eq '.') || ($file eq '..'));
356
357         my $fname = $file;
358         $fname  =~ s|.*/||;
359
360         my $is_directory = -d "$path/$file";
361
362         $file  = join('/', map { $form->escape($_) } grep { $_ } split m|/+|, "$path/$file");
363         $file .=  '/' if ($is_directory);
364
365         push @{ $form->{WEBDAV} }, {
366           'name' => $fname,
367           'link' => $base_path . $file,
368           'type' => $is_directory ? $main::locale->text('Directory') : $main::locale->text('File'),
369         };
370       }
371
372       closedir $dir;
373     }
374   }
375
376   $main::lxdebug->leave_sub();
377 }
378
379 sub get_vc_details {
380   $main::lxdebug->enter_sub();
381
382   my ($self, $myconfig, $form, $vc, $vc_id) = @_;
383
384   $vc = $vc eq "customer" ? "customer" : "vendor";
385
386   my $dbh = $form->dbconnect($myconfig);
387
388   my $query;
389
390   $query =
391     qq|SELECT
392          vc.*,
393          pt.description AS payment_terms,
394          b.description AS business,
395          l.description AS language
396        FROM ${vc} vc
397        LEFT JOIN payment_terms pt ON (vc.payment_id = pt.id)
398        LEFT JOIN business b ON (vc.business_id = b.id)
399        LEFT JOIN language l ON (vc.language_id = l.id)
400        WHERE vc.id = ?|;
401   my $ref = selectfirst_hashref_query($form, $dbh, $query, $vc_id);
402
403   if (!$ref) {
404     $dbh->disconnect();
405     $main::lxdebug->leave_sub();
406     return 0;
407   }
408
409   map { $form->{$_} = $ref->{$_} } keys %{ $ref };
410
411   map { $form->{$_} = $form->format_amount($myconfig, $form->{$_} * 1) } qw(discount creditlimit);
412
413   $query = qq|SELECT * FROM shipto WHERE (trans_id = ?)|;
414   $form->{SHIPTO} = selectall_hashref_query($form, $dbh, $query, $vc_id);
415
416   $query = qq|SELECT * FROM contacts WHERE (cp_cv_id = ?)|;
417   $form->{CONTACTS} = selectall_hashref_query($form, $dbh, $query, $vc_id);
418
419   # Only show default pricegroup for customer, not vendor, which is why this is outside the main query
420   ($form->{pricegroup}) = selectrow_query($form, $dbh, qq|SELECT pricegroup FROM pricegroup WHERE id = ?|, $form->{klass});
421
422   $dbh->disconnect();
423
424   $main::lxdebug->leave_sub();
425
426   return 1;
427 }
428
429 sub get_shipto_by_id {
430   $main::lxdebug->enter_sub();
431
432   my ($self, $myconfig, $form, $shipto_id, $prefix) = @_;
433
434   $prefix ||= "";
435
436   my $dbh = $form->dbconnect($myconfig);
437
438   my $query = qq|SELECT * FROM shipto WHERE shipto_id = ?|;
439   my $ref   = selectfirst_hashref_query($form, $dbh, $query, $shipto_id);
440
441   map { $form->{"${prefix}${_}"} = $ref->{$_} } keys %{ $ref } if $ref;
442
443   $dbh->disconnect();
444
445   $main::lxdebug->leave_sub();
446 }
447
448 sub save_email_status {
449   $main::lxdebug->enter_sub();
450
451   my ($self, $myconfig, $form) = @_;
452
453   my ($table, $query, $dbh);
454
455   if ($form->{script} eq 'oe.pl') {
456     $table = 'oe';
457
458   } elsif ($form->{script} eq 'is.pl') {
459     $table = 'ar';
460
461   } elsif ($form->{script} eq 'ir.pl') {
462     $table = 'ap';
463
464   } elsif ($form->{script} eq 'do.pl') {
465     $table = 'delivery_orders';
466   }
467
468   return $main::lxdebug->leave_sub() if (!$form->{id} || !$table || !$form->{formname});
469
470   $dbh = $form->get_standard_dbh($myconfig);
471
472   my ($intnotes) = selectrow_query($form, $dbh, qq|SELECT intnotes FROM $table WHERE id = ?|, $form->{id});
473
474   $intnotes =~ s|\r||g;
475   $intnotes =~ s|\n$||;
476
477   $intnotes .= "\n\n" if ($intnotes);
478
479   my $cc  = $form->{cc}  ? $main::locale->text('Cc') . ": $form->{cc}\n"   : '';
480   my $bcc = $form->{bcc} ? $main::locale->text('Bcc') . ": $form->{bcc}\n" : '';
481   my $now = scalar localtime;
482
483   $intnotes .= $main::locale->text('[email]') . "\n"
484     . $main::locale->text('Date') . ": $now\n"
485     . $main::locale->text('To (email)') . ": $form->{email}\n"
486     . "${cc}${bcc}"
487     . $main::locale->text('Subject') . ": $form->{subject}\n\n"
488     . $main::locale->text('Message') . ": $form->{message}";
489
490   $intnotes =~ s|\r||g;
491
492   do_query($form, $dbh, qq|UPDATE $table SET intnotes = ? WHERE id = ?|, $intnotes, $form->{id});
493
494   $form->save_status($dbh);
495
496   $dbh->commit();
497
498   $main::lxdebug->leave_sub();
499 }
500
501 sub check_params {
502   my $params = shift;
503
504   foreach my $key (@_) {
505     if ((ref $key eq '') && !defined $params->{$key}) {
506       my $subroutine = (caller(1))[3];
507       $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, "[Common::check_params] failed, params object dumped below");
508       $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, Dumper($params));
509       $main::form->error($main::locale->text("Missing parameter #1 in call to sub #2.", $key, $subroutine));
510
511     } elsif (ref $key eq 'ARRAY') {
512       my $found = 0;
513       foreach my $subkey (@{ $key }) {
514         if (defined $params->{$subkey}) {
515           $found = 1;
516           last;
517         }
518       }
519
520       if (!$found) {
521         my $subroutine = (caller(1))[3];
522         $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, "[Common::check_params] failed, params object dumped below");
523         $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, Dumper($params));
524         $main::form->error($main::locale->text("Missing parameter (at least one of #1) in call to sub #2.", join(', ', @{ $key }), $subroutine));
525       }
526     }
527   }
528 }
529
530 sub check_params_x {
531   my $params = shift;
532
533   foreach my $key (@_) {
534     if ((ref $key eq '') && !exists $params->{$key}) {
535       my $subroutine = (caller(1))[3];
536       $main::form->error($main::locale->text("Missing parameter #1 in call to sub #2.", $key, $subroutine));
537
538     } elsif (ref $key eq 'ARRAY') {
539       my $found = 0;
540       foreach my $subkey (@{ $key }) {
541         if (exists $params->{$subkey}) {
542           $found = 1;
543           last;
544         }
545       }
546
547       if (!$found) {
548         my $subroutine = (caller(1))[3];
549         $main::form->error($main::locale->text("Missing parameter (at least one of #1) in call to sub #2.", join(', ', @{ $key }), $subroutine));
550       }
551     }
552   }
553 }
554
555 sub get_webdav_folder {
556   $main::lxdebug->enter_sub();
557
558   my ($form) = @_;
559
560   croak "No client set in \$::auth" unless $::auth->client;
561
562   my ($path, $number);
563
564   # dispatch table
565   if ($form->{type} eq "sales_quotation") {
566     ($path, $number) = ("angebote", $form->{quonumber});
567   } elsif ($form->{type} eq "sales_order") {
568     ($path, $number) = ("bestellungen", $form->{ordnumber});
569   } elsif ($form->{type} eq "request_quotation") {
570     ($path, $number) = ("anfragen", $form->{quonumber});
571   } elsif ($form->{type} eq "purchase_order") {
572     ($path, $number) = ("lieferantenbestellungen", $form->{ordnumber});
573   } elsif ($form->{type} eq "sales_delivery_order") {
574     ($path, $number) = ("verkaufslieferscheine", $form->{donumber});
575   } elsif ($form->{type} eq "purchase_delivery_order") {
576     ($path, $number) = ("einkaufslieferscheine", $form->{donumber});
577   } elsif ($form->{type} eq "credit_note") {
578     ($path, $number) = ("gutschriften", $form->{invnumber});
579   } elsif ($form->{vc} eq "customer") {
580     ($path, $number) = ("rechnungen", $form->{invnumber});
581   } elsif ($form->{vc} eq "vendor") {
582     ($path, $number) = ("einkaufsrechnungen", $form->{invnumber});
583   } else {
584     $main::lxdebug->leave_sub();
585     return undef;
586   }
587
588   $number =~ s|[/\\]|_|g;
589
590   $path = "webdav/" . $::auth->client->{id} . "/${path}/${number}";
591
592   $main::lxdebug->leave_sub();
593
594   return ($path, $number);
595 }
596
597 sub copy_file_to_webdav_folder {
598   $main::lxdebug->enter_sub();
599
600   my ($form) = @_;
601   my ($last_mod_time, $latest_file_name, $complete_path);
602
603   # checks
604   foreach my $item (qw(tmpdir tmpfile type)){
605     if (!$form->{$item}){
606       $main::lxdebug->message(0, 'Missing parameter');
607       $main::form->error($main::locale->text("Missing parameter for webdav file copy"));
608     }
609   }
610
611   my ($webdav_folder, $document_name) =  get_webdav_folder($form);
612
613   if (! $webdav_folder){
614     $main::lxdebug->leave_sub();
615     $main::form->error($main::locale->text("Cannot check correct webdav folder"));
616     return undef;
617   }
618
619   $complete_path =  join('/', $form->{cwd},  $webdav_folder);
620   opendir my $dh, $complete_path or die "Could not open $complete_path: $!";
621
622   my ($newest_name, $newest_time);
623   while ( defined( my $file = readdir( $dh ) ) ) {
624     my $path = File::Spec->catfile( $complete_path, $file );
625     next if -d $path; # skip directories, or anything else you like
626     ( $newest_name, $newest_time ) = ( $file, -M _ )
627         if( ! defined $newest_time or -M $path < $newest_time );
628     }
629   $latest_file_name = $complete_path .'/' . $newest_name;
630   my $filesize = stat($latest_file_name)->size;
631
632   my ($ext) = $form->{tmpfile} =~ /(\.[^.]+)$/;
633   my $current_file = join('/', $form->{tmpdir}, $form->{tmpfile});
634   my $current_filesize = stat($current_file)->size;
635   if ($current_filesize == $filesize) {
636     $main::lxdebug->leave_sub();
637     return;
638   }
639
640   my $timestamp = get_current_formatted_time();
641   my $myfilename = $form->generate_attachment_filename();
642   $myfilename =~ s/\./$timestamp\./;
643
644   if (!copy(join('/', $form->{tmpdir}, $form->{tmpfile}), join('/', $form->{cwd}, $webdav_folder, $myfilename))) {
645     my $j = join('/', $form->{tmpdir}, $form->{tmpfile});
646     my $k = join('/', $form->{cwd},  $webdav_folder);
647     $main::lxdebug->message(0, "Copy file from $j to $k failed");
648     $main::form->error($main::locale->text("Copy file from #1 to #2 failed", $j, $k));
649   }
650
651   $main::lxdebug->leave_sub();
652 }
653 sub get_current_formatted_time {
654   $main::lxdebug->enter_sub();
655
656   my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst)=localtime(time);
657   my $formatted_current_time = sprintf ( "_%04d%02d%02d_%02d%02d%02d",
658                                    $year+1900,$mon+1,$mday,$hour,$min,$sec);
659
660   $main::lxdebug->leave_sub();
661   return $formatted_current_time;
662 }
663
664 1;
665 __END__
666
667 =pod
668
669 =encoding utf8
670
671 =head1 NAME
672
673 Common - Common routines used in a lot of places.
674
675 =head1 SYNOPSIS
676
677   my $short_text = Common::truncate($long_text, at => 10);
678
679 =head1 FUNCTIONS
680
681 =over 4
682
683 =item C<truncate $text, %params>
684
685 Truncates C<$text> at a position and insert an ellipsis if the text is
686 longer. The maximum number of characters to return is given with the
687 paramter C<at> which defaults to 50.
688
689 The optional parameter C<strip> can be used to remove unwanted line
690 feed/carriage return characters from the text before truncation. It
691 can be set to C<1> (only strip those at the end of C<$text>) or
692 C<full> (replace consecutive line feed/carriage return characters in
693 the middle by a single space and remove tailing line feed/carriage
694 return characters).
695
696 =back
697
698 =head1 BUGS
699
700 Nothing here yet.
701
702 =head1 AUTHOR
703
704 Moritz Bunkus E<lt>m.bunkus@linet-services.deE<gt>,
705 Sven Schöling E<lt>s.schoeling@linet-services.deE<gt>
706
707 =cut