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   $html .= 'Customer #<B>'. $cust_main->display_custnum.
  99            ': '. encode_entities($cust_main->name). '</B></A>';
 100            ' - <B><FONT COLOR="#'. $cust_main->statuscolor. '">'.
 101            ucfirst($cust_main->status). '</FONT></B>';
 102
 103   $html .= ' (Balance: <B>$'. $cust_main->balance. '</B>)'
 104     unless $nobalance;
 105
 106   my @part_tag = $cust_main->part_tag;
 107   if ( @part_tag ) {
 108     $html .= '<TABLE>';
 109     foreach my $part_tag ( @part_tag ) {
 110       $html .= '<TR><TD>'.
 111                '<FONT '. ( length($part_tag->tagcolor)
 112                            ? 'STYLE="background-color:#'.$part_tag->tagcolor.'"'
 113                            : ''
 114                          ).
 115                '>'.
 116                  encode_entities($part_tag->tagname.': '. $part_tag->tagdesc).
 117                '</FONT>'.
 118                '</TD></TR>';
 119     }
 120     $html .= '</TABLE>';
 121   }
 122
 123   $html .=
 124     ntable('#e8e8e8'). '<TR><TD VALIGN="top">'. ntable("#cccccc",2).
 125     '<TR><TD ALIGN="right" VALIGN="top">Billing<BR>Address</TD><TD BGCOLOR="#ffffff">';
 126
 127   $html .= encode_entities($cust_main->address1). '<BR>';
 128   $html .= encode_entities($cust_main->address2). '<BR>'
 129     if $cust_main->address2;
 130   $html .= encode_entities($cust_main->city) . ', ' if $cust_main->city;
 131   $html .= encode_entities($cust_main->state). '  '.
 132            encode_entities($cust_main->zip). '<BR>';
 133   $html .= encode_entities($cust_main->country). '<BR>'
 134     if $cust_main->country && $cust_main->country ne $countrydefault;
 135
 136   $html .= '</TD></TR><TR><TD></TD><TD BGCOLOR="#ffffff">';
 137   if ( $cust_main->daytime && $cust_main->night ) {
 138     $html .= ( FS::Msgcat::_gettext('daytime') || 'Day' ).
 139              ' '. $cust_main->daytime.
 140              '<BR>'. ( FS::Msgcat::_gettext('night') || 'Night' ).
 141              ' '. $cust_main->night;
 142   } elsif ( $cust_main->daytime || $cust_main->night ) {
 143     $html .= $cust_main->daytime || $cust_main->night;
 144   }
 145   if ( $cust_main->fax ) {
 146     $html .= '<BR>Fax '. $cust_main->fax;
 147   }
 148
 149   $html .= '</TD></TR></TABLE></TD>';
 150
 151   my $ship = $cust_main->ship_location;
 152
 153   $html .= '<TD VALIGN="top">'. ntable("#cccccc",2).
 154     '<TR><TD ALIGN="right" VALIGN="top">Service<BR>Address</TD><TD BGCOLOR="#ffffff">';
 155   $html .= join('<BR>',
 156     map encode_entities($_), grep $_,
 157       $cust_main->ship_company,
 158       $ship->address1,
 159       $ship->address2,
 160       (($ship->city ? $ship->city . ', ' : '') . $ship->state . '  ' . $ship->zip),
 161       ($ship->country eq $countrydefault ? '' : $ship->country ),
 162   );
 163
 164   # ship phone numbers no longer exist...
 165
 166   $html .= '</TD></TR></TABLE></TD>';
 167
 168   $html .= '</TR>';
 169
 170   #would be better to use ncancelled_active_pkgs, but that doesn't have an
 171   # optimization to just count them yet, so it would be a perf problem on
 172   # tons-of-package customers
 173   if ( !$nopkg && scalar($cust_main->ncancelled_pkgs) < 20 ) {
 174
 175     foreach my $cust_pkg ( $cust_main->ncancelled_active_pkgs ) {
 176
 177       $html .= '<TR><TD COLSPAN="2">'.
 178                '<B><FONT COLOR="#'. $cust_pkg->statuscolor. '">'.
 179                ucfirst($cust_pkg->status). '</FONT></B> - '.
 180                encode_entities($cust_pkg->part_pkg->pkg_comment_only(nopkgpart=>1)).
 181                '</TD></TR>';
 182     }
 183
 184   }
 185
 186   $html .= '</TABLE>';
 187
 188   # last payment might be good here too?
 189
 190   $html .= '</DIV>';
 191
 192   $html;
 193 }
 194
 195 #bah.  don't want to pull in all of FS::CGI, that's the whole problem in the
 196 #first place
 197 sub ntable {
 198   my $col = shift;
 199   my $cellspacing = shift || 0;
 200   if ( $col ) {
 201     qq!<TABLE BGCOLOR="$col" BORDER=0 CELLSPACING=$cellspacing>!;
 202   } else {
 203     '<TABLE BORDER CELLSPACING=0 CELLPADDING=2 BORDERCOLOR="#999999">';
 204   }
 205
 206 }
 207
 208 =back
 209
 210 =head1 BUGS
 211
 212 Sheesh. I did switch to mason, but this is still hanging around.  Figure out
 213 some better way to sling mason components to self-service & RT.
 214
 215 (Or, is it useful to have this without depending on the regular back-office UI
 216 and Mason stuff to be in place?  So we have something suitable for displaying
 217 customer information in other external systems, not just RT?)
 218
 219 =head1 SEE ALSO
 220
 221 L<FS::UI::Web>
 222
 223 =cut
 224
 225 1;
 226