SL/Presenter/CustomerVendor.pm

   1 package SL::Presenter::CustomerVendor;
   2
   3 use strict;
   4
   5 use parent qw(Exporter);
   6
   7 use Exporter qw(import);
   8 our @EXPORT = qw(customer_vendor customer vendor customer_vendor_picker);
   9
  10 use Carp;
  11
  12 sub customer_vendor {
  13   my ($self, $customer_vendor, %params) = @_;
  14   return _customer_vendor($self, $customer_vendor, ref($customer_vendor) eq 'SL::DB::Customer' ? 'customer' : 'vendor', %params);
  15 }
  16
  17 sub customer {
  18   my ($self, $customer, %params) = @_;
  19   return _customer_vendor($self, $customer, 'customer', %params);
  20 }
  21
  22 sub vendor {
  23   my ($self, $vendor, %params) = @_;
  24   return _customer_vendor($self, $vendor, 'vendor', %params);
  25 }
  26
  27 sub _customer_vendor {
  28   my ($self, $cv, $type, %params) = @_;
  29
  30   $params{display} ||= 'inline';
  31
  32   croak "Unknown display type '$params{display}'" unless $params{display} =~ m/^(?:inline|table-cell)$/;
  33
  34   my $callback = $params{callback} ? '&callback=' . $::form->escape($params{callback}) : '';
  35
  36   my $text = join '', (
  37     $params{no_link} ? '' : '<a href="controller.pl?action=CustomerVendor/edit&amp;db=' . $type . '&amp;id=' . $self->escape($cv->id) . '">',
  38     $self->escape($cv->name),
  39     $params{no_link} ? '' : '</a>',
  40   );
  41   return $self->escaped_text($text);
  42 }
  43
  44 sub customer_vendor_picker {
  45   my ($self, $name, $value, %params) = @_;
  46
  47   croak 'Unknown "type" parameter' unless $params{type} =~ m{^(?:customer|vendor)$};
  48   croak 'Unknown value class'      if     $value && ref($value) && (ref($value) !~ m{^SL::DB::(?:Customer|Vendor)$});
  49
  50   if ($value && !ref $value) {
  51     my $class = $params{type} eq 'customer' ? 'SL::DB::Manager::Customer' : 'SL::DB::Manager::Vendor';
  52     $value    = $class->find_by(id => $value);
  53   }
  54
  55   my $id = delete($params{id}) || $self->name_to_id($name);
  56   my $fat_set_item = delete $params{fat_set_item};
  57
  58   my @classes = $params{class} ? ($params{class}) : ();
  59   push @classes, 'customer_vendor_autocomplete';
  60   push @classes, 'customer-vendor-picker-fat-set-item' if $fat_set_item;
  61
  62   my $ret =
  63     $self->input_tag($name, (ref $value && $value->can('id') ? $value->id : ''), class => "@classes", type => 'hidden', id => $id) .
  64     join('', map { $params{$_} ? $self->input_tag("", delete $params{$_}, id => "${id}_${_}", type => 'hidden') : '' } qw(type)) .
  65     $self->input_tag("", ref $value  ? $value->displayable_name : '', id => "${id}_name", %params);
  66
  67   $::request->layout->add_javascripts('autocomplete_customer.js');
  68   $::request->presenter->need_reinit_widgets($id);
  69
  70   $self->html_tag('span', $ret, class => 'customer_vendor_picker');
  71 }
  72
  73 1;
  74
  75 __END__
  76
  77 =pod
  78
  79 =encoding utf8
  80
  81 =head1 NAME
  82
  83 SL::Presenter::CustomerVendor - Presenter module for customer and
  84 vendor Rose::DB objects
  85
  86 =head1 SYNOPSIS
  87
  88   # Customers:
  89   my $customer = SL::DB::Manager::Customer->get_first;
  90   my $html     = SL::Presenter->get->customer($customer, display => 'inline');
  91
  92   # Vendors:
  93   my $vendor = SL::DB::Manager::Vendor->get_first;
  94   my $html   = SL::Presenter->get->vendor($customer, display => 'inline');
  95
  96 =head1 FUNCTIONS
  97
  98 =over 4
  99
 100 =item C<customer $object, %params>
 101
 102 Returns a rendered version (actually an instance of
 103 L<SL::Presenter::EscapedText>) of the customer object C<$object>.
 104
 105 C<%params> can include:
 106
 107 =over 2
 108
 109 =item * display
 110
 111 Either C<inline> (the default) or C<table-cell>. At the moment both
 112 representations are identical and produce the customer's name linked
 113 to the corresponding 'edit' action.
 114
 115 =item * no_link
 116
 117 If falsish (the default) then the customer's name will be linked to
 118 the "edit customer" dialog from the master data menu.
 119
 120 =back
 121
 122 =item C<vendor $object, %params>
 123
 124 Returns a rendered version (actually an instance of
 125 L<SL::Presenter::EscapedText>) of the vendor object C<$object>.
 126
 127 C<%params> can include:
 128
 129 =over 2
 130
 131 =item * display
 132
 133 Either C<inline> (the default) or C<table-cell>. At the moment both
 134 representations are identical and produce the vendor's name linked
 135 to the corresponding 'edit' action.
 136
 137 =item * no_link
 138
 139 If falsish (the default) then the vendor's name will be linked to
 140 the "edit vendor" dialog from the master data menu.
 141
 142 =back
 143
 144 =item C<customer_vendor $object, %params>
 145
 146 Returns a rendered version (actually an instance of
 147 L<SL::Presenter::EscapedText>) of the customer or vendor object
 148 C<$object> by calling either L</customer> or L</vendor> depending on
 149 C<$object>'s type. See the respective functions for available
 150 parameters.
 151
 152 =back
 153
 154 =head1 BUGS
 155
 156 Nothing here yet.
 157
 158 =head1 AUTHOR
 159
 160 Moritz Bunkus E<lt>m.bunkus@linet-services.deE<gt>
 161
 162 =cut