FS/FS/UI/Web/small_custview.pm

   1 package FS::UI::Web::small_custview;
   2
   3 use strict;
   4 use vars qw(@EXPORT_OK @ISA);
   5 use Exporter;
   6 use HTML::Entities;
   7 use FS::Msgcat;
   8 use FS::Record qw(qsearchs);
   9 use FS::cust_main;
  10
  11 @ISA = qw(Exporter);
  12 @EXPORT_OK = qw( small_custview );
  13
  14 =head1 NAME
  15
  16 FS::UI::Web::small_custview
  17
  18 =head1 SYNOPSIS
  19
  20   use FS::UI::Web::small_custview qw( small_custview );
  21
  22   #new-style
  23   $html = small_custview(
  24     { 'cust_main'      => $cust_main, #or 'custnum' => $custnum,
  25       'countrydefault' => 'US',
  26       'nobalance'      => 1,
  27       'url'            => 'http://freeside.machine/freeside/view/cust_main.cgi',
  28       'nopkg'          => 1,
  29     }
  30   );
  31
  32   #old-style (deprecated)
  33   $html = small_custview( $cust_main, $countrydefault, $nobalance, $url );
  34
  35 =head1 DESCRIPTION
  36
  37 A subroutine for displaying customer information.
  38
  39 =head1 SUBROUTINES
  40
  41 =over 4
  42
  43 =item small_custview HASHREF
  44
  45 New-style interface.  Keys are:
  46
  47 =over 4
  48
  49 =item cust_main
  50
  51 Customer (as a FS::cust_main object)
  52
  53 =item custnum
  54
  55 Customer number (if cust_main is not provided).
  56
  57 =item countrydefault
  58
  59 =item nobalance
  60
  61 =item url
  62
  63 =back
  64
  65 =item small_custview CUSTNUM || CUST_MAIN_OBJECT, COUNTRYDEFAULT, NOBALANCE_FLAG, URL
  66
  67 Old-style (deprecated) interface.
  68
  69 =cut
  70
  71 sub small_custview {
  72   my( $cust_main, $countrydefault, $nobalance, $url, $nopkg );
  73   if ( ref($_[0]) eq 'HASH' ) {
  74     my $opt = shift;
  75     $cust_main =  $opt->{cust_main}
  76                || qsearchs('cust_main', { 'custnum' => $opt->{custnum} } );
  77     $countrydefault = $opt->{countrydefault} || 'US';
  78     $nobalance = $opt->{nobalance};
  79     $url = $opt->{url};
  80     $nopkg = $opt->{nopkg};
  81   } else {
  82     my $arg = shift;
  83     $countrydefault = shift || 'US';
  84     $nobalance = shift;
  85     $url = shift;
  86     $nopkg = 0;
  87
  88     $cust_main = ref($arg) ? $arg
  89                            : qsearchs('cust_main', { 'custnum' => $arg } )
  90       or die "unknown custnum $arg";
  91   }
  92
  93   my $html = '<DIV ID="fs_small_custview" CLASS="small_custview">';
  94
  95   $html = qq!<A HREF="$url?! . $cust_main->custnum . '">'
  96     if $url;
  97
  98   if ( $FS::CurrentUser::CurrentUser->num_agents ) {
  99     $html .= encode_entities($cust_main->agent->agent). ' ';
 100   }
 101
 102   $html .= 'Customer #<B>'. $cust_main->display_custnum.
 103            '</B>: <B>'. encode_entities($cust_main->name). '</B></A>'.
 104            ' - <B><FONT COLOR="#'. $cust_main->statuscolor. '">'.
 105            $cust_main->status_label. '</FONT></B>';
 106
 107   $html .= ' (Balance: <B>$'. $cust_main->balance. '</B>)'
 108     unless $nobalance;
 109
 110   my @part_tag = $cust_main->part_tag;
 111   if ( @part_tag ) {
 112     $html .= '<TABLE>';
 113     foreach my $part_tag ( @part_tag ) {
 114       $html .= '<TR><TD>'.
 115                '<FONT '. ( length($part_tag->tagcolor)
 116                            ? 'STYLE="background-color:#'.$part_tag->tagcolor.'"'
 117                            : ''
 118                          ).
 119                '>'.
 120                  encode_entities($part_tag->tagname.': '. $part_tag->tagdesc).
 121                '</FONT>'.
 122                '</TD></TR>';
 123     }
 124     $html .= '</TABLE>';
 125   }
 126
 127   $html .=
 128     ntable('#e8e8e8'). '<TR><TD VALIGN="top">'. ntable("#cccccc",2).
 129     '<TR><TD ALIGN="right" VALIGN="top">Billing<BR>Address</TD><TD BGCOLOR="#ffffff">';
 130
 131   if ( $cust_main->bill_locationnum ) {
 132
 133     $html .= encode_entities($cust_main->address1). '<BR>';
 134     $html .= encode_entities($cust_main->address2). '<BR>'
 135       if $cust_main->address2;
 136     $html .= encode_entities($cust_main->city) . ', ' if $cust_main->city;
 137     $html .= encode_entities($cust_main->state). '  '.
 138              encode_entities($cust_main->zip). '<BR>';
 139     $html .= encode_entities($cust_main->country). '<BR>'
 140       if $cust_main->country && $cust_main->country ne $countrydefault;
 141
 142   }
 143
 144   $html .= '</TD></TR><TR><TD></TD><TD BGCOLOR="#ffffff">';
 145   if ( $cust_main->daytime && $cust_main->night ) {
 146     $html .= ( FS::Msgcat::_gettext('daytime') || 'Day' ).
 147              ' '. $cust_main->daytime.
 148              '<BR>'. ( FS::Msgcat::_gettext('night') || 'Night' ).
 149              ' '. $cust_main->night;
 150   } elsif ( $cust_main->daytime || $cust_main->night ) {
 151     $html .= $cust_main->daytime || $cust_main->night;
 152   }
 153   if ( $cust_main->fax ) {
 154     $html .= '<BR>Fax '. $cust_main->fax;
 155   }
 156
 157   $html .= '</TD></TR></TABLE></TD>';
 158
 159   if ( $cust_main->ship_locationnum ) {
 160
 161     my $ship = $cust_main->ship_location;
 162
 163     $html .= '<TD VALIGN="top">'. ntable("#cccccc",2).
 164       '<TR><TD ALIGN="right" VALIGN="top">Service<BR>Address</TD><TD BGCOLOR="#ffffff">';
 165     $html .= join('<BR>',
 166       map encode_entities($_), grep $_,
 167         $cust_main->ship_company,
 168         $ship->address1,
 169         $ship->address2,
 170         (($ship->city ? $ship->city . ', ' : '') . $ship->state . '  ' . $ship->zip),
 171         ($ship->country eq $countrydefault ? '' : $ship->country ),
 172     );
 173
 174     # ship phone numbers no longer exist...
 175
 176     $html .= '</TD></TR></TABLE></TD>';
 177
 178   }
 179
 180   $html .= '</TR>';
 181
 182   #would be better to use ncancelled_active_pkgs, but that doesn't have an
 183   # optimization to just count them yet, so it would be a perf problem on
 184   # tons-of-package customers
 185   if ( !$nopkg && scalar($cust_main->ncancelled_pkgs) < 20 ) {
 186
 187     foreach my $cust_pkg ( $cust_main->ncancelled_active_pkgs ) {
 188
 189       $html .= '<TR><TD COLSPAN="2">'.
 190                '<B><FONT COLOR="#'. $cust_pkg->statuscolor. '">'.
 191                ucfirst($cust_pkg->status). '</FONT></B> - '.
 192                encode_entities($cust_pkg->part_pkg->pkg_comment_only(nopkgpart=>1)).
 193                '</TD></TR>';
 194     }
 195
 196   }
 197
 198   $html .= '</TABLE>';
 199
 200   # last payment might be good here too?
 201
 202   $html .= '</DIV>';
 203
 204   $html;
 205 }
 206
 207 #bah.  don't want to pull in all of FS::CGI, that's the whole problem in the
 208 #first place
 209 sub ntable {
 210   my $col = shift;
 211   my $cellspacing = shift || 0;
 212   if ( $col ) {
 213     qq!<TABLE BGCOLOR="$col" BORDER=0 CELLSPACING=$cellspacing>!;
 214   } else {
 215     '<TABLE BORDER CELLSPACING=0 CELLPADDING=2 BORDERCOLOR="#999999">';
 216   }
 217
 218 }
 219
 220 =back
 221
 222 =head1 BUGS
 223
 224 Sheesh. I did switch to mason, but this is still hanging around.  Figure out
 225 some better way to sling mason components to self-service & RT.
 226
 227 (Or, is it useful to have this without depending on the regular back-office UI
 228 and Mason stuff to be in place?  So we have something suitable for displaying
 229 customer information in other external systems, not just RT?)
 230
 231 =head1 SEE ALSO
 232
 233 L<FS::UI::Web>
 234
 235 =cut
 236
 237 1;
 238