FS/FS/Mason.pm

   1 package FS::Mason;
   2
   3 use strict;
   4 use vars qw( @ISA @EXPORT_OK $addl_handler_use );
   5 use Exporter;
   6 use File::Slurp qw( slurp );
   7 use HTML::Mason 1.27; #http://www.masonhq.com/?ApacheModPerl2Redirect
   8 use HTML::Mason::Interp;
   9 use HTML::Mason::Compiler::ToObject;
  10
  11 @ISA = qw( Exporter );
  12 @EXPORT_OK = qw( mason_interps );
  13
  14 =head1 NAME
  15
  16 FS::Mason - Initialize the Mason environment
  17
  18 =head1 SYNOPSIS
  19
  20   use FS::Mason qw( mason_interps );
  21
  22   my( $fs_interp, $rt_interp ) = mason_interps('apache');
  23
  24   #OR
  25
  26   my( $fs_interp, $rt_interp ) = mason_interps('standalone'); #XXX name?
  27
  28 =head1 DESCRIPTION
  29
  30 Initializes the Mason environment, loads all Freeside and RT libraries, etc.
  31
  32 =cut
  33
  34 $addl_handler_use = '';
  35 my $addl_handler_use_file = '%%%FREESIDE_CONF%%%/addl_handler_use.pl';
  36 if ( -e $addl_handler_use_file ) {
  37   $addl_handler_use = slurp( $addl_handler_use_file );
  38 }
  39
  40 # List of modules that you want to use from components (see Admin
  41 # manual for details)
  42 {
  43   package HTML::Mason::Commands;
  44
  45   use strict;
  46   use vars qw( %session );
  47   use CGI 3.29 qw(-private_tempfiles); #3.29 to fix RT attachment problems
  48
  49   #breaks quick payment entry
  50   #http://rt.cpan.org/Public/Bug/Display.html?id=37365
  51   die "CGI.pm v3.38 is broken, use any other version >= 3.29".
  52       " (Debian 5.0?  aptitude remove libcgi-pm-perl)"
  53     if $CGI::VERSION == 3.38;
  54
  55   #use CGI::Carp qw(fatalsToBrowser);
  56   use CGI::Cookie;
  57   use List::Util qw( max min );
  58   use Data::Dumper;
  59   use Date::Format;
  60   use Time::Local;
  61   use Time::HiRes;
  62   use Time::Duration;
  63   use DateTime;
  64   use DateTime::Format::Strptime;
  65   use FS::Misc::DateTime qw( parse_datetime );
  66   use Lingua::EN::Inflect qw(PL);
  67   Lingua::EN::Inflect::classical names=>0; #Categorys
  68   use Tie::IxHash;
  69   use URI;
  70   use URI::Escape;
  71   use HTML::Entities;
  72   use HTML::TreeBuilder;
  73   use HTML::FormatText;
  74   use JSON;
  75   use MIME::Base64;
  76   use IO::Handle;
  77   use IO::File;
  78   use IO::Scalar;
  79   #not actually using this yet anyway...# use IPC::Run3 0.036;
  80   use Net::Whois::Raw qw(whois);
  81   if ( $] < 5.006 ) {
  82     eval "use Net::Whois::Raw 0.32 qw(whois)";
  83     die $@ if $@;
  84   }
  85   use Text::CSV_XS;
  86   use Spreadsheet::WriteExcel;
  87   use Business::CreditCard 0.30; #for mask-aware cardtype()
  88   use NetAddr::IP;
  89   use Net::Ping;
  90   use Net::Ping::External;
  91   #if CPAN #7815 ever gets fixed# if ( $Net::Ping::External::VERSION <= 0.12 )
  92   {
  93     no warnings 'redefine';
  94     eval 'sub Net::Ping::External::_ping_linux {
  95             my %args = @_;
  96             my $command = "ping -s $args{size} -c $args{count} -w $args{timeout} $args{host}";
  97             return Net::Ping::External::_ping_system($command, 0);
  98           }
  99          ';
 100     die $@ if $@;
 101   }
 102   use String::Approx qw(amatch);
 103   use Chart::LinesPoints;
 104   use Chart::Mountain;
 105   use Color::Scheme;
 106   use HTML::Widgets::SelectLayers 0.07; #should go away in favor of
 107                                         #selectlayers.html
 108   use Locale::Country;
 109   use Business::US::USPS::WebTools::AddressStandardization;
 110   use LWP::UserAgent;
 111   use FS;
 112   use FS::UID qw( getotaker dbh datasrc driver_name );
 113   use FS::Record qw( qsearch qsearchs fields dbdef
 114                     str2time_sql str2time_sql_closing
 115                    );
 116   use FS::Conf;
 117   use FS::CGI qw(header menubar table itable ntable idiot
 118                  eidiot myexit http_header);
 119   use FS::UI::Web qw(svc_url);
 120   use FS::UI::Web::small_custview qw(small_custview);
 121   use FS::UI::bytecount;
 122   use FS::Msgcat qw(gettext geterror);
 123   use FS::Misc qw( send_email send_fax states_hash counties state_label );
 124   use FS::Misc::eps2png qw( eps2png );
 125   use FS::Report::FCC_477;
 126   use FS::Report::Table::Monthly;
 127   use FS::TicketSystem;
 128   use FS::Tron qw( tron_lint );
 129
 130   use FS::agent;
 131   use FS::agent_type;
 132   use FS::domain_record;
 133   use FS::cust_bill;
 134   use FS::cust_bill_pay;
 135   use FS::cust_credit;
 136   use FS::cust_credit_bill;
 137   use FS::cust_main qw(smart_search);
 138   use FS::cust_main::Import;
 139   use FS::cust_main_county;
 140   use FS::cust_location;
 141   use FS::cust_pay;
 142   use FS::cust_pkg;
 143   use FS::part_pkg_taxclass;
 144   use FS::cust_pkg_reason;
 145   use FS::cust_refund;
 146   use FS::cust_credit_refund;
 147   use FS::cust_pay_refund;
 148   use FS::cust_svc;
 149   use FS::nas;
 150   use FS::part_bill_event;
 151   use FS::part_event;
 152   use FS::part_event_condition;
 153   use FS::part_pkg;
 154   use FS::part_referral;
 155   use FS::part_svc;
 156   use FS::part_svc_router;
 157   use FS::part_virtual_field;
 158   use FS::pay_batch;
 159   use FS::pkg_svc;
 160   use FS::port;
 161   use FS::queue qw(joblisting);
 162   use FS::raddb;
 163   use FS::session;
 164   use FS::svc_acct;
 165   use FS::svc_acct_pop qw(popselector);
 166   use FS::acct_rt_transaction;
 167   use FS::svc_domain;
 168   use FS::svc_forward;
 169   use FS::svc_www;
 170   use FS::router;
 171   use FS::addr_block;
 172   use FS::svc_broadband;
 173   use FS::svc_external;
 174   use FS::type_pkgs;
 175   use FS::part_export;
 176   use FS::part_export_option;
 177   use FS::export_svc;
 178   use FS::export_device;
 179   use FS::msgcat;
 180   use FS::rate;
 181   use FS::rate_region;
 182   use FS::rate_prefix;
 183   use FS::rate_detail;
 184   use FS::usage_class;
 185   use FS::payment_gateway;
 186   use FS::agent_payment_gateway;
 187   use FS::XMLRPC;
 188   use FS::payby;
 189   use FS::cdr;
 190   use FS::cdr_batch;
 191   use FS::inventory_class;
 192   use FS::inventory_item;
 193   use FS::pkg_category;
 194   use FS::pkg_class;
 195   use FS::access_user;
 196   use FS::access_user_pref;
 197   use FS::access_group;
 198   use FS::access_usergroup;
 199   use FS::access_groupagent;
 200   use FS::access_right;
 201   use FS::AccessRight;
 202   use FS::svc_phone;
 203   use FS::phone_device;
 204   use FS::part_device;
 205   use FS::reason_type;
 206   use FS::reason;
 207   use FS::cust_main_note;
 208   use FS::tax_class;
 209   use FS::cust_tax_location;
 210   use FS::part_pkg_taxproduct;
 211   use FS::part_pkg_taxoverride;
 212   use FS::part_pkg_taxrate;
 213   use FS::tax_rate;
 214   use FS::part_pkg_report_option;
 215   use FS::cust_attachment;
 216   use FS::h_cust_pkg;
 217   use FS::h_svc_acct;
 218   use FS::h_svc_broadband;
 219   use FS::h_svc_domain;
 220   #use FS::h_domain_record;
 221   use FS::h_svc_external;
 222   use FS::h_svc_forward;
 223   use FS::h_svc_phone;
 224   #use FS::h_phone_device;
 225   use FS::h_svc_www;
 226   use FS::cust_statement;
 227   use FS::svc_pbx;
 228   use FS::svc_mailinglist;
 229   use FS::cgp_rule;
 230   use FS::cgp_rule_condition;
 231   use FS::cgp_rule_action;
 232   use FS::msg_template;
 233   use FS::part_tag;
 234   use FS::acct_snarf;
 235   # Sammath Naur
 236
 237   if ( $FS::Mason::addl_handler_use ) {
 238     eval $FS::Mason::addl_handler_use;
 239     die $@ if $@;
 240   }
 241
 242   if ( %%%RT_ENABLED%%% ) {
 243     eval '
 244       use lib ( "/opt/rt3/local/lib", "/opt/rt3/lib" );
 245       use vars qw($Nobody $SystemUser);
 246       use RT;
 247       use RT::Tickets;
 248       use RT::Transactions;
 249       use RT::Users;
 250       use RT::CurrentUser;
 251       use RT::Templates;
 252       use RT::Queues;
 253       use RT::ScripActions;
 254       use RT::ScripConditions;
 255       use RT::Scrips;
 256       use RT::Groups;
 257       use RT::GroupMembers;
 258       use RT::CustomFields;
 259       use RT::CustomFieldValues;
 260       use RT::ObjectCustomFieldValues;
 261
 262       #blah.  manually updated from RT::Interface::Web::Handler
 263       use RT::Interface::Web;
 264       use MIME::Entity;
 265       use Text::Wrapper;
 266       use Time::ParseDate;
 267       use Time::HiRes;
 268       use HTML::Scrubber;
 269
 270       #blah.  not even in RT::Interface::Web::Handler, just in
 271       #html/NoAuth/css/dhandler and rt-test-dependencies.  ask for it here
 272       #to throw a real error instead of just a mysterious unstyled RT
 273       use CSS::Squish 0.06;
 274
 275       #slow, unreliable, segfaults and is optional
 276       #see rt/html/Ticket/Elements/ShowTransactionAttachments
 277       use Text::Quoted;
 278
 279       #?#use File::Path qw( rmtree );
 280       #?#use File::Glob qw( bsd_glob );
 281       #?#use File::Spec::Unix;
 282
 283     ';
 284     die $@ if $@;
 285   }
 286
 287   *CGI::redirect = sub {
 288     my $self = shift;
 289     my $cookie = '';
 290     if ( $_[0] eq '-cookie' ) { #this isn't actually used at the moment
 291       (my $x, $cookie) = (shift, shift);
 292       $HTML::Mason::r->err_headers_out->add( 'Set-cookie' => $cookie );
 293     }
 294     my $location = shift;
 295
 296     use vars qw($m);
 297
 298     # false laziness w/below
 299     if ( defined(@DBIx::Profile::ISA) ) {
 300
 301       if ( $FS::CurrentUser::CurrentUser->option('show_db_profile') ) {
 302
 303         #profiling redirect
 304
 305         my $page =
 306           qq!<HTML><BODY>Redirect to <A HREF="$location">$location</A>!.
 307           '<BR><BR><PRE>'.
 308             ( UNIVERSAL::can(dbh, 'sprintProfile')
 309                 ? encode_entities(dbh->sprintProfile())
 310                 : 'DBIx::Profile missing sprintProfile method;'.
 311                   'unpatched or too old?'                        ).
 312           #"\n\n". &sprintAutoProfile().  '</PRE>'.
 313           "\n\n".                         '</PRE>'.
 314           '</BODY></HTML>';
 315
 316
 317         dbh->{'private_profile'} = {};
 318         return $page;
 319
 320       } else {
 321
 322         #clear db profile, but normal redirect
 323         dbh->{'private_profile'} = {};
 324         $m->redirect($location);
 325         '';
 326
 327       }
 328
 329     } else { #normal redirect
 330
 331       $m->redirect($location);
 332       '';
 333
 334     }
 335
 336   };
 337
 338   sub include {
 339     use vars qw($m);
 340     $m->scomp(@_);
 341   }
 342
 343   sub errorpage {
 344     use vars qw($m);
 345     $m->comp('/elements/errorpage.html', @_);
 346   }
 347
 348   sub redirect {
 349     my( $location ) = @_;
 350     use vars qw($m);
 351     $m->clear_buffer;
 352     #false laziness w/above
 353     if ( defined(@DBIx::Profile::ISA) ) {
 354
 355       if ( $FS::CurrentUser::CurrentUser->option('show_db_profile') ) {
 356
 357         #profiling redirect
 358
 359         $m->print(
 360           qq!<HTML><BODY>Redirect to <A HREF="$location">$location</A>!.
 361           '<BR><BR><PRE>'.
 362             ( UNIVERSAL::can(dbh, 'sprintProfile')
 363                 ? encode_entities(dbh->sprintProfile())
 364                 : 'DBIx::Profile missing sprintProfile method;'.
 365                   'unpatched or too old?'                        ).
 366           #"\n\n". &sprintAutoProfile().  '</PRE>'.
 367           "\n\n".                         '</PRE>'.
 368           '</BODY></HTML>'
 369         );
 370
 371         dbh->{'private_profile'} = {};
 372
 373       } else {
 374
 375         #clear db profile, but normal redirect
 376         dbh->{'private_profile'} = {};
 377         $m->redirect($location);
 378
 379       }
 380
 381     } else { #normal redirect
 382
 383       $m->redirect($location);
 384
 385     }
 386
 387   }
 388
 389 } # end package HTML::Mason::Commands;
 390
 391 =head1 SUBROUTINE
 392
 393 =over 4
 394
 395 =item mason_interps [ MODE ]
 396
 397 Returns a list consisting of two HTML::Mason::Interp objects, the first for
 398 Freeside pages, and the second for RT pages.
 399
 400 #MODE can be 'apache' or 'standalone'.  If not specified, defaults to 'apache'.
 401
 402 =cut
 403
 404 sub mason_interps {
 405   my $mode = shift || 'apache';
 406   my %opt = @_;
 407
 408   #my $request_class = 'HTML::Mason::Request'.
 409                       #( $mode eq 'apache' ? '::ApacheHandler' : '' );
 410   my $request_class = 'FS::Mason::Request';
 411
 412   #not entirely sure it belongs here, but what the hey
 413   if ( %%%RT_ENABLED%%% ) {
 414     RT::LoadConfig();
 415   }
 416
 417   # A hook supporting strange legacy ways people have added stuff on
 418
 419   my @addl_comp_root = ();
 420   my $addl_comp_root_file = '%%%FREESIDE_CONF%%%/addl_comp_root.pl';
 421   if ( -e $addl_comp_root_file ) {
 422     warn "reading $addl_comp_root_file\n";
 423     my $text = slurp( $addl_comp_root_file );
 424     my @addl = eval $text;
 425     if ( @addl && ! $@ ) {
 426       @addl_comp_root = @addl;
 427     } elsif ($@) {
 428       warn "error parsing $addl_comp_root_file: $@\n";
 429     }
 430   }
 431
 432   my %interp = (
 433     request_class        => $request_class,
 434     data_dir             => '%%%MASONDATA%%%',
 435     error_mode           => 'output',
 436     error_format         => 'html',
 437     ignore_warnings_expr => '.',
 438     comp_root            => [
 439                               [ 'freeside'=>'%%%FREESIDE_DOCUMENT_ROOT%%%'    ],
 440                               [ 'rt'      =>'%%%FREESIDE_DOCUMENT_ROOT%%%/rt' ],
 441                               @addl_comp_root,
 442                             ],
 443   );
 444
 445   $interp{out_method} = $opt{outbuf} if $mode eq 'standalone' && $opt{outbuf};
 446
 447   my $fs_interp = new HTML::Mason::Interp (
 448     %interp,
 449     escape_flags => { 'js_string' => sub {
 450                         #${$_[0]} =~ s/(['\\\n])/'\\'.($1 eq "\n" ? 'n' : $1)/ge;
 451                         ${$_[0]} =~ s/(['\\])/\\$1/g;
 452                         ${$_[0]} =~ s/\r/\\r/g;
 453                         ${$_[0]} =~ s/\n/\\n/g;
 454                         ${$_[0]} = "'". ${$_[0]}. "'";
 455                       }
 456                     },
 457     compiler     => HTML::Mason::Compiler::ToObject->new(
 458                       allow_globals        => [qw(%session)],
 459                     ),
 460   );
 461
 462   my $rt_interp = new HTML::Mason::Interp (
 463     %interp,
 464     escape_flags => { 'h' => \&RT::Interface::Web::EscapeUTF8 },
 465     compiler     => HTML::Mason::Compiler::ToObject->new(
 466                       default_escape_flags => 'h',
 467                       allow_globals        => [qw(%session)],
 468                     ),
 469   );
 470
 471   ( $fs_interp, $rt_interp );
 472
 473 }
 474
 475 =back
 476
 477 =head1 BUGS
 478
 479 Lurking in the darkness...
 480
 481 =head1 SEE ALSO
 482
 483 L<HTML::Mason>, L<FS>, L<RT>
 484
 485 =cut
 486
 487 1;