httemplate/elements/menu.html

   1 <script type="text/javascript" src="<%$fsurl%>elements/cssexpr.js"></script>
   2
   3 % if ( $opt{'position'} eq 'top' ) {
   4
   5   <script type="text/javascript" src="<%$fsurl%>elements/xmenu.top.js"></script>
   6   <link href="<%$fsurl%>elements/xmenu.top.css" type="text/css" rel="stylesheet">
   7
   8 % } else {  # elsif ( $opt{'position'} eq 'left' ) {
   9
  10   <script type="text/javascript" src="<%$fsurl%>elements/xmenu.js"></script>
  11   <link href="<%$fsurl%>elements/xmenu.css" type="text/css" rel="stylesheet">
  12
  13 % }
  14
  15 % unless ( $opt{'nocss'} ) {
  16   <link href="<%$fsurl%>elements/freeside.css" type="text/css" rel="stylesheet">
  17   <link href="<%$fsurl%>elements/freeside-print.css" type="text/css" rel="stylesheet" media="print">
  18 % }
  19 <link href="<%$fsurl%>elements/freeside-menu.css" type="text/css" rel="stylesheet">
  20
  21 <SCRIPT TYPE="text/javascript">
  22
  23 % my $fs_popup = include( '/elements/popup_link_onclick.html',
  24 %                           'action'      => $fsurl.'docs/about.html',
  25 %                           'label'       => emt('Freeside'),
  26 %                           'style'       => 'color:#999999',
  27 %                           'actionlabel' => emt('About'),
  28 %                           'width'       => 300,
  29 %                           'height'      => 375,
  30 %                           'color'       => '#7e0079',
  31 %                           #'scrolling'   => 'no',
  32 %                       );
  33 % $fs_popup =~ s/return false;//;
  34   function about_freeside() {
  35     <% $fs_popup |n %>
  36   }
  37
  38   webfxMenuImagePath      = "<%$fsurl%>images/";
  39   webfxMenuUseHover       = 1;
  40   webfxMenuShowTime       = 300;
  41   webfxMenuHideTime       = 500;
  42
  43   var myBar = new WebFXMenuBar;
  44
  45 % if ( $mobile ) {
  46 %
  47 %   my( $subhtml, $submenuname ) = submenu(\%menu, 'Freeside');
  48     <% $subhtml |n %>
  49     myBar.add(new WebFXMenuButton("Freeside",
  50                                   null,
  51                                   null,
  52                                   <% $submenuname |n %>));
  53 % }
  54 % else {
  55 %   foreach my $item ( keys %menu ) {
  56 %
  57 %     my( $url_or_submenu, $tooltip ) = @{ $menu{$item} };
  58 %
  59 %     if ( ref($url_or_submenu) ) {
  60 %
  61 %         #warn $item;
  62 %
  63 %         my( $subhtml, $submenuname ) = submenu($url_or_submenu, $item);
  64
  65           <% $subhtml |n %>
  66           myBar.add(new WebFXMenuButton(<% mt($item) |js_string %>, null, <% mt($tooltip) |js_string %>, <% $submenuname |n %> ));
  67
  68 %     } else {
  69
  70           myBar.add(new WebFXMenuButton(<% mt($item) |js_string %>, "<% $url_or_submenu %>", <% mt($tooltip) |js_string %> ));
  71
  72 %     }
  73 %   } #foreach $item
  74 % } #if $mobile
  75
  76   myBar.show( null, 'vertical' );
  77   myBar.width = 154;
  78
  79 </SCRIPT>
  80
  81 <%init>
  82 my( %opt ) = @_;
  83 my $conf = new FS::Conf;
  84 my $fsurl = $opt{'freeside_baseurl'};
  85
  86 my $mobile = $opt{'mobile'} || 0;
  87
  88 my $curuser = $FS::CurrentUser::CurrentUser;
  89
  90 #XXX Active tickets not assigned to a customer
  91
  92 tie my %report_prospects, 'Tie::IxHash',
  93   'List prospects' => [ $fsurl. 'search/prospect_main.html', '' ],
  94   'Advanced prospect reports' => [ $fsurl. 'search/report_prospect_main.html', '' ],
  95 ;
  96
  97 tie my %report_quotations, 'Tie::IxHash',
  98   'List quotations' => [ $fsurl. 'search/quotation.html', '' ],
  99   'Advanced quotation reports' => [ $fsurl. 'search/report_quotation.html', '' ],
 100 ;
 101
 102 tie my %report_customers_lists, 'Tie::IxHash',
 103   'by customer number' => [ $fsurl. 'search/cust_main.cgi?browse=custnum', '' ],
 104   'by last name' => [ $fsurl. 'search/cust_main.cgi?browse=last', '' ],
 105   'by company name' => [ $fsurl. 'search/cust_main.cgi?browse=company', '' ],
 106 ;
 107 $report_customers_lists{'by active trouble tickets'} = [ $fsurl. 'search/cust_main.cgi?browse=tickets', '' ]
 108   if $conf->config('ticket_system');
 109 $report_customers_lists{'with USPS-unvalidated addresses'} = [ $fsurl. 'search/cust_main.cgi?browse=uspsunvalid', '' ]
 110   if $conf->config('usps_webtools-userid') && $conf->config('usps_webtools-password');
 111
 112 tie my %report_customers, 'Tie::IxHash';
 113 $report_customers{'List customers'} = [ \%report_customers_lists, 'List customers' ]
 114   if $curuser->access_right('List all customers');
 115 $report_customers{'Zip code distribution'}     = [ $fsurl. 'search/report_cust_main-zip.html', 'Zip codes by number of customers' ];
 116 $report_customers{'Customer signup report'}       = [ $fsurl. 'graph/report_cust_signup.html', 'New customer signups by date' ],
 117 $report_customers{'Advanced customer reports'} = [ $fsurl. 'search/report_cust_main.html', 'by status, signup date, agent, etc.' ]
 118   if $curuser->access_right('Advanced customer search');
 119
 120 tie my %report_invoices_open, 'Tie::IxHash',
 121   'All open invoices' => [ $fsurl.'search/cust_bill.html?OPEN_date', 'All invoices with an unpaid balance' ],
 122   '15 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN15_date', 'Invoices 15 days or older with an unpaid balance' ],
 123   '30 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN30_date', 'Invoices 30 days or older with an unpaid balance' ],
 124   '60 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN60_date', 'Invoices 60 days or older with an unpaid balance' ],
 125   '90 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN90_date', 'Invoices 90 days or older with an unpaid balance' ],
 126   '120 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN120_date', 'Invoices 120 days or older with an unpaid balance' ],
 127 ;
 128
 129 tie my %report_invoices, 'Tie::IxHash',
 130   'Open invoices' => [ \%report_invoices_open, 'Open invoices' ],
 131   'All invoices'  => [ $fsurl. 'search/cust_bill.html?date', 'List all invoices' ],
 132   'Advanced invoice reports' => [ $fsurl.'search/report_cust_bill.html', 'by agent, date range, etc.' ],
 133   'separator'     => '',
 134   'Line items'    => [ $fsurl. 'search/report_cust_bill_pkg.html', 'Individual line item detail' ],
 135 ;
 136
 137 tie my %report_discounts, 'Tie::IxHash',
 138   'Discount graph'  => [ $fsurl. 'graph/report_cust_bill_pkg_discount.html', 'Discount overview per month' ],
 139   'Discount detail' => [ $fsurl.'search/report_cust_bill_pkg_discount.html', 'Discount report (by employee and/or date range)' ],
 140   #awful name
 141   'Package discounts' => [ $fsurl.'search/report_cust_pkg_discount.html', 'Active/inactive discounts by package' ],
 142 ;
 143
 144 tie my %report_services, 'Tie::IxHash';
 145 if ( $curuser->access_right('Configuration') ) {
 146   $report_services{'Service definitions'} =  [ $fsurl.'browse/part_svc.cgi?orderby=active', 'Service definitions by number of active packages' ];
 147   $report_services{'separator'} =  '';
 148 }
 149
 150 if ( $curuser->access_right('List services') ) {
 151   $report_services{'Unprovisioned services'} =  [ $fsurl.'search/report_unprovisioned_services.html', 'Unprovisioned services' ];
 152   $report_services{'separator2'} =  '';
 153 }
 154
 155 foreach my $svcdb ( FS::part_svc->svc_tables() ) {
 156
 157   my $name =        "FS::$svcdb"->table_info->{'name_plural'}
 158              || PL( "FS::$svcdb"->table_info->{'name'}        );
 159   my $lcname =  "FS::$svcdb"->table_info->{'lcname_plural'} || lc($name);
 160   my $lcsname = lc("FS::$svcdb"->table_info->{'name'});
 161   my $longname = "FS::$svcdb"->table_info->{'longname_plural'} || $name;
 162   my $lclongname = lc($longname);
 163   my $sorts = "FS::$svcdb"->table_info->{'sorts'} || [ 'svcnum' ];
 164   $sorts = [ $sorts ] unless ref($sorts);
 165   my %svc_url = ( 'm'      => $m,
 166                   'action' => 'search',
 167                   'svcdb'  => $svcdb,
 168                 );
 169
 170   tie my %report_svc, 'Tie::IxHash';
 171
 172   foreach my $sort ( @$sorts ) {
 173
 174     my $field_info = FS::part_svc->svc_table_fields($svcdb)->{$sort};
 175     my $label = $field_info->{'label_sort'} || 'by '.$field_info->{'label'};
 176
 177     my $title = "All $lcname";
 178     $title .= " $label"
 179       if scalar(@$sorts) > 1;
 180
 181     $report_svc{$title} =
 182       [ svc_url( %svc_url, 'query' => "magic=all;sortby=$sort" ),
 183         '',
 184       ];
 185   }
 186
 187   if ( $svcdb eq 'svc_acct' ) {
 188
 189     $report_svc{"All $lcname never logged in"} =
 190       [ svc_url( %svc_url, 'query' => "magic=nologin;sortby=svcnum" ),
 191         '',
 192       ];
 193
 194   } elsif ( $svcdb eq 'svc_phone' ) {
 195
 196     $report_svc{"${name}' total usage by time period"} =
 197       [ $fsurl. 'search/report_svc_phone_usage.html',
 198         'Total usage (minutes, and amount billed) for the specified time period, per phone number.',
 199       ];
 200     $report_svc{"${name} by state"} =
 201       [ $fsurl. 'search/phone_state.html',
 202         'Current or historical phone services broken down by state.',
 203       ];
 204
 205   }
 206
 207   if ( $curuser->access_right('View/link unlinked services') ) {
 208     $report_svc{"Unlinked $lcname"} =
 209       [ svc_url( %svc_url, 'query' => "magic=unlinked;sortby=". $sorts->[0] ),
 210         "Pre-Freeside $lcname without a customer record",
 211       ];
 212   }
 213
 214     $report_svc{"Advanced $lcsname reports"} =
 215         [ $fsurl."search/report_$svcdb.html", '' ]
 216       if $svcdb =~ /^svc_(acct|broadband|hardware|phone)$/
 217       && $curuser->access_right("Services: $name: Advanced search");
 218
 219   if ( $svcdb eq 'svc_phone' ) {
 220
 221     $report_svc{"Phone number (DID) availability"} =
 222       [ $fsurl."search/report_phone_avail.html", '' ];
 223     $report_svc{"Inventory/Provisioning Status"} =
 224       [ $fsurl."search/phone_inventory_provisioned.html", '' ];
 225
 226   } elsif ( $svcdb eq 'svc_dsl' ) {
 227
 228     $report_svc{'Qualifications'} = [ $fsurl. 'search/qual.cgi', #XXX qual.html
 229                                       '',
 230                                     ];
 231
 232   }
 233
 234   $report_services{$name} = [ \%report_svc, $longname ]
 235     if $curuser->access_right("Services: $name");
 236
 237 }
 238
 239 tie my %report_packages, 'Tie::IxHash';
 240 $report_packages{'Package definitions (by # active)'} =  [ $fsurl.'browse/part_pkg.cgi?active=1', 'Package definitions by number of active packages' ]
 241   if    $curuser->access_right('Edit package definitions')
 242      || $curuser->access_right('Edit global package definitions');
 243 $report_packages{'Package costs'} = [ $fsurl.'graph/report_cust_pkg_cost.html', 'Package setup and recurring costs graph' ]
 244   if $curuser->access_right('Financial reports');
 245 $report_packages{'separator'} =  ''
 246   if keys %report_packages;
 247 if ( $curuser->access_right('Financial reports') ) {
 248   $report_packages{'Package churn'} =  [ $fsurl.'graph/report_cust_pkg.html', 'Orders, suspensions and cancellations summary graph' ];
 249   $report_packages{'separator2'} =  '';
 250 }
 251 $report_packages{'All customer packages'} =  [ $fsurl.'search/cust_pkg.cgi?pkgnum', 'List all customer packages', ];
 252 $report_packages{'Package summary'} = [ $fsurl.'search/cust_pkg_summary.html', 'Show package sales summary', ]
 253   if $curuser->access_right('Summarize packages');
 254 $report_packages{'Suspended customer packages'} =  [ $fsurl.'search/cust_pkg.cgi?magic=suspended', 'List suspended packages' ];
 255 $report_packages{'Suspension summary'} = [ $fsurl.'search/cust_pkg_susp.html', 'Show suspension activity', ]
 256   if $curuser->access_right('Summarize packages');
 257 $report_packages{'Customer packages with unconfigured services'} =  [ $fsurl.'search/cust_pkg.cgi?APKG_pkgnum', 'List packages which have provisionable services' ];
 258 $report_packages{'FCC Form 477 packages'} =  [ $fsurl.'search/report_477.html', 'Summarize packages by census tract for particular types' ]
 259   if $conf->exists('cust_main-require_censustract');
 260 $report_packages{'Advanced package reports'} =  [ $fsurl.'search/report_cust_pkg.html', 'by agent, date range, status, package definition' ];
 261
 262 tie my %report_inventory, 'Tie::IxHash',
 263   'Inventory by agent' => [ $fsurl.'search/report_agent_inventory.html', '' ],
 264   'Inventory activity' => [ $fsurl.'search/report_h_inventory_item.html', '' ],
 265 ;
 266
 267 tie my %report_rating, 'Tie::IxHash';
 268 $report_rating{'RADIUS sessions'} = [ $fsurl.'search/sqlradius.html', '' ]
 269   if $curuser->access_right("Usage: RADIUS sessions");
 270 $report_rating{'RADIUS data usage'} = [ $fsurl.'search/report_sqlradius_usage.html', '' ]
 271   if $curuser->access_right("Usage: RADIUS sessions");
 272 $report_rating{'Call Detail Records (CDRs)'} = [ $fsurl.'search/report_cdr.html', '' ]
 273   if $curuser->access_right("Usage: Call Detail Records (CDRs)");
 274 $report_rating{'Unrateable CDRs'} = [ $fsurl.'search/cdr.html?freesidestatus=failed;cdrbatchnum=_ALL_' ]
 275   if $curuser->access_right("Usage: Unrateable CDRs");
 276 if ( $curuser->access_right("Usage: Time worked") ) {
 277   $report_rating{'Time worked'} = [ $fsurl.'search/report_rt_transaction.html', '' ];
 278   $report_rating{'Time worked summary'} = [ $fsurl.'search/report_rt_ticket.html', '' ];
 279 }
 280
 281 tie my %report_ticketing_statistics, 'Tie::IxHash',
 282   'Tickets per day per Queue'         => [ $fsurl.'rt/RTx/Statistics/CallsQueueDay', 'View the number of tickets created, resolved or deleted in a specific Queue, over the requested period of days' ],
 283   'Ticket status by Queue'            => [ $fsurl.'rt/RTx/Statistics/OpenStalled', 'View numbers of new, open and stalled tickets in a selected Queue' ],
 284   'Tickets per day (multiple Queues)' => [ $fsurl.'rt/RTx/Statistics/CallsMultiQueue', 'View tickets created, resolved or deleted on in one or more Queues over a specified time period' ],
 285   'Tickets per Day of Week'           => [ $fsurl.'rt/RTx/Statistics/DayOfWeek', 'View trends showing when tickets are created, resolved or deleted' ],
 286   'Time to resolve'                   => [ $fsurl.'rt/RTx/Statistics/Resolution', 'View how long tickets take to be resolved by Queue' ],
 287   'Time to resolve (scatter graph)'   => [ $fsurl.'rt/RTx/Statistics/TimeToResolve', 'View a detailed scatter graph of time to resolve tickets by Queue' ],
 288 ;
 289
 290 tie my %report_ticketing, 'Tie::IxHash',
 291 # fix TimeToResolve extension?  or redo in a more modern way?
 292 #  'Resolved by owner'       => [ $fsurl.'rt/Tools/Reports/ResolvedByOwner.html', '' ],
 293 #  'Resolved in date range'  => [ $fsurl.'rt/Tools/Reports/ResolvedByDates.html', '' ],
 294 #  'Created in date range'   => [ $fsurl.'rt/Tools/Reports/CreatedByDates.html', '' ],
 295 #  'separator'               => '',
 296   'Statistics'              => [ \%report_ticketing_statistics, '' ],
 297   'separator2'              => '',
 298   'Advanced ticket reports' => [ $fsurl.'rt/Search/Build.html?NewQuery=1', 'List tickets by any criteria' ],
 299 ;
 300
 301 tie my %report_employees, 'Tie::IxHash';
 302 $report_employees{'Employee Commission Report'} = [ $fsurl.'search/report_employee_commission.html', '' ]
 303   if $curuser->access_right('Employees: Commission Report');
 304 $report_employees{'Employee Audit Report'} = [ $fsurl.'search/report_employee_audit.html', 'Employee audit report' ]
 305   if $curuser->access_right('Employees: Audit Report');
 306 ;
 307
 308 tie my %report_bill_event, 'Tie::IxHash',
 309   'All billing events' => [ $fsurl.'search/report_cust_event.html', 'All billing events for a date range' ],
 310   'Billing event errors' => [ $fsurl.'search/report_cust_event.html?failed=1', 'Failed credit cards, processor or printer problems, etc.' ],
 311 #  'All invoice events' => [ $fsurl.'search/cust_bill_event.html', 'Reports on deprecated, old-style invoice events for a date range' ],
 312 #  'Invoice event errors' => [ $fsurl.'search/cust_bill_event.html?failed=1', 'Reports on deprecated, old-style events for failed credit cards, processor or printer problems, etc.' ],
 313 ;
 314
 315 tie my %report_payments, 'Tie::IxHash',
 316     'Payments' => [ $fsurl.'search/report_cust_pay.html', 'Payment report (by type and/or date range)' ],
 317 ;
 318 $report_payments{'Pending Payments'} = [ $fsurl.'search/cust_pay_pending.html?magic=_date;statusNOT=done', 'Pending real-time payments' ]
 319   if $curuser->access_right('View customer pending payments');
 320 $report_payments{'Voided Payments'} = [ $fsurl.'search/report_cust_pay.html?void=1', 'Voided payment report (by type and/or date range)' ]
 321   if $curuser->access_right('View customer pending payments');
 322 $report_payments{'Unapplied Payments'} = [ $fsurl.'search/report_cust_pay.html?unapplied=1', 'Unapplied payment report (by type and/or date range)' ];
 323 $report_payments{'Payment Batches'} = [ $fsurl.'search/pay_batch.html', 'Payment batches (by status and/or date range)' ]
 324   if $conf->exists('batch-enable') || $conf->config('batch-enable_payby');
 325 $report_payments{'Unapplied Payment Aging'} = [ $fsurl.'search/report_unapplied_cust_pay.html', 'Unapplied payment aging report' ];
 326 $report_payments{'Deleted Payments / Payment history table'} = [ $fsurl.'search/report_h_cust_pay.html', 'Deleted payments / payment history table' ]
 327   if $conf->exists('payment-history-report');
 328
 329 tie my %report_credits, 'Tie::IxHash',
 330   'Credit Report' => [ $fsurl.'search/report_cust_credit.html', 'Credit report (by employee and/or date range)' ],
 331   'Credit application detail' => [ $fsurl.'search/report_cust_credit_bill_pkg.html', 'Line item application detail' ],
 332   'Unapplied Credits' => [ $fsurl.'search/report_cust_credit.html?unapplied=1', 'Unapplied credit report (by type and/or date range)' ],
 333 ;
 334
 335 tie my %report_refunds, 'Tie::IxHash',
 336   'Refund Report' => [ $fsurl.'search/report_cust_refund.html', 'Refund report (by type and/or date range)' ],
 337   'Unapplied Refunds' => [ $fsurl.'search/report_cust_refund.html?unapplied=1', 'Unapplied refund report (by type and/or date range)' ],
 338 ;
 339
 340 tie my %report_sales, 'Tie::IxHash',
 341   'Sales, Credits and Receipts' => [ $fsurl.'graph/report_money_time.html', 'Sales, credits and receipts summary graph' ],
 342   'Daily Sales, Credits and Receipts' => [ $fsurl.'graph/report_money_time_daily.html', 'Sales, credits and receipts (broken down by day) summary graph' ],
 343   'Sales Report' => [ $fsurl.'graph/report_cust_bill_pkg.html', 'Sales report and graph (by agent, package class and/or date range)' ],
 344   'Rated Call Sales Report' => [ $fsurl.'graph/report_cust_bill_pkg_detail.html', 'Sales report and graph (by agent, package class, usage class and/or date range)' ],
 345   'Sales with Advertising Source' => [ $fsurl.'search/report_cust_bill_pkg_referral.html' ],
 346   'Agent Commissions' => [ $fsurl.'search/report_agent_commission.html' ],
 347   'Sales Person Commissions' => [ $fsurl.'search/report_sales_commission.html' ],
 348   'Sales Person Commission per package' => [ $fsurl.'search/report_sales_commission_pkg.html' ],
 349 ;
 350
 351 tie my %report_financial, 'Tie::IxHash';
 352 if( $curuser->access_right('Financial reports') ) {
 353
 354   %report_financial = (
 355     'Sales' => [ \%report_sales, 'Sales reports', ],
 356     'Credits' => [ \%report_credits, 'Credit reports', ],
 357     'Refunds' => [ \%report_refunds, 'Refund reports', ],
 358   );
 359   $report_financial{'A/R Aging'} = [ $fsurl.'search/report_receivables.html', 'Accounts Receivable Aging report' ];
 360   $report_financial{'Prepaid Income'} = [ $fsurl.'search/report_prepaid_income.html', 'Prepaid income (unearned revenue)  report' ];
 361
 362   my $taxproducts = $conf->exists('enable_taxproducts');
 363   $report_financial{'Tax Liability'. ($taxproducts ? ' (internal tax data)' : '')} = [ $fsurl.'search/report_tax.html', 'Tax liability report (internal tax data)' ];
 364   $report_financial{'Tax Liability (vendor tax data)'} = [ $fsurl.'search/report_newtax.html', 'Tax liability report (vendor tax data)' ]
 365     if $taxproducts;
 366
 367   # most sites don't need this but there isn't really a config to enable it
 368   $report_financial{'E911 Fee Summary'} = [ $fsurl.'search/report_e911.html', 'E911 fee summary' ];
 369
 370   $report_financial{'Customer Accounting Summary'} = [ $fsurl.'search/report_customer_accounting_summary.html', 'Customer accounting summary report' ];
 371
 372 } elsif($curuser->access_right('Receivables report')) {
 373
 374   $report_financial{'A/R Aging'} = [ $fsurl.'search/report_receivables.html', 'Accounts Receivable Aging report' ];
 375
 376 } # else $report_financial contains nothing.
 377
 378 tie my %report_logs, 'Tie::IxHash';
 379   $report_logs{'System log'} = [ $fsurl.'search/log.html', 'View system events and debugging information.' ],
 380   if $curuser->access_right('View system logs')
 381   || $curuser->access_right('Configuration');
 382   $report_logs{'Outgoing messages'} = [ $fsurl.'search/cust_msg.html', 'View outgoing message log' ]
 383   if $curuser->access_right('View email logs')
 384   || $curuser->access_right('Configuration');
 385
 386 tie my %report_menu, 'Tie::IxHash';
 387 $report_menu{'Prospects'}      = [ \%report_prospects, 'Prospect reports' ]
 388   if $curuser->access_right('List prospects');
 389 $report_menu{'Quotations'}     = [ \%report_quotations, 'Quotation reports' ]
 390   if $curuser->access_right('List quotations');
 391 $report_menu{'Customers'}      = [ \%report_customers, 'Customer reports'  ]
 392   if $curuser->access_right('List customers');
 393 $report_menu{'Invoices'}       =  [ \%report_invoices,  'Invoice reports'   ]
 394   if $curuser->access_right('List invoices');
 395 $report_menu{'Discounts'}      =  [ \%report_discounts, 'Discount reports'  ]
 396   if $curuser->access_right('Financial reports');
 397 $report_menu{'Payments'}       =  [ \%report_payments,  'Payment reports'   ]
 398   if $curuser->access_right('Financial reports');
 399 $report_menu{'Packages'}       =  [ \%report_packages,  'Package reports'   ]
 400   if $curuser->access_right('List packages');
 401 $report_menu{'Services'}       =  [ \%report_services,  'Services reports'  ]
 402   if $curuser->access_right('List services');
 403 $report_menu{'Inventory'}      =  [ \%report_inventory,  'Inventory reports'  ]
 404   if $curuser->access_right('Configuration'); #XXX List inventory?
 405 $report_menu{'Usage'}          =  [ \%report_rating,    'Usage reports'  ]
 406   if $curuser->access_right('List rating data');
 407 $report_menu{'Tickets'}        = [ \%report_ticketing, 'Ticket reports' ]
 408   if $conf->config('ticket_system')
 409   ;#&& FS::TicketSystem->access_right(\%session, 'Something');
 410 $report_menu{'Employees'}      =  [ \%report_employees, 'Employee reports'  ]
 411   if keys %report_employees;
 412 $report_menu{'Billing events'} =  [ \%report_bill_event, 'Billing events' ]
 413   if $curuser->access_right('Billing event reports');
 414 $report_menu{'Financial'}      = [ \%report_financial, 'Financial reports' ]
 415   if $curuser->access_right('Financial reports')
 416   or $curuser->access_right('Receivables report');
 417 $report_menu{'Logs'}           = [ \%report_logs, 'System and email logs' ]
 418   if (keys %report_logs); # empty if the user has no rights to it
 419 $report_menu{'SQL Query'}      = [ $fsurl.'search/report_sql.html', 'SQL Query']
 420   if $curuser->access_right('Raw SQL');
 421
 422 tie my %tools_importing, 'Tie::IxHash',
 423   'Customers' => [ $fsurl.'misc/cust_main-import.cgi', '' ],
 424   'Customer packages' => [ $fsurl.'misc/cust_pkg-import.html', '' ],
 425   'Customer comments' => [ $fsurl.'misc/cust_main_note-import.html', '' ],
 426   'One-time charges' => [ $fsurl.'misc/cust_main-import_charges.cgi', '' ],
 427   'Payments' => [ $fsurl.'misc/cust_pay-import.cgi', '' ],
 428   'Credits' => [ $fsurl.'misc/cust_credit-import.html', '' ],
 429   'Phone numbers (DIDs)' => [ $fsurl.'misc/phone_avail-import.html', '' ],
 430   'Call Detail Records (CDRs)' => [ $fsurl.'misc/cdr-import.html', '' ],
 431 ;
 432 if ( $conf->exists('enable_taxproducts') ) {
 433   if ( $conf->exists('taxdatadirectdownload') ) {
 434       $tools_importing{'Tax rates from vendor site'} =
 435       [ $fsurl.'misc/tax-fetch_and_import.cgi', '' ];
 436   } else {
 437     $tools_importing{'Tax rates from CSV files'} =
 438       [ $fsurl.'misc/tax-import.cgi', '' ];
 439   }
 440 }
 441
 442 tie my %tools_exporting, 'Tie::IxHash',
 443   'Download database dump' => [ $fsurl. 'misc/dump.cgi', '' ],
 444 ;
 445
 446 tie my %tools_ticketing_articles, 'Tie::IxHash',
 447   'Overview' => [ $fsurl.'rt/Articles/index.html', '' ],
 448   'Search'   => [ $fsurl.'rt/Articles/Article/Search.html', '' ],
 449   'Topics'   => [ $fsurl.'rt/Articles/Topics.html', '' ],
 450 ;
 451
 452 tie my %tools_ticketing, 'Tie::IxHash',
 453   'Articles'     => [ \%tools_ticketing_articles, '' ],
 454   'My Day'       => [ $fsurl.'rt/Tools/MyDay.html', '' ],
 455   'My Reminders' => [ $fsurl.'rt/Tools/MyReminders.html', '' ],
 456   'Offline'      => [ $fsurl.'rt/Tools/Offline.html', '' ],
 457   'Approval'     => [ $fsurl.'rt/Approvals/', '' ],
 458 ;
 459 $tools_ticketing{'Cron Tool'} = [ $fsurl.'rt/Developer/CronTool/', '' ]
 460   if $conf->exists('rt-crontool');
 461
 462 tie my %tools_menu, 'Tie::IxHash', ();
 463 $tools_menu{'Quick payment entry'} =  [ $fsurl.'misc/batch-cust_pay.html', 'Enter multiple payments in a batch' ]
 464   if $curuser->access_right('Post payment batch');
 465 $tools_menu{'Process payment batches'} = [ $fsurl.'search/pay_batch.cgi?magic=_date;open=1;intransit=1', 'Process credit card and electronic check batches' ]
 466   if ( $conf->exists('batch-enable') || $conf->config('batch-enable_payby') )
 467      && $curuser->access_right('Process batches');
 468 $tools_menu{'Download invoice batches'} = [ $fsurl.'search/bill_batch.cgi' ]
 469   if $curuser->access_right('Process invoice batches')
 470   || $curuser->access_right('Process global invoice batches')
 471   || $curuser->access_right('Configuration'); #XXX remove in 2.5
 472   #now there's a standalone event#if $conf->exists('invoice_print_pdf');
 473 $tools_menu{'Bulk DID Orders'} =  [ $fsurl.'browse/did_order.html', 'View/manage bulk DID orders' ]
 474   if $curuser->access_right('Import');
 475 $tools_menu{'Job Queue'} =  [ $fsurl.'search/queue.html', 'View pending job queue' ]
 476   if $curuser->access_right('Job queue');
 477 $tools_menu{'Ticketing'} = [ \%tools_ticketing, 'Ticketing tools' ]
 478   if $conf->config('ticket_system');
 479 $tools_menu{'Customer email settings'} = [ $fsurl.'misc/manage_cust_email.html' ]
 480   if $curuser->access_right('Edit customer');
 481 $tools_menu{'Business card scan'} = [ $fsurl.'edit/prospect_main-upload.html' ]
 482   if $curuser->access_right('New prospect');
 483 $tools_menu{'Time Queue'} =  [ $fsurl.'search/report_timeworked.html', 'View pending support time' ]
 484   if $curuser->access_right('Time queue');
 485 $tools_menu{'Attachments'} = [ $fsurl.'browse/cust_attachment.html', 'View customer attachments' ]
 486   if !$conf->config('disable_cust_attachment') and $curuser->access_right('View attachments') and $curuser->access_right('Browse attachments');
 487 $tools_menu{'Importing'} =  [ \%tools_importing, 'Import tools' ]
 488   if $curuser->access_right('Import');
 489 $tools_menu{'Exporting'} =  [ \%tools_exporting, 'Export tools' ]
 490   if $curuser->access_right('Export');
 491
 492 tie my %config_employees, 'Tie::IxHash',
 493   'Employees' => [ $fsurl.'browse/access_user.html', 'Setup internal users' ],
 494   'Employee groups' => [ $fsurl.'browse/access_group.html', 'Employee groups allow you to control access to the backend' ],
 495 ;
 496
 497 tie my %config_dialup, 'Tie::IxHash',
 498   'Access numbers' => [ $fsurl.'browse/svc_acct_pop.cgi', 'Points of Presence' ],
 499 ;
 500
 501 tie my %config_broadband, 'Tie::IxHash',
 502   'Towers'         => [ $fsurl.'browse/tower.html', 'Towers and sectors' ],
 503   'Routers'        => [ $fsurl.'browse/router.cgi', 'Broadband access routers' ],
 504   'Address blocks' => [ $fsurl.'browse/addr_block.cgi', 'Manage address blocks and block assignments to broadband routers' ],
 505 ;
 506 if ( $curuser->access_right('Broadband global configuration') ) {
 507   $config_broadband{'Address ranges'} =
 508                       [ $fsurl.'browse/addr_range.html', 'Designate special address ranges' ];
 509 }
 510
 511 tie my %config_phone, 'Tie::IxHash',
 512   'View/Edit phone device types' => [ $fsurl.'browse/part_device.html', 'Phone device types' ],
 513   'View/Edit bulk DID vendors' => [ $fsurl.'browse/did_vendor.html', 'Bulk DID vendors' ],
 514   'View/Edit Carriers' => [ $fsurl.'browse/cdr_carrier.html', 'Carriers' ],
 515 ;
 516
 517 tie my %config_radius, 'Tie::IxHash',
 518   'RADIUS Groups' => [ $fsurl.'browse/radius_group.html', 'Manage RADIUS groups' ],
 519   'RADIUS Clients' => [ $fsurl.'browse/nas.html', 'Manage RADIUS clients' ],
 520 ;
 521
 522 tie my %config_cable, 'Tie::IxHash',
 523   'Cable providers' => [ $fsurl.'browse/cable_provider.html', '' ],
 524   'Cable modem models' => [ $fsurl.'browse/cable_model.html', '' ],
 525 ;
 526
 527 tie my %config_alarm, 'Tie::IxHash',
 528   'Alarm system vendors'   => [ $fsurl.'browse/alarm_system.html', '' ],
 529   'Alarm system types'     => [ $fsurl.'browse/alarm_type.html', '' ],
 530   'Alarm central stations' => [ $fsurl.'browse/alarm_station.html', '' ],
 531 ;
 532
 533 tie my %config_export_svc, 'Tie::IxHash', ();
 534 if ( $curuser->access_right('Configuration') ) {
 535   $config_export_svc{'Service definitions'} = [ $fsurl.'browse/part_svc.cgi', 'Services are items you offer to your customers' ];
 536   $config_export_svc{'Service classes'} = [ $fsurl.'browse/part_svc_class.html', 'Services classes are user-defined, informational types for services' ];
 537   $config_export_svc{'Provisioning exports'} = [ $fsurl.'browse/part_export.cgi', 'Provisioning services to external machines, databases and APIs' ];
 538 }
 539 $config_export_svc{'Dialup'}  = [ \%config_dialup, ''    ]
 540   if $curuser->access_right('Dialup configuration');
 541 $config_export_svc{'Wireless broadband'} = [ \%config_broadband, ''    ]
 542   if $curuser->access_right('Broadband configuration');
 543 $config_export_svc{'Phone'}  = [ \%config_phone, ''    ]
 544   if $curuser->access_right('Configuration');
 545 $config_export_svc{'RADIUS'} = [ \%config_radius, '' ]
 546   if $curuser->access_right('Configuration');
 547 $config_export_svc{'Cable'} = [ \%config_cable, '' ]
 548   if $curuser->access_right('Configuration');
 549 $config_export_svc{'Alarm'} = [ \%config_alarm, '' ]
 550   if $curuser->access_right(['Alarm configuration', 'Alarm global configuration']);
 551 $config_export_svc{'Hardware types'} = [ $fsurl.'browse/hardware_class.html', 'Set up hardware type catalog' ]
 552   if $curuser->access_right('Configuration');
 553
 554 tie my %config_pkg_reason, 'Tie::IxHash',
 555   'Cancel reasons' => [ $fsurl.'browse/reason.html?class=C', 'Cancel reasons explain why a service was cancelled.' ],
 556   'Cancel reason types' => [ $fsurl.'browse/reason_type.html?class=C', 'Cancel reason types define groups of reasons.' ],
 557   'Suspend reasons' => [ $fsurl.'browse/reason.html?class=S', 'Suspend reasons explain why a service was suspended.' ],
 558   'Suspend reason types' => [ $fsurl.'browse/reason_type.html?class=S', 'Suspend reason types define groups of reasons.' ],
 559 ;
 560
 561 tie my %config_pkg, 'Tie::IxHash', ();
 562 $config_pkg{'Package definitions'} = [ $fsurl.'browse/part_pkg.cgi', 'One or more services are grouped together into a package and given pricing information. Customers purchase packages, not services' ]
 563   if    $curuser->access_right('Edit package definitions')
 564      || $curuser->access_right('Edit global package definitions');
 565 if ( $curuser->access_right('Configuration') ) {
 566
 567   #package grouping sub-menu?
 568   $config_pkg{'Package classes'} =  [ $fsurl.'browse/pkg_class.html', 'Package classes define groups of packages, for taxation, ordering convenience and reporting.' ];
 569   $config_pkg{'Package categories'} =  [ $fsurl.'browse/pkg_category.html', 'Package categories define groups of package classes, for invoice sections.' ];
 570   $config_pkg{'Package report classes'} =  [ $fsurl.'browse/part_pkg_report_option.html', 'Package classes define optional groups of packages for reporting only.' ];
 571   #eo package grouping sub-menu
 572
 573   $config_pkg{'Discounts'} = [ $fsurl.'browse/discount.html', '' ];
 574   $config_pkg{'Discount classes'} = [ $fsurl.'browse/discount_class.html', '' ];
 575   $config_pkg{'Cancel/Suspend Reasons'} = [ \%config_pkg_reason, '' ];
 576 }
 577
 578 tie my %config_cust, 'Tie::IxHash',
 579   'Customer tags'       => [ $fsurl.'browse/part_tag.html', '' ],
 580   'Customer classes'    =>  [ $fsurl.'browse/cust_class.html', 'Customer classes define groups of customers for reporting.' ],
 581   'Customer categories' =>  [ $fsurl.'browse/cust_category.html', 'Customer categories define groups of customer classes.' ],
 582   'separator'     => '', #its a separator!
 583   'Contact types'    =>  [ $fsurl.'browse/contact_class.html', ''], #XXX useful description
 584 ;
 585
 586 $config_cust{'Note classes'} = [ $fsurl.'browse/cust_note_class.html', 'Note classes define groups of customer notes for reporting.' ]
 587     if ($conf->exists('note-classes') && $conf->config('note-classes') > 0);
 588
 589 tie my %config_agent, 'Tie::IxHash',
 590   'Agent types' => [ $fsurl.'browse/agent_type.cgi', 'Agent types define groups of package definitions that you can then assign to particular agents' ],
 591   'Agents'      => [ $fsurl.'browse/agent.cgi', 'Agents are resellers of your service. Agents may be limited to a subset of your full offerings (via their type)' ],
 592   'Agent payment gateways'         => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors for agent overrides' ];
 593 ;
 594
 595 tie my %config_sales, 'Tie::IxHash',
 596   'Sales People' => [ $fsurl.'browse/sales.html', 'Sales people bring in new business.' ],
 597 ;
 598
 599 tie my %config_billing_rates, 'Tie::IxHash',
 600   'Rate plans' => [ $fsurl.'browse/rate.cgi', 'Manage rate plans' ],
 601   'Regions and prefixes' => [ $fsurl.'browse/rate_region.html', 'Manage regions and prefixes' ],
 602   'Usage classes'  => [ $fsurl.'browse/usage_class.html', 'Usage classes define groups of usage for taxation.' ],
 603   'Time periods' => [ $fsurl.'browse/rate_time.html', 'Time periods define days and hours for rate plans' ],
 604   'Edit rates with Excel' => [ $fsurl.'misc/rate_edit_excel.html', 'Download and edit rates with Excel, then upload changes.' ], #"Edit with Excel" ?
 605   'separator'     => '', #its a separator!
 606   'Tiering plans' => [ $fsurl.'browse/rate_tier.html', 'Rating tiers' ],
 607 ;
 608
 609 tie my %config_billing, 'Tie::IxHash';
 610 #  'Payment gateways'         => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors' ];
 611 $config_billing{'Billing events'} = [ $fsurl.'browse/part_event.html', 'Billing actions for customers, invoices and packages' ]
 612     if $curuser->access_right('Edit billing events')
 613     || $curuser->access_right('Edit global billing events');
 614 if ( $curuser->access_right('Configuration') ) {
 615   #$config_billing{'Invoice events'}         = [ $fsurl.'browse/part_bill_event.cgi', 'Deprecated, old-style actions for overdue invoices' ];
 616   $config_billing{'Invoice configurations'}      = [ $fsurl.'browse/invoice_conf.html', 'Adjust invoice settings for special-purpose notices' ];
 617   $config_billing{'Invoice templates'}      = [ $fsurl.'browse/invoice_template.html', 'Edit templates for HTML, plaintext and typeset invoices' ];
 618   $config_billing{'Prepaid cards'}          = [ $fsurl.'search/prepay_credit.html', 'View outstanding cards, generate new cards' ];
 619   $config_billing{'Call rates and regions'} = [ \%config_billing_rates, 'Manage rate plans, regions and prefixes for VoIP and call billing' ];
 620
 621   my $config_taxes_name = 'Locales and tax rates'.
 622                           ( $conf->exists('enable_taxproducts')
 623                             ? ' (internal tax class system)'
 624                             : ''
 625                           );
 626   $config_billing{$config_taxes_name}  = [ $fsurl.'browse/cust_main_county.cgi', 'Change tax rates, or break down a country into states, or a state into counties and assign different tax rates to each' ];
 627   $config_billing{'Tax rates (vendor data tax products system)'}  = [ $fsurl.'browse/tax_rate.cgi', 'Edit tax rates for the vendor data tax products system' ]
 628      if $conf->exists('enable_taxproducts');
 629   $config_billing{'Tax classes'} = [ $fsurl. 'browse/part_pkg_taxclass.html', 'Tax classes' ];
 630
 631   $config_billing{'Credit reasons'}  = [ $fsurl.'browse/reason.html?class=R', 'Credit reasons explain why a credit was issued.' ];
 632   $config_billing{'Credit reason types'}  = [ $fsurl.'browse/reason_type.html?class=R', 'Credit reason types define groups of reasons.' ];
 633 }
 634
 635 #XXX also to be unified
 636 tie my %config_ticketing_groups, 'Tie::IxHash',
 637   'Select' => [ $fsurl.'rt/Admin/Groups', '' ],
 638   'Create' => [ $fsurl.'rt/Admin/Groups/Modify.html?Create=1', '' ],
 639 ;
 640
 641 tie my %config_ticketing_queues, 'Tie::IxHash',
 642   'Select' => [ $fsurl.'rt/Admin/Queues', '' ],
 643   'Create' => [ $fsurl.'rt/Admin/Queues/Modify.html?Create=1', '' ],
 644 ;
 645
 646 tie my %config_ticketing_customfields, 'Tie::IxHash',
 647   'Select' => [ $fsurl.'rt/Admin/CustomFields', '' ],
 648   'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1', '' ],
 649 ;
 650
 651 tie my %config_ticketing_articles_classes, 'Tie::IxHash',
 652   'Select' => [ $fsurl.'rt/Admin/Articles/Classes/', '' ],
 653   'Create' => [ $fsurl.'rt/Admin/Articles/Classes/Modify.html?Create=1', '' ],
 654 ;
 655
 656 tie my %config_ticketing_articles_customfields, 'Tie::IxHash',
 657   'Select' => [ $fsurl.'rt/Admin/CustomFields/index.html?type=RT%3A%3AClass-RT%3A%3AArticle', '' ],
 658   'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1&LookupType=RT%3A%3AClass-RT%3A%3AArticle', '' ],
 659 ;
 660
 661 tie my %config_ticketing_articles, 'Tie::IxHash',
 662   'Classes'       => [ \%config_ticketing_articles_classes, '' ],
 663   'Custom Fields' => [ \%config_ticketing_articles_customfields, '' ],
 664 ;
 665
 666 tie my %config_ticketing, 'Tie::IxHash',
 667   'Ticketing Users'      => [ $fsurl.'rt/Admin/Users', 'Edit ticketing users' ], #XXX to be unified
 668   'Ticketing Groups'     => [ \%config_ticketing_groups, 'View/Edit ticketing groups and group membership' ], #XXX to be unified
 669   'Ticketing Queues'     => [ \%config_ticketing_queues, 'View/Edit ticketing queues and queue-specific properties' ],
 670   'Ticket Custom Fields' => [ \%config_ticketing_customfields, 'View/Edit ticketing custom fields' ],
 671   'Ticketing Global'     => [ $fsurl.'rt/Admin/Global', 'View/Edit ticketing configuration applicable to all queues' ], #XXX the individual items
 672   'Ticketing Articles'   => [ \%config_ticketing_articles, '' ],
 673   #"System Configuraiton"?  useless, just makes people report errors about missing Module::Versions::Report #'Ticketing Tools'     => [ $fsurl.'rt/Admin/Tools', '' ],
 674 ;
 675
 676 tie my %config_nms, 'Tie::IxHash',
 677   'View/Edit virtual ports' => [ $fsurl.'browse/torrus_srvderive.html', '' ],
 678 ;
 679
 680 tie my %config_misc, 'Tie::IxHash';
 681 $config_misc{'Message templates'} = [ $fsurl.'browse/msg_template.html', 'Templates for customer notices' ]
 682   if $curuser->access_right(['View templates', 'View global templates',
 683                              'Edit templates', 'Edit global templates', ]);
 684 $config_misc{'Advertising sources'} = [ $fsurl.'browse/part_referral.html', 'Where a customer heard about your service.' ]
 685   if $curuser->access_right('Edit advertising sources')
 686   || $curuser->access_right('Edit global advertising sources');
 687 if ( $curuser->access_right('Configuration') ) {
 688   $config_misc{'Custom fields'} = [ $fsurl.'browse/part_virtual_field.html', 'Locally defined fields', ];
 689   $config_misc{'Translation strings'} = [ $fsurl.'browse/msgcat.html', 'Translations and other customizable labels for each locale' ];
 690 }
 691 $config_misc{'Inventory classes and inventory'} = [ $fsurl.'browse/inventory_class.html', 'Setup inventory classes and stock inventory' ]
 692   if $curuser->access_right('Edit inventory')
 693   || $curuser->access_right('Edit global inventory')
 694   || $curuser->access_right('Configuration');
 695
 696 $config_misc{'Upload targets'} = [ $fsurl.'browse/upload_target.html', 'Billing and payment upload destinations' ]
 697   if $curuser->access_right('Configuration');
 698
 699 tie my %config_menu, 'Tie::IxHash';
 700 if ( $curuser->access_right('Configuration' ) ) {
 701   %config_menu = (
 702     'Settings'      => [ $fsurl.'config/config-view.cgi', '' ],
 703     'separator'     => '', #its a separator!
 704     'Companies'     => [ \%config_agent, '' ],
 705   );
 706 }
 707
 708 $config_menu{'Sales People'}  = [ \%config_sales, '' ]
 709   if $curuser->access_right('Edit sales people');
 710
 711 if ( $curuser->access_right('Configuration' ) ) {
 712   $config_menu{'Employees'}  = [ \%config_employees, '' ];
 713   $config_menu{'separator2'} = ''; #its a separator!
 714   $config_menu{'Customers'}  = [ \%config_cust, '' ];
 715     #or this? 'Customers and Contacts'
 716 }
 717
 718 $config_menu{'Packages'} = [ \%config_pkg, '' ]
 719   if    $curuser->access_right('Configuration' )
 720      || $curuser->access_right('Edit package definitions')
 721      || $curuser->access_right('Edit global package definitions');
 722
 723 if ( $curuser->access_right('Configuration' ) ) {
 724   $config_menu{'Services'} = [ \%config_export_svc, '' ];
 725   $config_menu{separator3} = '';
 726 }
 727
 728 $config_menu{'Billing'} = [ \%config_billing, '' ]
 729   if $curuser->access_right('Edit billing events')
 730   || $curuser->access_right('Edit global billing events');
 731 $config_menu{'Ticketing'} = [ \%config_ticketing, '' ]
 732   if $conf->config('ticket_system')
 733   && FS::TicketSystem->access_right(\%session, 'ShowConfigTab');
 734 $config_menu{'Network Monitoring'} = [ \%config_nms, '' ]
 735   if $curuser->access_right('Configure network monitoring')
 736   && $conf->config('network_monitoring_system') eq 'Torrus_Internal';
 737
 738 if ( $curuser->access_right([ 'Configuration',
 739                               'View templates',
 740                               'View global templates',
 741                               'Edit templates',
 742                               'Edit global templates',
 743                            ])
 744    ) {
 745   $config_menu{separator9} = '' if keys %config_menu;
 746   $config_menu{'Miscellaneous'} = [ \%config_misc, ''    ];
 747 }
 748
 749
 750 my $wiki = 'http://www.freeside.biz/mediawiki/index.php';
 751 my $doc_link = $conf->config('support-key')
 752                  ? "$wiki/Supported:Documentation"
 753                  : $curuser->access_right('Configuration')
 754                    ? "$wiki/Freeside:3:Documentation"
 755                    : "$wiki/Freeside:2.1:Documentation:User"; #no page for other versions yet :
 756
 757 eval "use RT;"
 758   if $conf->config('ticket_system') eq 'RT_Internal';
 759
 760 tie my %help_menu, 'Tie::IxHash';
 761 my $agentnum = $conf->config('brand-agent');
 762 if ( $agentnum ) {
 763   my $company_name = $conf->config('company_name', $agentnum);
 764   $help_menu{"About $company_name"} = [ "javascript:about_freeside()", '' ];
 765 } else {
 766   $help_menu{'Billing documentation'} = [ $doc_link, 'Freeside documentation' ];
 767   $help_menu{'Ticketing documentation'} = [ 'http://wiki.bestpractical.com/', 'Request Tracker Wiki' ]
 768     if $conf->config('ticket_system') eq 'RT_Internal';
 769   $help_menu{'Networking monitoring documentation'} = [ 'http://torrus.org/userguide.pod.html', 'Torrus User Guide' ]
 770     if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
 771   $help_menu{'separator'} = '';
 772   $help_menu{"About Freeside v$FS::VERSION"} = [ "javascript:about_freeside()", '' ];
 773   $help_menu{"About RT v$RT::VERSION"} = [ 'http://www.bestpractical.com/rt', 'Request Tracker Homepage' ]
 774     if $conf->config('ticket_system') eq 'RT_Internal';
 775   $help_menu{"About Torrus v1.0.9"} = [ 'http://www.torrus.org/', 'Torrus Homepage' ] #XXX manual version
 776     if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
 777 }
 778
 779
 780 tie my %menu, 'Tie::IxHash';
 781
 782 if ( $conf->config('menu-prepend_links')) {
 783   my @links = split(/\n/, $conf->config('menu-prepend_links'));
 784   foreach my $link (@links) {
 785     $link =~ /^\s*(\S+)\s+(.*?)(\s*\(([^\)]*)\))?$/ or next;
 786     my($url, $label, $alt) = ($1, $2, $4);
 787     $menu{$label} = [ $url, $alt ];
 788   }
 789 }
 790
 791 $menu{'Billing Main'} = [ $fsurl, 'Billing start page', ];
 792
 793 if ( $conf->config('ticket_system') ) {
 794   $menu{'Ticketing Main'} =
 795     [
 796       ( $conf->config('ticket_system') eq 'RT_External'
 797         ? FS::TicketSystem->baseurl()
 798         : $fsurl.'rt/'
 799       ),
 800       'Ticketing start page',
 801     ],
 802 }
 803
 804 if ( $conf->config('network_monitoring_system') eq 'Torrus_Internal' &&
 805   $curuser->access_right('Configure network monitoring') ) {
 806   $menu{'Network Main'} =
 807     [ $fsurl.'torrus/main', 'Network monitoring start page' ],
 808 }
 809
 810 $menu{'New prospect'} = [ $fsurl.'edit/prospect_main.html', 'Add a new prospect' ]
 811   if $curuser->access_right('New prospect');
 812 $menu{'New customer'} = [ $fsurl.'edit/cust_main.cgi', 'Add a new customer' ]
 813   if $curuser->access_right('New customer');
 814 $menu{'Reports'} = [ \%report_menu, 'Lists, reporting and graphing' ]
 815   if keys %report_menu;
 816 $menu{'Tools'} = [ \%tools_menu, 'Tools' ]
 817   if keys %tools_menu;
 818 $menu{'Configuration'} = [ \%config_menu, 'Configuration and setup' ]
 819   if $curuser->access_right([ 'Configuration',
 820                               'Edit package definitions',
 821                               'Edit global package definitions',
 822                               'Edit billing events',
 823                               'Edit global billing events',
 824                               'Dialup configuration',
 825                               'Wireless broadband configuration',
 826                               'Phone configuration',
 827                               'Alarm configuration',
 828                               'Alarm global configuration',
 829                               'Edit advertising sources',
 830                               'Edit global advertising sources',
 831                               'View templates',
 832                               'View global templates',
 833                               'Edit templates',
 834                               'Edit global templates',
 835                            ]);
 836 $menu{'Help'} = [ \%help_menu, '' ];
 837
 838
 839 use vars qw($gmenunum);
 840 $gmenunum = 0;
 841
 842 sub submenu {
 843   my($submenu, $title) = @_;
 844   my $menunum = $gmenunum++;
 845
 846   #return two args: html, menuname
 847
 848   "var myMenu$menunum = new WebFXMenu;\n".
 849   #"myMenu$menunum.useAutoPosition = true;\n".
 850 #  "myMenu$menunum.emptyText = '$title';\n".
 851   "myMenu$menunum.emptyText = '';\n".
 852
 853   (
 854     join("\n", map {
 855
 856       if ( !ref( $submenu->{$_} ) ) {
 857
 858         "myMenu$menunum.add(new WebFXMenuSeparator());";
 859
 860       } else {
 861
 862         my($url_or_submenu, $tooltip ) = @{ $submenu->{$_} };
 863         if ( ref($url_or_submenu) ) {
 864
 865           my($subhtml, $submenuname ) = submenu($url_or_submenu, $_); #mmm, recursion
 866
 867           "$subhtml\n".
 868           "myMenu$menunum.add(new WebFXMenuItem(\"$_\", null, \"$tooltip\", $submenuname ));";
 869
 870         } else {
 871
 872           "myMenu$menunum.add(new WebFXMenuItem(\"$_\", \"$url_or_submenu\", \"$tooltip\" ));";
 873
 874         }
 875
 876       }
 877
 878     } keys %$submenu )
 879   ). "\n".
 880   "myMenu$menunum.width = 256;\n",
 881
 882   "myMenu$menunum";
 883
 884 }
 885
 886 </%init>
 887