code2country($self->country);
}
-=item line
+=item location_label [ OPTION => VALUE ... ]
-Returns this location on one line
+Returns the label of the service location for this customer.
-=cut
+Options are
-sub line {
- my $self = shift;
- my $cydefault = FS::conf->new->config('countrydefault') || 'US';
+=over 4
- my $line = $self->address1;
- $line .= ', '. $self->address2 if $self->address2;
- $line .= ', '. $self->city;
- $line .= ' ('. $self->county. ' county)' if $self->county;
- $line .= ', '. $self->state if $self->state;
- $line .= ' '. $self->zip if $self->zip;
- $line .= ' '. code2country($self->country) if $self->country ne $cydefault;
+=item join_string
- $line;
-}
+used to separate the address elements (defaults to ', ')
+
+=item escape_function
-=item line_short
-Returns this location on one line in a shortened form
+a callback used for escaping the text of the address elements
+
+=back
=cut
-# configurable?
+# false laziness with FS::cust_main::location_label
-sub line_short {
+sub location_label {
my $self = shift;
- my $cydefault = FS::conf->new->config('countrydefault') || 'US';
+ my %opt = @_;
- my $line = $self->address1;
- #$line .= ', '. $self->address2 if $self->address2;
- $line .= ', '. $self->city;
- $line .= ', '. $self->state if $self->state;
- $line .= ' '. $self->zip if $self->zip;
- $line .= ' '. code2country($self->country) if $self->country ne $cydefault;
+ my $separator = $opt{join_string} || ', ';
+ my $escape = $opt{escape_function} || sub{ shift };
+ my $line = '';
+ my $cydefault = FS::conf->new->config('countrydefault') || 'US';
+ my $prefix = '';
+
+ my $notfirst = 0;
+ foreach (qw ( address1 address2 ) ) {
+ my $method = "$prefix$_";
+ $line .= ($notfirst ? $separator : ''). &$escape($self->$method)
+ if $self->$method;
+ $notfirst++;
+ }
+ $notfirst = 0;
+ foreach (qw ( city county state zip ) ) {
+ my $method = "$prefix$_";
+ if ( $self->$method ) {
+ $line .= ' (' if $method eq 'county';
+ $line .= ($notfirst ? ' ' : $separator). &$escape($self->$method);
+ $line .= ' )' if $method eq 'county';
+ $notfirst++;
+ }
+ }
+ $line .= $separator. &$escape(code2country($self->country))
+ if $self->country ne $cydefault;
$line;
}
-=item location_label_short
+=item line
-Synonym for line_short
+Synonym for location_label
=cut
-sub location_label_short {
+sub line {
my $self = shift;
- $self->line_short;
+ $self->location_label;
}
=back