FS/FS/svc_acct_pop.pm

   1 package FS::svc_acct_pop;
   2
   3 use strict;
   4 use vars qw( @ISA @EXPORT_OK @svc_acct_pop %svc_acct_pop );
   5 use FS::Record qw( qsearch qsearchs );
   6
   7 @ISA = qw( FS::Record Exporter );
   8 @EXPORT_OK = qw( popselector );
   9
  10 =head1 NAME
  11
  12 FS::svc_acct_pop - Object methods for svc_acct_pop records
  13
  14 =head1 SYNOPSIS
  15
  16   use FS::svc_acct_pop;
  17
  18   $record = new FS::svc_acct_pop \%hash;
  19   $record = new FS::svc_acct_pop { 'column' => 'value' };
  20
  21   $error = $record->insert;
  22
  23   $error = $new_record->replace($old_record);
  24
  25   $error = $record->delete;
  26
  27   $error = $record->check;
  28
  29   $html = FS::svc_acct_pop::popselector( $popnum, $state );
  30
  31 =head1 DESCRIPTION
  32
  33 An FS::svc_acct object represents an point of presence.  FS::svc_acct_pop
  34 inherits from FS::Record.  The following fields are currently supported:
  35
  36 =over 4
  37
  38 =item popnum - primary key (assigned automatically for new accounts)
  39
  40 =item city
  41
  42 =item state
  43
  44 =item ac - area code
  45
  46 =item exch - exchange
  47
  48 =item loc - rest of number
  49
  50 =back
  51
  52 =head1 METHODS
  53
  54 =over 4
  55
  56 =item new HASHREF
  57
  58 Creates a new point of presence (if only it were that easy!).  To add the
  59 point of presence to the database, see L<"insert">.
  60
  61 =cut
  62
  63 sub table { 'svc_acct_pop'; }
  64
  65 =item insert
  66
  67 Adds this point of presence to the database.  If there is an error, returns the
  68 error, otherwise returns false.
  69
  70 =item delete
  71
  72 Removes this point of presence from the database.
  73
  74 =item replace OLD_RECORD
  75
  76 Replaces OLD_RECORD with this one in the database.  If there is an error,
  77 returns the error, otherwise returns false.
  78
  79 =item check
  80
  81 Checks all fields to make sure this is a valid point of presence.  If there is
  82 an error, returns the error, otherwise returns false.  Called by the insert
  83 and replace methods.
  84
  85 =cut
  86
  87 sub check {
  88   my $self = shift;
  89
  90     $self->ut_numbern('popnum')
  91       or $self->ut_text('city')
  92       or $self->ut_text('state')
  93       or $self->ut_number('ac')
  94       or $self->ut_number('exch')
  95       or $self->ut_numbern('loc')
  96   ;
  97
  98 }
  99
 100 =item text
 101
 102 Returns:
 103
 104 "$city, $state ($ac)/$exch"
 105
 106 =cut
 107
 108 sub text {
 109   my $self = shift;
 110   $self->city. ', '. $self->state.
 111     ' ('. $self->ac. ')/'. $self->exch. '-'. $self->loc;
 112 }
 113
 114 =back
 115
 116 =head1 SUBROUTINES
 117
 118 =over 4
 119
 120 =item popselector [ POPNUM [ STATE ] ]
 121
 122 =cut
 123
 124 #horrible false laziness with signup.cgi (pull special-case for 0 & 1
 125 # pop code out from signup.cgi??)
 126 sub popselector {
 127   my( $popnum, $state ) = @_;
 128
 129   unless ( @svc_acct_pop ) { #cache pop list
 130     @svc_acct_pop = qsearch('svc_acct_pop', {} );
 131     %svc_acct_pop = ();
 132     push @{$svc_acct_pop{$_->state}}, $_ foreach @svc_acct_pop;
 133   }
 134
 135   my $text = <<END;
 136     <SCRIPT>
 137     function opt(what,href,text) {
 138       var optionName = new Option(text, href, false, false)
 139       var length = what.length;
 140       what.options[length] = optionName;
 141     }
 142
 143     function popstate_changed(what) {
 144       state = what.options[what.selectedIndex].text;
 145       what.form.popnum.options.length = 0
 146       what.form.popnum.options[0] = new Option("", "", false, true);
 147 END
 148
 149   foreach my $popstate ( sort { $a cmp $b } keys %svc_acct_pop ) {
 150     $text .= "\nif ( state == \"$popstate\" ) {\n";
 151
 152     foreach my $pop ( @{$svc_acct_pop{$popstate}}) {
 153       my $o_popnum = $pop->popnum;
 154       my $poptext = $pop->text;
 155       $text .= "opt(what.form.popnum, \"$o_popnum\", \"$poptext\");\n"
 156     }
 157     $text .= "}\n";
 158   }
 159
 160   $text .= "}\n</SCRIPT>\n";
 161
 162   $text .=
 163     qq!<SELECT NAME="popstate" SIZE=1 onChange="popstate_changed(this)">!.
 164     qq!<OPTION> !;
 165   $text .= "<OPTION>$_" foreach sort { $a cmp $b } keys %svc_acct_pop;
 166   $text .= '</SELECT>'; #callback? return 3 html pieces?  #'</TD><TD>';
 167
 168   $text .= qq!<SELECT NAME="popnum" SIZE=1><OPTION> !;
 169   my @initial_select;
 170   if ( scalar(@svc_acct_pop) > 100 ) {
 171     @initial_select = qsearchs( 'svc_acct_pop', { 'popnum' => $popnum } );
 172   } else {
 173     @initial_select = @svc_acct_pop;
 174   }
 175   foreach my $pop ( @initial_select ) {
 176     $text .= qq!<OPTION VALUE="!. $pop->popnum. '"'.
 177              ( ( $popnum && $pop->popnum == $popnum ) ? ' SELECTED' : '' ). ">".
 178              $pop->text;
 179   }
 180   $text .= '</SELECT>';
 181
 182   $text;
 183
 184 }
 185
 186 =back
 187
 188 =head1 VERSION
 189
 190 $Id: svc_acct_pop.pm,v 1.9 2003-07-04 01:37:46 ivan Exp $
 191
 192 =head1 BUGS
 193
 194 It should be renamed to part_pop.
 195
 196 popselector?  putting web ui components in here?  they should probably live
 197 somewhere else...
 198
 199 popselector: pull special-case for 0 & 1 pop code out from signup.cgi
 200
 201 =head1 SEE ALSO
 202
 203 L<FS::Record>, L<FS::svc_acct>, L<FS::part_pop_local>, schema.html from the
 204 base documentation.
 205
 206 =cut
 207
 208 1;
 209