X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=FS%2FFS%2FUI%2FWeb%2Fsmall_custview.pm;h=e82e3326f3840432e197f059535f7c584bcc6529;hp=ae0a4211bda1b46b4686948590429e0e019fb701;hb=9aee669886202be7035e6c6049fc71bc99dd3013;hpb=3d0a1bb06b895c5be6e3f0517d355442a6b1e125 diff --git a/FS/FS/UI/Web/small_custview.pm b/FS/FS/UI/Web/small_custview.pm index ae0a4211b..e82e3326f 100644 --- a/FS/FS/UI/Web/small_custview.pm +++ b/FS/FS/UI/Web/small_custview.pm @@ -11,32 +11,101 @@ use FS::cust_main; @ISA = qw(Exporter); @EXPORT_OK = qw( small_custview ); +=head1 NAME + +FS::UI::Web::small_custview + +=head1 SYNOPSIS + + use FS::UI::Web::small_custview qw( small_custview ); + + #new-style + $html = small_custview( + { 'cust_main' => $cust_main, #or 'custnum' => $custnum, + 'countrydefault' => 'US', + 'nobalance' => 1, + 'url' => 'http://freeside.machine/freeside/view/cust_main.cgi', + 'nopkg' => 1, + } + ); + + #old-style (deprecated) + $html = small_custview( $cust_main, $countrydefault, $nobalance, $url ); + +=head1 DESCRIPTION + +A subroutine for displaying customer information. + +=head1 SUBROUTINES + +=over 4 + +=item small_custview HASHREF + +New-style interface. Keys are: + +=over 4 + +=item cust_main + +Customer (as a FS::cust_main object) + +=item custnum + +Customer number (if cust_main is not provided). + +=item countrydefault + +=item nobalance + +=item url + +=back + =item small_custview CUSTNUM || CUST_MAIN_OBJECT, COUNTRYDEFAULT, NOBALANCE_FLAG, URL -Sheesh. I did switch to mason, but this is still hanging around. Figure out -some better way to sling mason components to self-service & RT. +Old-style (deprecated) interface. =cut sub small_custview { - - my $arg = shift; - my $countrydefault = shift || 'US'; - my $nobalance = shift; - my $url = shift; - - my $cust_main = ref($arg) ? $arg - : qsearchs('cust_main', { 'custnum' => $arg } ) - or die "unknown custnum $arg"; + my( $cust_main, $countrydefault, $nobalance, $url, $nopkg ); + if ( ref($_[0]) eq 'HASH' ) { + my $opt = shift; + $cust_main = $opt->{cust_main} + || qsearchs('cust_main', { 'custnum' => $opt->{custnum} } ); + $countrydefault = $opt->{countrydefault} || 'US'; + $nobalance = $opt->{nobalance}; + $url = $opt->{url}; + $nopkg = $opt->{nopkg}; + } else { + my $arg = shift; + $countrydefault = shift || 'US'; + $nobalance = shift; + $url = shift; + $nopkg = 0; + + $cust_main = ref($arg) ? $arg + : qsearchs('cust_main', { 'custnum' => $arg } ) + or die "unknown custnum $arg"; + } my $html = '
'; - $html = qq!View ' + $html = qq!' if $url; - $html .= 'Customer #'. $cust_main->display_custnum. ''. - ' - '. - ucfirst($cust_main->status). ''; + if ( $FS::CurrentUser::CurrentUser->num_agents ) { + $html .= encode_entities($cust_main->agent->agent). ' '; + } + + $html .= 'Customer #'. $cust_main->display_custnum. + ': '. encode_entities($cust_main->name). ''. + ' - '. + $cust_main->status_label. ''; + + $html .= ' (Balance: $'. $cust_main->balance. ')' + unless $nobalance; my @part_tag = $cust_main->part_tag; if ( @part_tag ) { @@ -57,16 +126,20 @@ sub small_custview { $html .= ntable('#e8e8e8'). ''. ntable("#cccccc",2). - 'Billing
Address'. - encode_entities($cust_main->getfield('last')). ', '. - encode_entities($cust_main->first). '
'; + 'Billing
Address'; + + if ( $cust_main->bill_locationnum ) { - $html .= encode_entities($cust_main->company). '
' if $cust_main->company; - $html .= encode_entities($cust_main->address1). '
'; - $html .= encode_entities($cust_main->address2). '
' if $cust_main->address2; - $html .= encode_entities($cust_main->city). ', '. $cust_main->state. ' '. $cust_main->zip. '
'; - $html .= $cust_main->country. '
' - if $cust_main->country && $cust_main->country ne $countrydefault; + $html .= encode_entities($cust_main->address1). '
'; + $html .= encode_entities($cust_main->address2). '
' + if $cust_main->address2; + $html .= encode_entities($cust_main->city) . ', ' if $cust_main->city; + $html .= encode_entities($cust_main->state). ' '. + encode_entities($cust_main->zip). '
'; + $html .= encode_entities($cust_main->country). '
' + if $cust_main->country && $cust_main->country ne $countrydefault; + + } $html .= ''; if ( $cust_main->daytime && $cust_main->night ) { @@ -83,28 +156,46 @@ sub small_custview { $html .= ''; - my $ship = $cust_main->ship_location; - - $html .= ''. ntable("#cccccc",2). - 'Service
Address'; - $html .= join('
', - map encode_entities($_), grep $_, - $cust_main->contact, - $cust_main->company, - $ship->address1, - $ship->address2, - ($ship->city . ', ' . $ship->state . ' ' . $ship->zip), - ($ship->country eq $countrydefault ? '' : $ship->country ), - ); + if ( $cust_main->ship_locationnum ) { - # ship phone numbers no longer exist... + my $ship = $cust_main->ship_location; - $html .= ''; + $html .= ''. ntable("#cccccc",2). + 'Service
Address'; + $html .= join('
', + map encode_entities($_), grep $_, + $cust_main->ship_company, + $ship->address1, + $ship->address2, + (($ship->city ? $ship->city . ', ' : '') . $ship->state . ' ' . $ship->zip), + ($ship->country eq $countrydefault ? '' : $ship->country ), + ); - $html .= ''; + # ship phone numbers no longer exist... - $html .= '
Balance: $'. $cust_main->balance. '
' - unless $nobalance; + $html .= ''; + + } + + $html .= ''; + + #would be better to use ncancelled_active_pkgs, but that doesn't have an + # optimization to just count them yet, so it would be a perf problem on + # tons-of-package customers + if ( !$nopkg && scalar($cust_main->ncancelled_pkgs) < 20 ) { + + foreach my $cust_pkg ( $cust_main->ncancelled_active_pkgs ) { + + $html .= ''. + ''. + ucfirst($cust_pkg->status). ' - '. + encode_entities($cust_pkg->part_pkg->pkg_comment_only(nopkgpart=>1)). + ''; + } + + } + + $html .= ''; # last payment might be good here too? @@ -126,5 +217,22 @@ sub ntable { } +=back + +=head1 BUGS + +Sheesh. I did switch to mason, but this is still hanging around. Figure out +some better way to sling mason components to self-service & RT. + +(Or, is it useful to have this without depending on the regular back-office UI +and Mason stuff to be in place? So we have something suitable for displaying +customer information in other external systems, not just RT?) + +=head1 SEE ALSO + +L + +=cut + 1;