--- /dev/null
+package SL::Presenter::Text;
+
+use strict;
+
+use parent qw(Exporter);
+
+use Exporter qw(import);
+our @EXPORT = qw(simple_format truncate);
+
+use Carp;
+
+sub truncate {
+ my ($self, $text, %params) = @_;
+
+ $params{at} ||= 50;
+ $params{at} = 3 if 3 > $params{at};
+ $params{at} -= 3;
+
+ return $text if length($text) < $params{at};
+ return substr($text, 0, $params{at}) . '...';
+}
+
+sub simple_format {
+ my ($self, $text, %params) = @_;
+
+ $text = $::locale->quote_special_chars('HTML', $text || '');
+
+ $text =~ s{\r\n?}{\n}g; # \r\n and \r -> \n
+ $text =~ s{\n\n+}{</p>\n\n<p>}g; # 2+ newline -> paragraph
+ $text =~ s{([^\n]\n)(?=[^\n])}{$1<br />}g; # 1 newline -> br
+
+ return '<p>' . $text;
+}
+
+1;
+__END__
+
+=pod
+
+=encoding utf8
+
+=head1 NAME
+
+SL::Presenter::Text - Presenter module for assorted text helpers
+
+=head1 SYNOPSIS
+
+ my $long_text = "This is very, very long. Need shorter, surely.";
+ my $truncated = $::request->presenter->truncate($long_text, at => 10);
+ # Result: "This is..."
+
+=head1 FUNCTIONS
+
+=over 4
+
+=item C<truncate $text, [%params]>
+
+Returns the C<$text> truncated after a certain number of
+characters.
+
+The number of characters to truncate at is determined by the parameter
+C<at> 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.
+
+=item C<simple_format $text>
+
+Applies simple formatting rules to C<$text>: The text is put into
+paragraph HTML tags. Two consecutive newlines are interpreted as a
+paragraph change: they close the current paragraph tag and start a new
+one. Single newlines are converted to line breaks. Carriage returns
+are removed.
+
+=back
+
+=head1 BUGS
+
+Nothing here yet.
+
+=head1 AUTHOR
+
+Moritz Bunkus E<lt>m.bunkus@linet-services.deE<gt>
+
+=cut
return $_[0]->{CONTEXT};
}
+sub _call_presenter {
+ my ($method, @args) = @_;
+
+ my $presenter = $::request->presenter;
+
+ return '' unless $presenter->can($method);
+
+ splice @args, -1, 1, %{ $args[-1] } if @args && (ref($args[-1]) eq 'HASH');
+
+ $presenter->$method(@args);
+}
+
sub name_to_id {
my $self = shift;
my $name = shift;
my $with_empty = delete($attributes{with_empty});
my $empty_title = delete($attributes{empty_title});
+ my $with_optgroups = delete($attributes{with_optgroups});
+
my %selected;
if ( ref($attributes{default}) eq 'ARRAY' ) {
delete($attributes{default});
- my @options;
-
- if ( $with_empty ) {
- push(@options, [undef, $empty_title || '']);
- }
+ my @all_options;
+ push @all_options, [undef, $empty_title || ''] if $with_empty;
my $normalize_entry = sub {
-
my ($type, $entry, $sub, $key) = @_;
- if ( $sub ) {
- return $sub->($entry);
- }
+ return $sub->($entry) if $sub;
my $ref = ref($entry);
if ( !$ref ) {
-
- if ( $type eq 'value' || $type eq 'title' ) {
- return $entry;
- }
-
+ return $entry if $type eq 'value' || $type eq 'title';
return 0;
}
if ( $ref eq 'ARRAY' ) {
-
- if ( $type eq 'value' ) {
- return $entry->[0];
- }
-
- if ( $type eq 'title' ) {
- return $entry->[1];
- }
-
- return $entry->[2];
- }
-
- if ( $ref eq 'HASH' ) {
- return $entry->{$key};
- }
-
- if ( $type ne 'default' || $entry->can($key) ) {
- return $entry->$key;
+ return $entry->[ $type eq 'value' ? 0 : $type eq 'title' ? 1 : 2 ];
}
+ return $entry->{$key} if $ref eq 'HASH';
+ return $entry->$key if $type ne 'default' || $entry->can($key);
return undef;
};
- foreach my $entry ( @{ $collection } ) {
- my $value;
- my $title;
+ my $list_to_code = sub {
+ my ($sub_collection) = @_;
- if ( $value_title_sub ) {
- ($value, $title) = @{ $value_title_sub->($entry) };
- } else {
+ my @options;
+ foreach my $entry ( @{ $sub_collection } ) {
+ my $value;
+ my $title;
- $value = $normalize_entry->('value', $entry, $value_sub, $value_key);
- $title = $normalize_entry->('title', $entry, $title_sub, $title_key);
- }
+ if ( $value_title_sub ) {
+ ($value, $title) = @{ $value_title_sub->($entry) };
+ } else {
- my $default = $normalize_entry->('default', $entry, $default_sub, $default_key);
+ $value = $normalize_entry->('value', $entry, $value_sub, $value_key);
+ $title = $normalize_entry->('title', $entry, $title_sub, $title_key);
+ }
- push(@options, [$value, $title, $default]);
- }
+ my $default = $normalize_entry->('default', $entry, $default_sub, $default_key);
- foreach my $entry (@options) {
- if ( exists($selected{$entry->[0]}) ) {
- $entry->[2] = 1;
+ push(@options, [$value, $title, $default]);
}
- }
- my $code = '';
+ foreach my $entry (@options) {
+ $entry->[2] = 1 if $selected{$entry->[0]};
+ }
- foreach my $entry (@options) {
- my %args = (value => $entry->[0]);
+ return join '', map { $self->html_tag('option', _H($_->[1]), value => $_->[0], selected => $_->[2]) } @options;
+ };
- $args{selected} = $entry->[2];
+ my $code;
- $code .= $self->html_tag('option', _H($entry->[1]), %args);
- }
+ if (!$with_optgroups) {
+ $code = $list_to_code->($collection);
- $code = $self->html_tag('select', $code, %attributes, name => $name);
+ } else {
+ $code = join '', map {
+ my ($optgroup_title, $sub_collection) = @{ $_ };
+ $self->html_tag('optgroup', $list_to_code->($sub_collection), label => $optgroup_title)
+ } @{ $collection };
+ }
- return $code;
+ return $self->html_tag('select', $code, %attributes, name => $name);
}
sub textarea_tag {
}
sub truncate {
- my ($self, $text, @slurp) = @_;
- my %params = _hashify(@slurp);
-
- $params{at} ||= 50;
- $params{at} = 3 if 3 > $params{at};
- $params{at} -= 3;
-
- return $text if length($text) < $params{at};
- return substr($text, 0, $params{at}) . '...';
+ my $self = shift;
+ return _call_presenter('truncate', @_);
}
sub sortable_table_header {
return SL::Presenter->get->render('common/paginate', %template_params);
}
+sub simple_format {
+ my $self = shift;
+ return _call_presenter('simple_format', @_);
+}
+
1;
__END__
The tag's C<id> defaults to C<name_to_id($name)>.
+If the option C<with_optgroups> is set then this function expects
+C<\@collection> to be one level deeper. The upper-most level is
+translated into a HTML C<optgroup> tag. So the structure becomes:
+
+=over 4
+
+=item 1. Array of array references. Each element in the
+C<\@collection> is converted into an optgroup.
+
+=item 2. The optgroup's C<label> attribute will be set to the the
+first element in the array element. The second array element is then
+converted to a list of C<option> tags like it is described above.
+
+=back
+
+Example for use of optgroups:
+
+ # First in a controller:
+ my @collection = (
+ [ t8("First optgroup with two items"),
+ [ { id => 42, name => "item one" },
+ { id => 54, name => "second item" },
+ { id => 23, name => "and the third one" },
+ ] ],
+ [ t8("Another optgroup, with a lot of items from Rose"),
+ SL::DB::Manager::Customer->get_all_sorted ],
+ );
+
+ # Later in the template:
+ [% L.select_tag('the_selection', COLLECTION, with_optgroups=1, title_key='name') %]
+
=item C<yes_no_tag $name, $value, %attributes>
Creates a HTML 'select' tag with the two entries C<yes> and C<no> by
L.tab('Awesome tab wih much info', '_much_info.html', if => SELF.wants_all)
-=item C<truncate $text, %params>
+=item C<truncate $text, [%params]>
+
+See L<SL::Presenter::Text/truncate>.
-Returns the C<$text> truncated after a certain number of
-characters.
+=item C<simple_format $text>
-The number of characters to truncate at is determined by the parameter
-C<at> 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.
+See L<SL::Presenter::Text/simple_format>.
=back