=pod =head1 NAME LedgerSMB::Scripts::customer - LedgerSMB class defining the Controller functions, template instantiation and rendering for customer editing and display. =head1 SYOPSIS This module is the UI controller for the customer DB access; it provides the View interface, as well as defines the Save customer. Save customer will update or create as needed. =head1 METHODS =cut package LedgerSMB::Scripts::Customer; use LedgerSMB::Template; use LedgerSMB::DBObject::Customer; =pod =over =item get($self, $request, $user) Requires form var: id Extracts a single customer from the database, using its company ID as the primary point of uniqueness. Shows (appropriate to user privileges) and allows editing of the customer informations. =back =cut sub get { my ($class, $request) = @_; my $customer = LedgerSMB::DBObject::Customer->new(base => $request, copy => 'all'); my $result = $customer->get($customer->{id}); my $template = LedgerSMB::Template->new( user => $user, template => 'customer.html', language => $user->{language}, format => 'html'); $template->render($results); } =pod =over =item search($self, $request, $user) Requires form var: search_pattern Directly calls the database function search, and returns a set of all customers found that match the search parameters. Search parameters search over address as well as customer/Company name. =back =cut sub search { my ($class, $request) = @_; my $customer = LedgerSMB::DBObject::Customer->new(base => $request, copy => 'all'); my $results = $customer->search($customer->{search_pattern}); my $template = LedgerSMB::Template->new( user => $user, template => 'customer_search.html', language => $user->{language}, format => 'html'); $template->render($results); } =pod =over =item save($self, $request, $user) Saves a customer to the database. The function will update or insert a new customer as needed, and will generate a new Company ID for the customer if needed. =back =cut sub save { my ($class, $request) = @_; my $customer = LedgerSMB::DBObject::Customer->new(base => $request, copy => 'all'); my $result = $customer->save_to_db(); my $template = LedgerSMB::Template->new( user => $user, template => 'customer.html', language => $user->{language}, format => 'html'); $template->render($result); } 1;