X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;ds=sidebyside;f=SL%2FPresenter%2FText.pm;h=7d56d940be03243c36facae0759dee93a1f50401;hb=53593baa211863fbf66540cf1bcc36c8fb37257f;hp=637bff6b652f7b8188153aafff4a35d5bb50dbd1;hpb=ffae956c7cc34001662a0081cd587ceda0903abe;p=kivitendo-erp.git diff --git a/SL/Presenter/Text.pm b/SL/Presenter/Text.pm index 637bff6b6..7d56d940b 100644 --- a/SL/Presenter/Text.pm +++ b/SL/Presenter/Text.pm @@ -2,26 +2,26 @@ package SL::Presenter::Text; use strict; -use parent qw(Exporter); +use SL::Presenter::EscapedText qw(escape); +use SL::HTML::Restrict; +use SL::HTML::Util; use Exporter qw(import); -our @EXPORT = qw(format_man_days simple_format truncate); +our @EXPORT_OK = qw(format_man_days simple_format truncate restricted_html); +our %EXPORT_TAGS = (ALL => \@EXPORT_OK); use Carp; -sub truncate { - my ($self, $text, %params) = @_; +my $html_cleaner; - $params{at} ||= 50; - $params{at} = 3 if 3 > $params{at}; - $params{at} -= 3; +sub truncate { + my ($text, %params) = @_; - return $text if length($text) < $params{at}; - return substr($text, 0, $params{at}) . '...'; + escape(Common::truncate($text, %params)); } sub simple_format { - my ($self, $text, %params) = @_; + my ($text, %params) = @_; $text = $::locale->quote_special_chars('HTML', $text || ''); @@ -33,18 +33,29 @@ sub simple_format { } sub format_man_days { - my ($self, $value, %params) = @_; + my ($value, %params) = @_; return '---' if $params{skip_zero} && !$value; - return $self->escape($::locale->text('#1 h', $::form->format_amount(\%::myconfig, $value, 2))) if 8.0 > $value; + return escape($::locale->text('#1 h', $::form->format_amount(\%::myconfig, $value, 2))) if 8.0 > $value; $value /= 8.0; my $output = $::locale->text('#1 MD', int($value)); my $rest = ($value - int($value)) * 8.0; $output .= ' ' . $::locale->text('#1 h', $::form->format_amount(\%::myconfig, $rest)) if $rest > 0.0; - return $self->escape($output); + escape($output); +} + +sub restricted_html { + my ($value) = @_; + $html_cleaner //= SL::HTML::Restrict->create; + return $html_cleaner->process($value); +} + +sub stripped_html { + my ($value) = @_; + return SL::HTML::Util::strip($value); } 1; @@ -60,8 +71,10 @@ SL::Presenter::Text - Presenter module for assorted text helpers =head1 SYNOPSIS + use SL::Presenter::Text qw(truncate); + my $long_text = "This is very, very long. Need shorter, surely."; - my $truncated = $::request->presenter->truncate($long_text, at => 10); + my $truncated = truncate($long_text, at => 10); # Result: "This is..." =head1 FUNCTIONS @@ -77,15 +90,11 @@ it, e.g. C<2 PT 2 h> for the value C<18> and German. If the parameter C is trueish then C<---> is returned instead of the normal formatting if C<$value> equals 0. -=item C +=item C Returns the C<$text> truncated after a certain number of -characters. - -The number of characters to truncate at is determined by the parameter -C which defaults to 50. If the text is longer than C<$params{at}> -then it will be truncated and postfixed with '...'. Otherwise it will -be returned unmodified. +characters. See L for the actual implementation and +supported parameters. =item C @@ -95,6 +104,16 @@ paragraph change: they close the current paragraph tag and start a new one. Single newlines are converted to line breaks. Carriage returns are removed. +=item C + +Returns HTML code stripped from unwanted/unsupported content. This is +done via the module L. + +=item C + +Returns the raw text with all HTML tags and comments stripped. This is +done via L. + =back =head1 BUGS