1 <script type="text/javascript" src="<%$fsurl%>elements/cssexpr.js"></script>
3 % if ( $opt{'position'} eq 'top' ) {
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">
8 % } else { # elsif ( $opt{'position'} eq 'left' ) {
10 <script type="text/javascript" src="<%$fsurl%>elements/xmenu.js"></script>
11 <link href="<%$fsurl%>elements/xmenu.css" type="text/css" rel="stylesheet">
15 % unless ( $opt{'nocss'} ) {
16 <link href="<%$fsurl%>elements/freeside.css?v=<% $FS::VERSION %>" type="text/css" rel="stylesheet">
17 <link href="<%$fsurl%>elements/freeside-print.css?v=<% $FS::VERSION %>" type="text/css" rel="stylesheet" media="print">
19 <link href="<%$fsurl%>elements/freeside-menu.css?v=<% $FS::VERSION %>" type="text/css" rel="stylesheet">
21 <SCRIPT TYPE="text/javascript">
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'),
30 % 'color' => '#7e0079',
31 % #'scrolling' => 'no',
33 % $fs_popup =~ s/return false;//;
34 function about_freeside() {
38 webfxMenuImagePath = "<%$fsurl%>images/";
39 webfxMenuUseHover = 1;
40 webfxMenuShowTime = 300;
41 webfxMenuHideTime = 500;
43 var myBar = new WebFXMenuBar;
47 % my( $subhtml, $submenuname ) = submenu(\%menu, 'Freeside');
49 myBar.add(new WebFXMenuButton("Freeside",
52 <% $submenuname |n %>));
55 % foreach my $item ( keys %menu ) {
57 % my( $url_or_submenu, $tooltip ) = @{ $menu{$item} };
59 % if ( ref($url_or_submenu) ) {
63 % my( $subhtml, $submenuname ) = submenu($url_or_submenu, $item);
66 myBar.add(new WebFXMenuButton(<% mt($item) |js_string %>, null, <% mt($tooltip) |js_string %>, <% $submenuname |n %> ));
70 myBar.add(new WebFXMenuButton(<% mt($item) |js_string %>, "<% $url_or_submenu %>", <% mt($tooltip) |js_string %> ));
76 myBar.show( null, 'vertical' );
83 my $conf = new FS::Conf;
84 my $fsurl = $opt{'freeside_baseurl'};
86 my $mobile = $opt{'mobile'} || 0;
88 my $curuser = $FS::CurrentUser::CurrentUser;
91 tie my %report_saved_searches, 'Tie::IxHash';
92 if ( my @searches = grep { $_->disabled eq '' } $curuser->saved_search ) {
93 foreach my $search (@searches) {
94 $report_saved_searches{ $search->searchname } = [
95 # don't use query_string here; we don't want to override the format
96 $fsurl . $search->path . '?' . $search->params , ''
99 $report_saved_searches{'separator'} = '';
100 $report_saved_searches{'My saved searches'} =
101 [ $fsurl. 'browse/saved_search.html',
102 'Manage saved searches and subscriptions' ];
105 #XXX Active tickets not assigned to a customer
107 tie my %report_prospects, 'Tie::IxHash';
108 if ( $curuser->access_right('List prospects') ) {
109 $report_prospects{'List prospects'} = [ $fsurl. 'search/prospect_main.html', '' ];
110 $report_prospects{'Advanced prospect reports'} = [ $fsurl. 'search/report_prospect_main.html', '' ];
112 $report_prospects{'separator'} = ''
113 if $curuser->access_right('List prospects')
114 && $curuser->access_right('List contacts');
115 $report_prospects{'Prospect contacts'} = [ $fsurl. 'search/report_contact.html?link=prospect_main', '' ]
116 if $curuser->access_right('List contacts');
118 tie my %report_quotations, 'Tie::IxHash',
119 'List quotations' => [ $fsurl. 'search/quotation.html', '' ],
120 'Advanced quotation reports' => [ $fsurl. 'search/report_quotation.html', '' ],
123 tie my %report_customers_lists, 'Tie::IxHash',
124 'by customer number' => [ $fsurl. 'search/cust_main.cgi?browse=custnum', '' ],
125 'by last name' => [ $fsurl. 'search/cust_main.cgi?browse=last', '' ],
126 'by company name' => [ $fsurl. 'search/cust_main.cgi?browse=company', '' ],
128 $report_customers_lists{'by active trouble tickets'} = [ $fsurl. 'search/cust_main.cgi?browse=tickets', '' ]
129 if $conf->config('ticket_system');
130 $report_customers_lists{'with USPS-unvalidated addresses'} = [ $fsurl. 'search/cust_main.cgi?browse=uspsunvalid', '' ]
131 if $conf->config('usps_webtools-userid') && $conf->config('usps_webtools-password');
132 $report_customers_lists{'with missing/outdated census tract'} = [ $fsurl. 'search/cust_main.html?no_censustract=1&ship_country=US', '' ]
133 ;#if $conf->config('cust_main-require_censustract');
134 $report_customers_lists{'with referrals'} = [ $fsurl. 'search/cust_main.html?with_referrals=1' ];
136 tie my %report_customers, 'Tie::IxHash';
137 $report_customers{'List customers'} = [ \%report_customers_lists, 'List customers' ]
138 if $curuser->access_right('List all customers');
139 $report_customers{'Zip code distribution'} = [ $fsurl. 'search/report_cust_main-zip.html', 'Zip codes by number of customers' ]
140 if $curuser->access_right('List zip codes');
141 $report_customers{'Customer signup report'} = [ $fsurl. 'graph/report_cust_signup.html', 'New customer signups by date' ]
142 if $curuser->access_right('Financial reports');
143 $report_customers{'Customer churn report'} = [ $fsurl.'graph/report_cust_churn.html', 'New customers, suspensions, and cancellations summary' ]
144 if $curuser->access_right('Customers: Customer churn report');
145 $report_customers{'Signup date report'} = [ $fsurl. 'graph/report_signupdate.html', 'Signup date report (by date of signup)' ];
146 $report_customers{'Advanced customer reports'} = [ $fsurl. 'search/report_cust_main.html', 'by status, signup date, agent, etc.' ]
147 if $curuser->access_right('Advanced customer search');
148 if ( $curuser->access_right('List contacts') ) {
149 $report_customers{'separator'} = '';
150 $report_customers{'Customer contacts'} = [ $fsurl. 'search/report_contact.html?link=cust_main' ];
151 $report_customers{'Customer stored payment information'} = [ $fsurl. 'search/report_cust_payby.html' ];
152 $report_customers{'Customer timespan'} = [ $fsurl. 'search/report_cust_timespan.html' ];
155 tie my %report_invoices_open, 'Tie::IxHash',
156 'All open invoices' => [ $fsurl.'search/cust_bill.html?OPEN_date', 'All invoices with an unpaid balance' ],
157 '15 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN15_date', 'Invoices 15 days or older with an unpaid balance' ],
158 '30 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN30_date', 'Invoices 30 days or older with an unpaid balance' ],
159 '60 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN60_date', 'Invoices 60 days or older with an unpaid balance' ],
160 '90 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN90_date', 'Invoices 90 days or older with an unpaid balance' ],
161 '120 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN120_date', 'Invoices 120 days or older with an unpaid balance' ],
164 tie my %report_invoices, 'Tie::IxHash',
165 'Open invoices' => [ \%report_invoices_open, 'Open invoices' ],
166 'All invoices' => [ $fsurl. 'search/cust_bill.html?date', 'List all invoices' ],
167 'Advanced invoice reports' => [ $fsurl.'search/report_cust_bill.html', 'by agent, date range, etc.' ],
169 'Line items' => [ $fsurl. 'search/report_cust_bill_pkg.html', 'Individual line item detail' ],
171 'Voided invoices' => [ $fsurl.'search/report_cust_bill_void.html', 'Search for voided invoices' ],
175 tie my %report_discounts, 'Tie::IxHash',
176 'Discount graph' => [ $fsurl. 'graph/report_cust_bill_pkg_discount.html', 'Discount overview per month' ],
177 'Discount detail' => [ $fsurl.'search/report_cust_bill_pkg_discount.html', 'Discount report (by employee and/or date range)' ],
179 'Package discounts' => [ $fsurl.'search/report_cust_pkg_discount.html', 'Active/inactive discounts by package' ],
182 tie my %report_services, 'Tie::IxHash';
183 if ( $curuser->access_right('Configuration') ) {
184 $report_services{'Service definitions'} = [ $fsurl.'browse/part_svc.cgi?orderby=active', 'Service definitions by number of active packages' ];
185 $report_services{'separator'} = '';
188 if ( $curuser->access_right('List services') ) {
189 $report_services{'Unprovisioned services'} = [ $fsurl.'search/report_unprovisioned_services.html', 'Unprovisioned services' ];
190 $report_services{'separator2'} = '';
193 foreach my $svcdb ( FS::part_svc->svc_tables() ) {
195 my $name = "FS::$svcdb"->table_info->{'name_plural'}
196 || PL( "FS::$svcdb"->table_info->{'name'} );
197 my $lcname = "FS::$svcdb"->table_info->{'lcname_plural'} || lc($name);
198 my $lcsname = lc("FS::$svcdb"->table_info->{'name'});
199 my $longname = "FS::$svcdb"->table_info->{'longname_plural'} || $name;
200 my $lclongname = lc($longname);
201 my $sorts = "FS::$svcdb"->table_info->{'sorts'} || [ 'svcnum' ];
202 $sorts = [ $sorts ] unless ref($sorts);
203 my %svc_url = ( 'm' => $m,
204 'action' => 'search',
208 tie my %report_svc, 'Tie::IxHash';
210 foreach my $sort ( @$sorts ) {
212 my $field_info = FS::part_svc->svc_table_fields($svcdb)->{$sort};
213 my $label = $field_info->{'label_sort'} || 'by '.$field_info->{'label'};
215 my $title = "All $lcname";
217 if scalar(@$sorts) > 1;
219 $report_svc{$title} =
220 [ svc_url( %svc_url, 'query' => "magic=all;sortby=$sort" ),
225 if ( $svcdb eq 'svc_acct' ) {
227 $report_svc{"All $lcname never logged in"} =
228 [ svc_url( %svc_url, 'query' => "magic=nologin;sortby=svcnum" ),
232 } elsif ( $svcdb eq 'svc_phone' ) {
234 $report_svc{"${name}' total usage by time period"} =
235 [ $fsurl. 'search/report_svc_phone_usage.html',
236 'Total usage (minutes, and amount billed) for the specified time period, per phone number.',
238 $report_svc{"${name} by state"} =
239 [ $fsurl. 'search/phone_state.html',
240 'Current or historical phone services broken down by state.',
245 if ( $curuser->access_right('View/link unlinked services') ) {
246 $report_svc{"Unlinked $lcname"} =
247 [ svc_url( %svc_url, 'query' => "magic=unlinked;sortby=". $sorts->[0] ),
248 "Pre-Freeside $lcname without a customer record",
252 if ( $curuser->access_right("Services: $name: Advanced search")
253 && $svcdb =~ /^svc_(acct|broadband|hardware|phone|fiber)$/ ) {
255 $report_svc{"Advanced $lcsname reports"} =
256 [ $fsurl."search/report_$svcdb.html", '' ]
259 if ( $svcdb eq 'svc_phone' ) {
261 $report_svc{"Phone number (DID) availability"} =
262 [ $fsurl."search/report_phone_avail.html", '' ];
263 $report_svc{"Inventory/Provisioning Status"} =
264 [ $fsurl."search/phone_inventory_provisioned.html", '' ];
266 } elsif ( $svcdb eq 'svc_dsl' ) {
268 $report_svc{'Qualifications'} = [ $fsurl. 'search/qual.cgi', #XXX qual.html
274 $report_services{$name} = [ \%report_svc, $longname ]
275 if $curuser->access_right("Services: $name");
279 ## adding export test reports
280 tie my %report_exports, 'Tie::IxHash';
281 my $exports = FS::part_export::export_info();
283 tie my %export_list, 'Tie::IxHash',
285 map { $_ => "$_ - ". $exports->{$_}{desc} }
290 foreach my $export (keys %export_list) {
291 $report_exports{"$export export test"} =
292 [ $fsurl. 'search/report_svc_export_test.cgi?export='.$export,
293 "Report of invalid service setup for services tied to $export export",
294 ] if "FS::part_export::$export"->can('test_export_report');
296 $report_services{'exports'} = [ \%report_exports, "Exports" ];
298 tie my %report_packages, 'Tie::IxHash';
299 $report_packages{'Package definitions (by # active)'} = [ $fsurl.'browse/part_pkg.cgi?active=1', 'Package definitions by number of active packages' ]
300 if $curuser->access_right('Edit package definitions')
301 || $curuser->access_right('Edit global package definitions');
302 $report_packages{'Package costs'} = [ $fsurl.'graph/report_cust_pkg_cost.html', 'Package setup and recurring costs graph' ]
303 if $curuser->access_right('Financial reports');
304 $report_packages{'separator'} = ''
305 if keys %report_packages;
306 if ( $curuser->access_right('Financial reports') ) {
307 $report_packages{'Package churn'} = [ $fsurl.'graph/report_cust_pkg.html', 'Orders, suspensions and cancellations summary graph' ];
308 $report_packages{'separator2'} = '';
310 $report_packages{'All customer packages'} = [ $fsurl.'search/cust_pkg.cgi?pkgnum', 'List all customer packages', ];
311 $report_packages{'Package summary'} = [ $fsurl.'search/cust_pkg_summary.html', 'Show package sales summary', ]
312 if $curuser->access_right('Summarize packages');
313 $report_packages{'Suspended customer packages'} = [ $fsurl.'search/cust_pkg.cgi?magic=suspended', 'List suspended packages' ];
314 $report_packages{'Suspension summary'} = [ $fsurl.'search/cust_pkg_susp.html', 'Show suspension activity', ]
315 if $curuser->access_right('Summarize packages');
316 $report_packages{'Customer packages with unconfigured services'} = [ $fsurl.'search/cust_pkg.cgi?APKG_pkgnum', 'List packages which have provisionable services' ];
317 $report_packages{'FCC Form 477'} = [ $fsurl.'search/report_477.html' ]
318 if $conf->exists('part_pkg-show_fcc_options');
319 $report_packages{'Contract end dates'} = [ $fsurl.'search/report_cust_pkg-date.html?date=contract_end', 'Show packages by contract end date' ];
320 $report_packages{'Advanced package reports'} = [ $fsurl.'search/report_cust_pkg.html', 'by agent, date range, status, package definition' ];
322 tie my %report_inventory, 'Tie::IxHash',
323 'Inventory by agent' => [ $fsurl.'search/report_agent_inventory.html', '' ],
324 'Inventory activity' => [ $fsurl.'search/report_h_inventory_item.html', '' ],
327 tie my %report_rating, 'Tie::IxHash';
328 $report_rating{'RADIUS sessions'} = [ $fsurl.'search/sqlradius.html', '' ]
329 if $curuser->access_right("Usage: RADIUS sessions");
330 $report_rating{'RADIUS data usage'} = [ $fsurl.'search/report_sqlradius_usage.html', '' ]
331 if $curuser->access_right("Usage: RADIUS sessions");
332 $report_rating{'Call Detail Records (CDRs)'} = [ $fsurl.'search/report_cdr.html', '' ]
333 if $curuser->access_right("Usage: Call Detail Records (CDRs)");
334 $report_rating{'Unrateable CDRs'} = [ $fsurl.'search/cdr.html?freesidestatus=failed;cdrbatchnum=_ALL_' ]
335 if $curuser->access_right("Usage: Unrateable CDRs");
336 $report_rating{'Customer CDRs Profit/Loss'} = [ $fsurl.'search/report_customer_cdr_profit.html', 'Profit/loss from customer CDRs' ]
337 if $curuser->access_right('Financial reports');
338 if ( $curuser->access_right("Usage: Time worked") ) {
339 $report_rating{'Time worked'} = [ $fsurl.'search/report_rt_transaction.html', '' ];
340 $report_rating{'Time worked summary per ticket'} = [ $fsurl.'search/report_rt_ticket.html', '' ];
341 $report_rating{'Time worked summary per customer'} = [ $fsurl.'search/report_rt_cust.html', '' ];
344 tie my %report_ticketing_statistics, 'Tie::IxHash',
345 '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' ],
346 'Ticket status by Queue' => [ $fsurl.'rt/RTx/Statistics/OpenStalled', 'View numbers of new, open and stalled tickets in a selected Queue' ],
347 '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' ],
348 'Tickets per Day of Week' => [ $fsurl.'rt/RTx/Statistics/DayOfWeek', 'View trends showing when tickets are created, resolved or deleted' ],
349 'Time to resolve' => [ $fsurl.'rt/RTx/Statistics/Resolution', 'View how long tickets take to be resolved by Queue' ],
350 'Time to resolve (scatter graph)' => [ $fsurl.'rt/RTx/Statistics/TimeToResolve', 'View a detailed scatter graph of time to resolve tickets by Queue' ],
353 tie my %report_ticketing, 'Tie::IxHash',
354 # fix TimeToResolve extension? or redo in a more modern way?
355 # 'Resolved by owner' => [ $fsurl.'rt/Tools/Reports/ResolvedByOwner.html', '' ],
356 # 'Resolved in date range' => [ $fsurl.'rt/Tools/Reports/ResolvedByDates.html', '' ],
357 # 'Created in date range' => [ $fsurl.'rt/Tools/Reports/CreatedByDates.html', '' ],
359 'Statistics' => [ \%report_ticketing_statistics, '' ],
361 'Advanced ticket reports' => [ $fsurl.'rt/Search/Build.html?NewQuery=1', 'List tickets by any criteria' ],
364 tie my %report_bill_event, 'Tie::IxHash',
365 'Billing event errors' => [ $fsurl.'search/report_cust_event.html?failed=1', 'Failed credit cards, processor or printer problems, etc.' ],
368 tie my %report_payments, 'Tie::IxHash';
369 $report_payments{'Payments'} = [ $fsurl.'search/report_cust_pay.html', 'Payment report (by type and/or date range)' ]
370 if $curuser->access_right('Basic payment and refund reports');
371 $report_payments{'Payment application detail'} = [ $fsurl.'search/report_cust_bill_pay_pkg.html', 'Line item application detail' ]
372 if $curuser->access_right('Financial reports');
373 $report_payments{'Pending Payments'} = [ $fsurl.'search/cust_pay_pending.html?magic=_date;statusNOT=done', 'Pending real-time payments' ]
374 if $curuser->access_right('View customer pending payments');
375 $report_payments{'Unapplied Payments'} = [ $fsurl.'search/report_cust_pay.html?unapplied=1', 'Unapplied payment report (by type and/or date range)' ]
376 if $curuser->access_right('Financial reports'); #not enforced
377 $report_payments{'Voided Payments'} = [ $fsurl.'search/report_cust_pay.html?void=1', 'Voided payment report (by type and/or date range)' ]
378 if $curuser->access_right('Financial reports'); #not enforced
379 $report_payments{'Payment Batches'} = [ $fsurl.'search/pay_batch.html', 'Payment batches (by status and/or date range)' ]
380 if ( $conf->exists('batch-enable') || $conf->config('batch-enable_payby') )
381 && $curuser->access_right('Financial reports');
382 $report_payments{'Unapplied Payment Aging'} = [ $fsurl.'search/report_unapplied_cust_pay.html', 'Unapplied payment aging report' ]
383 if $curuser->access_right('Financial reports');
384 $report_payments{'Deleted Payments / Payment history table'} = [ $fsurl.'search/report_h_cust_pay.html', 'Deleted payments / payment history table' ]
385 if $conf->exists('payment-history-report')
386 && $curuser->access_right('Financial reports');
388 tie my %report_credits, 'Tie::IxHash',
389 'Credit Report' => [ $fsurl.'search/report_cust_credit.html', 'Credit report (by employee and/or date range)' ],
390 'Credit package source detail' => [ $fsurl.'search/report_cust_credit_source_bill_pkg.html', 'Line-item detail for triggered package credits' ],
391 'Credit application detail' => [ $fsurl.'search/report_cust_credit_bill_pkg.html', 'Line item application detail' ],
392 'Unapplied Credits' => [ $fsurl.'search/report_cust_credit.html?unapplied=1', 'Unapplied credit report (by type and/or date range)' ],
393 'Voided Credits' => [ $fsurl.'search/report_cust_credit_void.html', 'Voided credit report (by employee and/or date range)' ],
396 tie my %report_refunds, 'Tie::IxHash',
397 'Refund Report' => [ $fsurl.'search/report_cust_refund.html', 'Refund report (by type and/or date range)' ],
398 'Unapplied Refunds' => [ $fsurl.'search/report_cust_refund.html?unapplied=1', 'Unapplied refund report (by type and/or date range)' ],
401 tie my %report_sales, 'Tie::IxHash',
402 'Sales, Credits and Receipts' => [ $fsurl.'graph/report_money_time.html', 'Sales, credits and receipts summary graph' ],
403 'Daily Sales, Credits and Receipts' => [ $fsurl.'graph/report_money_time_daily.html', 'Sales, credits and receipts (broken down by day) summary graph' ],
404 'Sales Report' => [ $fsurl.'graph/report_cust_bill_pkg.html', 'Sales report and graph (by agent, package class and/or date range)' ],
405 '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)' ],
406 'Sales with Advertising Source' => [ $fsurl.'search/report_cust_bill_pkg_referral.html' ],
409 tie my %report_commissions, 'Tie::IxHash',
410 'Agent' => [ $fsurl.'search/report_agent_commission.html' ],
411 'Agent per package' => [ $fsurl.'search/report_agent_commission_pkg.html' ],
412 'Sales Person' => [ $fsurl.'search/report_sales_commission.html' ],
413 'Sales Person per package' => [ $fsurl.'search/report_sales_commission_pkg.html' ],
414 'Employee' => [ $fsurl.'search/report_employee_commission.html', '' ],
415 'Agent Credits and Payments' => [ $fsurl.'search/report_agent_credit_payment.html' ],
418 tie my %report_financial, 'Tie::IxHash';
419 if( $curuser->access_right('Financial reports') ) {
421 %report_financial = (
422 'Sales' => [ \%report_sales, 'Sales reports', ],
423 'Commissions' => [ \%report_commissions, 'Commission reports', ],
424 'Credits' => [ \%report_credits, 'Credit reports', ],
425 'Refunds' => [ \%report_refunds, 'Refund reports', ],
427 $report_financial{'A/R Aging'} = [ $fsurl.'search/report_receivables.html', 'Accounts Receivable Aging report' ];
428 $report_financial{'Prepaid Income'} = [ $fsurl.'search/report_prepaid_income.html', 'Prepaid income (unearned revenue) report' ];
430 my $taxproducts = $conf->config('tax_data_vendor');
431 $report_financial{'Tax Liability'. ($taxproducts ? ' (internal tax data)' : '')} = [ $fsurl.'search/report_tax.html', 'Tax liability report (internal tax data)' ];
432 $report_financial{'Tax Liability (vendor tax data)'} = [ $fsurl.'search/report_newtax.html', 'Tax liability report (vendor tax data)' ]
435 $report_financial{'Monthly Sales and Taxes'} = [$fsurl.'search/tax_sales.html', 'Monthly sales and taxes report'];
437 # most sites don't need this but there isn't really a config to enable it
438 $report_financial{'E911 Fee Summary'} = [ $fsurl.'search/report_e911.html', 'E911 fee summary' ];
440 $report_financial{'Customer Accounting Summary'} = [ $fsurl.'search/report_customer_accounting_summary.html', 'Customer accounting summary report' ];
442 if ( my $report_title = FS::cust_payby->future_autobill_report_title ) {
443 $report_financial{$report_title} = [ $fsurl.'search/report_future_autobill.html', "$report_title for customers with automatic payment methods (by date)" ];
446 } elsif($curuser->access_right('Receivables report')) {
448 $report_financial{'A/R Aging'} = [ $fsurl.'search/report_receivables.html', 'Accounts Receivable Aging report' ];
450 } # else $report_financial contains nothing.
452 tie my %report_payable, 'Tie::IxHash',
453 'Payables summary' => [ $fsurl. 'search/report_vend_main.html', 'Payables summary by vendor' ],
454 'Payables detail' => [ $fsurl. 'search/report_vend_bill.html' ],
457 tie my %report_logs, 'Tie::IxHash';
458 $report_logs{'Billing events'} = [ $fsurl.'search/report_cust_event.html', 'Search billing events by date and status' ]
459 if $curuser->access_right('Billing event reports');
460 $report_logs{'Billing event fees'} = [ $fsurl.'search/report_cust_event_fee.html', 'Search fees triggered by billing events' ]
461 if $curuser->access_right('Billing event reports');
462 $report_logs{'Credit limit incidents'} = [ $fsurl.'search/report_cust_main_credit_limit.html', '' ]
463 if $curuser->access_right('List rating data');
464 $report_logs{'Employee activity'} = [ $fsurl.'search/report_employee_audit.html', '' ]
465 if $curuser->access_right('Employees: Audit Report');
466 $report_logs{'System log'} = [ $fsurl.'search/log.html', 'View system events and debugging information.' ],
467 if $curuser->access_right('View system logs')
468 || $curuser->access_right('Configuration');
469 $report_logs{'Outgoing messages'} = [ $fsurl.'search/cust_msg.html', 'View outgoing message log' ]
470 if $curuser->access_right('View email logs')
471 || $curuser->access_right('Configuration');
473 tie my %report_menu, 'Tie::IxHash';
474 $report_menu{'Saved searches'} = [ \%report_saved_searches, 'My saved searches' ]
475 if keys(%report_saved_searches);
476 $report_menu{'Prospects'} = [ \%report_prospects, 'Prospect reports' ]
477 if $curuser->access_right('List prospects')
478 || $curuser->access_right('List contacts');
479 $report_menu{'Quotations'} = [ \%report_quotations, 'Quotation reports' ]
480 if $curuser->access_right('List quotations');
481 $report_menu{'Customers'} = [ \%report_customers, 'Customer reports' ]
482 if $curuser->access_right('List customers')
483 || $curuser->access_right('List contacts')
484 || $curuser->access_right('Advanced customer search')
485 || $curuser->access_right('List zip codes')
486 || $curuser->access_right('Financial reports')
487 || $curuser->access_right('Customers: Customer churn report');
488 $report_menu{'Invoices'} = [ \%report_invoices, 'Invoice reports' ]
489 if $curuser->access_right('List invoices');
490 $report_menu{'Discounts'} = [ \%report_discounts, 'Discount reports' ]
491 if $curuser->access_right('Financial reports');
492 $report_menu{'Payments'} = [ \%report_payments, 'Payment reports' ]
493 if keys %report_payments;
494 $report_menu{'Packages'} = [ \%report_packages, 'Package reports' ]
495 if $curuser->access_right('List packages');
496 $report_menu{'Services'} = [ \%report_services, 'Services reports' ]
497 if $curuser->access_right('List services');
498 $report_menu{'Inventory'} = [ \%report_inventory, 'Inventory reports' ]
499 if $curuser->access_right('Configuration'); #XXX List inventory?
500 $report_menu{'Usage'} = [ \%report_rating, 'Usage reports' ]
501 if $curuser->access_right('List rating data');
502 $report_menu{'Tickets'} = [ \%report_ticketing, 'Ticket reports' ]
503 if $conf->config('ticket_system')
504 ;#&& FS::TicketSystem->access_right(\%session, 'Something');
505 $report_menu{'Financial (Receivables)'} = [ \%report_financial, 'Financial reports (Receivables)' ]
506 if $curuser->access_right('Financial reports')
507 or $curuser->access_right('Receivables report');
508 $report_menu{'Financial (Payables)'} = [ \%report_payable, 'Financial reports (Payables)' ]
509 if $curuser->access_right('Financial reports');
511 $report_menu{'Logs'} = [ \%report_logs, 'System and email logs' ]
512 if (keys %report_logs); # empty if the user has no rights to it
513 $report_menu{'SQL Query'} = [ $fsurl.'search/report_sql.html', 'SQL Query']
514 if $curuser->access_right('Raw SQL');
516 tie my %tools_customers, 'Tie::IxHash', ();
517 $tools_customers{'Appointments'} = [ $fsurl.'rt/Search/Schedule.html?LengthMin=0', 'View appointment schedule' ]
518 if $curuser->access_right('View appointments');
519 $tools_customers{'Attachments'} = [ $fsurl.'search/report_cust_attachment.html', 'View customer attachments' ]
520 if !$conf->config('disable_cust_attachment') and $curuser->access_right('View attachments') and $curuser->access_right('Browse attachments');
521 $tools_customers{'Customer email settings'} = [ $fsurl.'misc/manage_cust_email.html' ]
522 if $curuser->access_right('Edit customer');
524 tie my %tools_billing, 'Tie::IxHash', ();
525 $tools_billing{'Quick payment entry'} = [ $fsurl.'misc/batch-cust_pay.html', 'Enter multiple payments in a batch' ]
526 if $curuser->access_right('Post payment batch');
527 $tools_billing{'Process payment batches'} = [ $fsurl.'search/pay_batch.cgi?magic=_date;open=1;intransit=1', 'Process credit card and electronic check batches' ]
528 if ( $conf->exists('batch-enable') || $conf->config('batch-enable_payby') )
529 && $curuser->access_right('Process batches');
530 $tools_billing{'Download invoice batches'} = [ $fsurl.'search/bill_batch.cgi' ]
531 if $curuser->access_right('Process invoice batches')
532 || $curuser->access_right('Process global invoice batches')
533 || $curuser->access_right('Configuration'); #XXX remove in 2.5
534 #now there's a standalone event#if $conf->exists('invoice_print_pdf');
536 tie my %tools_importing, 'Tie::IxHash',
537 'Customers' => [ $fsurl.'misc/cust_main-import.cgi', '' ],
538 'Package definitions' => [ $fsurl.'misc/part_pkg-import.html', '' ],
539 'Customer packages' => [ $fsurl.'misc/cust_pkg-import.html', '' ],
540 # 'Customer broadband services' => [ $fsurl.'misc/svc_broadband-import.html', '' ],
541 'Customer notes' => [ $fsurl.'misc/cust_main_note-import.html', '' ],
542 'Customer contacts' => [ $fsurl.'misc/contact-import.cgi', '' ],
543 'One-time charges' => [ $fsurl.'misc/cust_main-import_charges.cgi', '' ],
544 'Payments' => [ $fsurl.'misc/cust_pay-import.cgi', '' ],
545 'Credits' => [ $fsurl.'misc/cust_credit-import.html', '' ],
546 'Phone numbers (DIDs)' => [ $fsurl.'misc/phone_avail-import.html', '' ],
547 'Call Detail Records (CDRs)' => [ $fsurl.'misc/cdr-import.html', '' ],
549 if ( $conf->config('tax_data_vendor') eq 'cch' ) {
550 if ( $conf->exists('taxdatadirectdownload') ) {
551 $tools_importing{'Tax rates from vendor site'} =
552 [ $fsurl.'misc/tax-fetch_and_import.cgi', '' ];
554 $tools_importing{'Tax rates from CSV files'} =
555 [ $fsurl.'misc/tax-import.cgi', '' ];
559 tie my %tools_misc, 'Tie::IxHash', ();
560 $tools_misc{'Bulk DID Orders'} = [ $fsurl.'browse/did_order.html', 'View/manage bulk DID orders' ]
561 if $curuser->access_right('Import');
562 $tools_misc{'Business card scan'} = [ $fsurl.'edit/prospect_main-upload.html' ]
563 if $curuser->access_right('New prospect');
564 $tools_misc{'Time Queue'} = [ $fsurl.'search/report_timeworked.html', 'View pending support time' ]
565 if $curuser->access_right('Time queue');
567 #tie my %tools_exporting, 'Tie::IxHash',
568 # 'Download database dump' => [ $fsurl. 'misc/dump.cgi', '' ],
571 tie my %tools_ticketing_articles, 'Tie::IxHash',
572 'Overview' => [ $fsurl.'rt/Articles/index.html', '' ],
573 'Search' => [ $fsurl.'rt/Articles/Article/Search.html', '' ],
574 'Topics' => [ $fsurl.'rt/Articles/Topics.html', '' ],
577 tie my %tools_ticketing, 'Tie::IxHash',
578 'Articles' => [ \%tools_ticketing_articles, '' ],
579 'My Day' => [ $fsurl.'rt/Tools/MyDay.html', '' ],
580 'My Reminders' => [ $fsurl.'rt/Tools/MyReminders.html', '' ],
581 'Offline' => [ $fsurl.'rt/Tools/Offline.html', '' ],
582 'Approval' => [ $fsurl.'rt/Approvals/', '' ],
584 $tools_ticketing{'Cron Tool'} = [ $fsurl.'rt/Developer/CronTool/', '' ]
585 if $conf->exists('rt-crontool');
587 tie my %tools_system, 'Tie::IxHash', ();
588 $tools_system{'Status'} = [ $fsurl.'view/Status.html', 'System status' ]
589 if $curuser->access_right('Configuration'); # 'View system status');
590 $tools_system{'Job Queue'} = [ $fsurl.'search/queue.html', 'View pending job queue' ]
591 if $curuser->access_right('Job queue');
592 $tools_system{'Access log statistics'} = [ $fsurl.'search/report_access_user_log.html?group_by=path', '' ]
593 if $curuser->access_right('Configuration'); # 'View profiling data');
595 tie my %tools_menu, 'Tie::IxHash', ();
596 $tools_menu{'Customers'} = [ \%tools_customers, 'Customer tools' ]
597 if keys %tools_customers;
598 $tools_menu{'Billing'} = [ \%tools_billing, 'Payment and invoice tools' ]
599 if keys %tools_billing;
600 $tools_menu{'Ticketing'} = [ \%tools_ticketing, 'Ticketing tools' ]
601 if $conf->config('ticket_system');
602 $tools_menu{'Miscellaneous'} = [ \%tools_misc, '' ]
604 $tools_menu{'Importing'} = [ \%tools_importing, 'Import tools' ]
605 if $curuser->access_right('Import');
606 #$tools_menu{'Exporting'} = [ \%tools_exporting, 'Export tools' ]
607 # if $curuser->access_right('Export');
608 $tools_menu{'System'} = [ \%tools_system, 'System tools' ]
611 tie my %config_employees, 'Tie::IxHash',
612 'Employees' => [ $fsurl.'browse/access_user.html', 'Setup internal users' ],
613 'Employee groups and access control' => [ $fsurl.'browse/access_group.html', 'Employee groups allow you to control access to the backend' ],
614 'Installer availability' => [ $fsurl.'browse/sched_item.html', 'Installer availability' ],
617 tie my %config_dialup, 'Tie::IxHash',
618 'Access numbers' => [ $fsurl.'browse/svc_acct_pop.cgi', 'Points of Presence' ],
621 tie my %config_broadband, 'Tie::IxHash',
622 'Towers' => [ $fsurl.'browse/tower.html', 'Towers and sectors' ],
623 'Routers' => [ $fsurl.'browse/router.cgi', 'Broadband access routers' ],
624 'Address blocks' => [ $fsurl.'browse/addr_block.cgi', 'Manage address blocks and block assignments to broadband routers' ],
626 if ( $curuser->access_right('Broadband global configuration') ) {
627 $config_broadband{'Address ranges'} =
628 [ $fsurl.'browse/addr_range.html', 'Designate special address ranges' ];
631 tie my %config_phone, 'Tie::IxHash',
632 'View/Edit phone device types' => [ $fsurl.'browse/part_device.html', 'Phone device types' ],
633 'View/Edit bulk DID vendors' => [ $fsurl.'browse/did_vendor.html', 'Bulk DID vendors' ],
634 'View/Edit Carriers' => [ $fsurl.'browse/cdr_carrier.html', 'Carriers' ],
637 tie my %config_radius, 'Tie::IxHash',
638 'RADIUS Groups' => [ $fsurl.'browse/radius_group.html', 'Manage RADIUS groups' ],
639 'RADIUS Clients' => [ $fsurl.'browse/nas.html', 'Manage RADIUS clients' ],
642 tie my %config_cable, 'Tie::IxHash',
643 'Cable providers' => [ $fsurl.'browse/cable_provider.html', '' ],
644 'Cable modem models' => [ $fsurl.'browse/cable_model.html', '' ],
647 tie my %config_alarm, 'Tie::IxHash',
648 'Alarm system vendors' => [ $fsurl.'browse/alarm_system.html', '' ],
649 'Alarm system types' => [ $fsurl.'browse/alarm_type.html', '' ],
650 'Alarm central stations' => [ $fsurl.'browse/alarm_station.html', '' ],
653 tie my %config_conferencing, 'Tie::IxHash',
654 'Conferencing types' => [ $fsurl.'browse/conferencing_type.html', '' ],
655 'Quality levels' => [ $fsurl.'browse/conferencing_quality.html', '' ],
658 tie my %config_circuit, 'Tie::IxHash',
659 'Circuit types' => [ $fsurl.'browse/circuit_type.html', '' ],
660 'Circuit providers' => [ $fsurl.'browse/circuit_provider.html', '' ],
661 'Termination types' => [ $fsurl.'browse/circuit_termination.html', '' ],
664 tie my %config_fiber, 'Tie::IxHash',
665 'OLTs' => [ $fsurl.'browse/fiber_olt.html', '' ],
668 tie my %config_export_svc, 'Tie::IxHash', ();
669 if ( $curuser->access_right('Configuration') ) {
670 $config_export_svc{'Service definitions'} = [ $fsurl.'browse/part_svc.cgi', 'Services are items you offer to your customers' ];
671 $config_export_svc{'Service classes'} = [ $fsurl.'browse/part_svc_class.html', 'Services classes are user-defined, informational types for services' ];
672 $config_export_svc{'Service dependencies'} = [ $fsurl.'browse/part_svc_link.html', 'Services depencies define rules between service definitions' ];
673 $config_export_svc{'Provisioning exports'} = [ $fsurl.'browse/part_export.cgi', 'Provisioning services to external machines, databases and APIs' ];
675 $config_export_svc{'Dialup'} = [ \%config_dialup, '' ]
676 if $curuser->access_right('Dialup configuration');
677 $config_export_svc{'Wireless broadband'} = [ \%config_broadband, '' ]
678 if $curuser->access_right('Broadband configuration');
679 $config_export_svc{'Phone'} = [ \%config_phone, '' ]
680 if $curuser->access_right('Configuration');
681 $config_export_svc{'RADIUS'} = [ \%config_radius, '' ]
682 if $curuser->access_right('Configuration');
683 $config_export_svc{'Cable'} = [ \%config_cable, '' ]
684 if $curuser->access_right('Configuration');
685 $config_export_svc{'Conferencing'} = [ \%config_conferencing, '' ]
686 if $curuser->access_right('Configuration');
687 $config_export_svc{'Alarm'} = [ \%config_alarm, '' ]
688 if $curuser->access_right(['Alarm configuration', 'Alarm global configuration']);
689 $config_export_svc{'Circuits'} = [ \%config_circuit, '' ]
690 if $curuser->access_right('Configuration');
691 $config_export_svc{'Fiber'} = [ \%config_fiber, '' ]
692 if $curuser->access_right('Configuration');
693 $config_export_svc{'Hardware types'} = [ $fsurl.'browse/hardware_class.html', 'Set up hardware type catalog' ]
694 if $curuser->access_right('Edit hardware classes and types');
696 tie my %config_pkg_reason, 'Tie::IxHash',
697 'Cancel reasons' => [ $fsurl.'browse/reason_type.html?class=C', 'Cancel reasons explain why a service was cancelled.' ],
698 'Suspend reasons' => [ $fsurl.'browse/reason_type.html?class=S', 'Suspend reasons explain why a service was suspended.' ],
701 tie my %config_pkg, 'Tie::IxHash', ();
702 $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' ]
703 if $curuser->access_right('Edit package definitions')
704 || $curuser->access_right('Edit global package definitions');
705 if ( $curuser->access_right('Configuration') ) {
707 #package grouping sub-menu?
708 $config_pkg{'Package classes'} = [ $fsurl.'browse/pkg_class.html', 'Package classes define groups of packages, for taxation, ordering convenience and reporting.' ];
709 $config_pkg{'Package categories'} = [ $fsurl.'browse/pkg_category.html', 'Package categories define groups of package classes, for invoice sections.' ];
710 $config_pkg{'Package report classes'} = [ $fsurl.'browse/part_pkg_report_option.html', 'Package classes define optional groups of packages for reporting only.' ];
711 #eo package grouping sub-menu
713 if ( $curuser->access_right([ 'Edit fee definitions',
714 'Edit global fee definitions' ]) ) {
715 $config_pkg{'Fees'} = [ $fsurl.'browse/part_fee.html', '' ];
717 $config_pkg{'Discounts'} = [ $fsurl.'browse/discount.html', '' ];
718 $config_pkg{'Discount classes'} = [ $fsurl.'browse/discount_class.html', '' ];
719 $config_pkg{'Cancel/Suspend Reasons'} = [ \%config_pkg_reason, '' ];
722 tie my %config_cust, 'Tie::IxHash',
723 'Customer tags' => [ $fsurl.'browse/part_tag.html', '' ],
724 'Customer classes' => [ $fsurl.'browse/cust_class.html', 'Customer classes define groups of customers for reporting.' ],
725 'Customer categories' => [ $fsurl.'browse/cust_category.html', 'Customer categories define groups of customer classes.' ],
726 'separator' => '', #its a separator!
727 'Contact types' => [ $fsurl.'browse/contact_class.html', ''], #XXX useful description
730 $config_cust{'Note classes'} = [ $fsurl.'browse/cust_note_class.html', 'Note classes define groups of customer notes for reporting.' ];
732 tie my %config_agent, 'Tie::IxHash',
733 'Agent types' => [ $fsurl.'browse/agent_type.cgi', 'Agent types define groups of package definitions that you can then assign to particular agents' ],
734 '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)' ],
735 'Agent payment gateways' => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors for agent overrides' ];
738 tie my %config_sales, 'Tie::IxHash',
739 'Sales People' => [ $fsurl.'browse/sales.html', 'Sales people bring in new business.' ],
742 tie my %config_billing_rates, 'Tie::IxHash';
743 $config_billing_rates{'Rate plans'} = [ $fsurl.'browse/rate.cgi', 'Manage rate plans' ]
744 if $curuser->access_right('Edit CDR rates')
745 #|| $curuser->access_right('Edit global CDR rates')
746 || $curuser->access_right('Configuration');
747 if ( $curuser->access_right('Configuration') ) {
748 $config_billing_rates{'Regions and prefixes'} = [ $fsurl.'browse/rate_region.html', 'Manage regions and prefixes' ];
749 $config_billing_rates{'Usage classes'} = [ $fsurl.'browse/usage_class.html', 'Usage classes define groups of usage for taxation.' ];
750 $config_billing_rates{'Time periods'} = [ $fsurl.'browse/rate_time.html', 'Time periods define days and hours for rate plans' ];
751 $config_billing_rates{'Edit rates with Excel'} = [ $fsurl.'misc/rate_edit_excel.html', 'Download and edit rates with Excel, then upload changes.' ]; #"Edit with Excel" ?
752 $config_billing_rates{'separator'} = ''; #its a separator!
753 $config_billing_rates{'Tiering plans'} = [ $fsurl.'browse/rate_tier.html', 'Rating tiers' ];
756 tie my %config_billing, 'Tie::IxHash';
757 # 'Payment gateways' => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors' ];
758 $config_billing{'Billing events'} = [ $fsurl.'browse/part_event.html', 'Billing actions for customers, invoices and packages' ]
759 if $curuser->access_right('Edit billing events')
760 || $curuser->access_right('Edit global billing events');
761 if ( $curuser->access_right('Configuration') ) {
762 $config_billing{'Invoice configurations'} = [ $fsurl.'browse/invoice_conf.html', 'Adjust invoice settings for special-purpose notices' ];
763 $config_billing{'Invoice templates'} = [ $fsurl.'browse/invoice_template.html', 'Edit templates for HTML, plaintext and typeset invoices' ];
764 $config_billing{'separator'} = ''; #its a separator!
765 $config_billing{'Prepaid cards'} = [ $fsurl.'search/prepay_credit.html', 'View outstanding cards, generate new cards' ];
767 $config_billing{'Call rates and regions'} = [ \%config_billing_rates, 'Manage rate plans, regions and prefixes for VoIP and call billing' ]
768 if keys %config_billing_rates;
769 if ( $curuser->access_right('Configuration') ) {
770 $config_billing{'separator2'} = ''; #its a separator!
772 my $config_taxes_name = 'Locales and tax rates'.
773 ( $conf->config('tax_data_vendor')
774 ? ' (internal tax class system)'
777 $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' ];
778 $config_billing{'Tax rates (vendor data tax products system)'} = [ $fsurl.'browse/tax_rate.cgi', 'Edit tax rates for the vendor data tax products system' ]
779 if $conf->config('tax_data_vendor');
780 $config_billing{'Tax classes'} = [ $fsurl. 'browse/part_pkg_taxclass.html', 'Tax classes' ];
782 if ( $conf->config('currencies') ) {
783 $config_billing{'separator3'} = ''; #its a separator!
784 $config_billing{'Exchange rates'} = [ $fsurl.'edit/currency_exchange.html', 'Currency exchange rates' ];
787 $config_billing{'separator4'} = ''; #its a separator!
788 $config_billing{'Credit reasons'} = [ $fsurl.'browse/reason_type.html?class=R', 'Credit reasons explain why a credit was issued.' ];
790 $config_billing{'Refund reasons'} = [ $fsurl.'browse/reason_type.html?class=F', 'Refund reasons explain why a refund was issued.' ];
792 $config_billing{'Invoice void reasons'} = [ $fsurl.'browse/reason_type.html?class=I', 'Invoice void reasons explain why an invoice was voided.' ];
793 $config_billing{'Payment void reasons'} = [ $fsurl.'browse/reason_type.html?class=P', 'Payment void reasons explain why a payment was voided.' ];
794 $config_billing{'Credit void reasons'} = [ $fsurl.'browse/reason_type.html?class=X', 'Credit void reasons explain why a credit was voided.' ];
797 #XXX also to be unified
798 tie my %config_ticketing_groups, 'Tie::IxHash',
799 'Select' => [ $fsurl.'rt/Admin/Groups', '' ],
800 'Create' => [ $fsurl.'rt/Admin/Groups/Modify.html?Create=1', '' ],
803 tie my %config_ticketing_queues, 'Tie::IxHash',
804 'Select' => [ $fsurl.'rt/Admin/Queues', '' ],
805 'Create' => [ $fsurl.'rt/Admin/Queues/Modify.html?Create=1', '' ],
808 tie my %config_ticketing_customfields, 'Tie::IxHash',
809 'Select' => [ $fsurl.'rt/Admin/CustomFields', '' ],
810 'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1', '' ],
813 tie my %config_ticketing_articles_classes, 'Tie::IxHash',
814 'Select' => [ $fsurl.'rt/Admin/Articles/Classes/', '' ],
815 'Create' => [ $fsurl.'rt/Admin/Articles/Classes/Modify.html?Create=1', '' ],
818 tie my %config_ticketing_articles_customfields, 'Tie::IxHash',
819 'Select' => [ $fsurl.'rt/Admin/CustomFields/index.html?type=RT%3A%3AClass-RT%3A%3AArticle', '' ],
820 'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1&LookupType=RT%3A%3AClass-RT%3A%3AArticle', '' ],
823 tie my %config_ticketing_articles, 'Tie::IxHash',
824 'Classes' => [ \%config_ticketing_articles_classes, '' ],
825 'Custom Fields' => [ \%config_ticketing_articles_customfields, '' ],
828 tie my %config_ticketing, 'Tie::IxHash',
829 'Ticketing Users' => [ $fsurl.'rt/Admin/Users', 'Edit ticketing users' ], #XXX to be unified
830 'Ticketing Groups' => [ \%config_ticketing_groups, 'View/Edit ticketing groups and group membership' ], #XXX to be unified
831 'Ticketing Queues' => [ \%config_ticketing_queues, 'View/Edit ticketing queues and queue-specific properties' ],
832 'Ticket Custom Fields' => [ \%config_ticketing_customfields, 'View/Edit ticketing custom fields' ],
833 'Ticketing Global' => [ $fsurl.'rt/Admin/Global', 'View/Edit ticketing configuration applicable to all queues' ], #XXX the individual items
834 'Ticketing Articles' => [ \%config_ticketing_articles, '' ],
835 #"System Configuraiton"? useless, just makes people report errors about missing Module::Versions::Report #'Ticketing Tools' => [ $fsurl.'rt/Admin/Tools', '' ],
838 tie my %config_nms, 'Tie::IxHash',
839 'View/Edit virtual ports' => [ $fsurl.'browse/torrus_srvderive.html', '' ],
842 tie my %config_misc, 'Tie::IxHash';
843 $config_misc{'Message templates'} = [ $fsurl.'browse/msg_template/email.html', 'Templates for customer notices' ]
844 if $curuser->access_right(['View templates', 'View global templates',
845 'Edit templates', 'Edit global templates', ]);
846 $config_misc{'Advertising sources'} = [ $fsurl.'browse/part_referral.html', 'Where a customer heard about your service.' ]
847 if $curuser->access_right('Edit advertising sources')
848 || $curuser->access_right('Edit global advertising sources');
849 $config_misc{'Custom fields'} = [ $fsurl.'browse/part_virtual_field.html', 'Locally defined fields', ]
850 if $curuser->access_right('Edit custom fields');
851 $config_misc{'Translation strings'} = [ $fsurl.'browse/msgcat.html', 'Translations and other customizable labels for each locale' ]
852 if $curuser->access_right('Configuration');
853 $config_misc{'Inventory classes and inventory'} = [ $fsurl.'browse/inventory_class.html', 'Setup inventory classes and stock inventory' ]
854 if $curuser->access_right('Edit inventory')
855 || $curuser->access_right('Edit global inventory')
856 || $curuser->access_right('Configuration');
858 $config_misc{'Upload targets'} = [ $fsurl.'browse/upload_target.html', 'Billing and payment upload destinations' ]
859 if $curuser->access_right('Configuration');
861 $config_misc{'System log emails'} = [ $fsurl.'browse/log_email.html', 'Configure conditions for sending email when logging' ]
862 if $curuser->access_right('View system logs')
863 || $curuser->access_right('Configuration');
865 tie my %config_menu, 'Tie::IxHash';
866 if ( $curuser->access_right('Configuration' ) ) {
868 'Settings' => [ $fsurl.'config/config-view.cgi', '' ],
869 'separator' => '', #its a separator!
870 'Companies' => [ \%config_agent, '' ],
874 $config_menu{'Sales People'} = [ \%config_sales, '' ]
875 if $curuser->access_right('Edit sales people');
877 if ( $curuser->access_right('Configuration' ) ) {
878 $config_menu{'Employees'} = [ \%config_employees, '' ];
879 $config_menu{'separator2'} = ''; #its a separator!
880 $config_menu{'Customers'} = [ \%config_cust, '' ];
881 #or this? 'Customers and Contacts'
884 $config_menu{'Packages'} = [ \%config_pkg, '' ]
885 if $curuser->access_right('Configuration' )
886 || $curuser->access_right('Edit package definitions')
887 || $curuser->access_right('Edit global package definitions');
889 if ( $curuser->access_right('Configuration') ) {
890 $config_menu{'Services'} = [ \%config_export_svc, '' ];
891 $config_menu{separator3} = '';
894 tie my %config_vendor, 'Tie::IxHash',
895 'Vendor classes' => [ $fsurl.'browse/vend_class.html', '' ],
896 'Vendors' => [ $fsurl.'browse/vend_main.html', '' ],
899 if ( $curuser->access_right('Configuration') ) {
900 $config_menu{'Vendors'} = [ \%config_vendor, '' ];
901 $config_menu{separator4} = '';
904 $config_menu{'Billing'} = [ \%config_billing, '' ]
905 if keys %config_billing;
906 $config_menu{'Ticketing'} = [ \%config_ticketing, '' ]
907 if $conf->config('ticket_system')
908 && eval { FS::TicketSystem->access_right(\%session, 'ShowConfigTab') };
909 $config_menu{'Network Monitoring'} = [ \%config_nms, '' ]
910 if $curuser->access_right('Configure network monitoring')
911 && $conf->config('network_monitoring_system') eq 'Torrus_Internal';
913 if ( $curuser->access_right([ 'Configuration',
915 'View global templates',
917 'Edit global templates',
920 $config_menu{separator9} = '' if keys %config_menu;
921 $config_menu{'Miscellaneous'} = [ \%config_misc, '' ];
925 my $wiki = 'http://www.freeside.biz/mediawiki/index.php';
926 my $doc_link = $conf->config('support-key')
927 ? "$wiki/Supported:Documentation"
928 : $curuser->access_right('Configuration')
929 ? "$wiki/Freeside:4:Documentation"
930 : "$wiki/Freeside:2.1:Documentation:User"; #no page for other versions yet :/
933 if $conf->config('ticket_system') eq 'RT_Internal';
935 tie my %help_menu, 'Tie::IxHash';
936 my $agentnum = $conf->config('brand-agent');
938 my $company_name = $conf->config('company_name', $agentnum);
939 $help_menu{"About $company_name"} = [ "javascript:about_freeside()", '' ];
941 $help_menu{'Billing documentation'} = [ $doc_link, 'Freeside documentation' ];
942 $help_menu{'Ticketing documentation'} = [ 'http://wiki.bestpractical.com/', 'Request Tracker Wiki' ]
943 if $conf->config('ticket_system') eq 'RT_Internal';
944 $help_menu{'Networking monitoring documentation'} = [ 'http://torrus.org/userguide.pod.html', 'Torrus User Guide' ]
945 if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
946 $help_menu{'Developer documentation'} = [ "${fsurl}docs/library/FS.html", 'Developer documentation' ];
947 $help_menu{'separator'} = '';
948 $help_menu{"About Freeside v$FS::VERSION"} = [ "javascript:about_freeside()", '' ];
949 $help_menu{"About RT v$RT::VERSION"} = [ 'http://www.bestpractical.com/rt', 'Request Tracker Homepage' ]
950 if $conf->config('ticket_system') eq 'RT_Internal';
951 $help_menu{"About Torrus v1.0.9"} = [ 'http://www.torrus.org/', 'Torrus Homepage' ] #XXX manual version
952 if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
956 tie my %menu, 'Tie::IxHash';
958 if ( $conf->config('menu-prepend_links')) {
959 my @links = split(/\n/, $conf->config('menu-prepend_links'));
960 foreach my $link (@links) {
961 $link =~ /^\s*(\S+)\s+(.*?)(\s*\(([^\)]*)\))?$/ or next;
962 my($url, $label, $alt) = ($1, $2, $4);
963 $menu{$label} = [ $url, $alt ];
967 $menu{'Billing Main'} = [ $fsurl, 'Billing start page', ];
969 if ( $conf->config('ticket_system') ) {
970 $menu{'Ticketing Main'} =
972 ( $conf->config('ticket_system') eq 'RT_External'
973 ? FS::TicketSystem->baseurl()
976 'Ticketing start page',
980 if ( $conf->config('network_monitoring_system') eq 'Torrus_Internal' &&
981 $curuser->access_right('Configure network monitoring') ) {
982 $menu{'Network Main'} =
983 [ $fsurl.'torrus/main', 'Network monitoring start page' ],
986 $menu{'New prospect'} = [ $fsurl.'edit/prospect_main.html', 'Add a new prospect' ]
987 if $curuser->access_right('New prospect');
988 $menu{'New customer'} = [ $fsurl.'edit/cust_main.cgi', 'Add a new customer' ]
989 if $curuser->access_right('New customer');
990 $menu{'Reports'} = [ \%report_menu, 'Lists, reporting and graphing' ]
991 if keys %report_menu;
992 $menu{'Tools'} = [ \%tools_menu, 'Tools' ]
994 $menu{'Configuration'} = [ \%config_menu, 'Configuration and setup' ]
995 if $curuser->access_right([ 'Configuration',
996 'Edit package definitions',
997 'Edit global package definitions',
998 'Edit billing events',
999 'Edit global billing events',
1000 'Dialup configuration',
1001 'Wireless broadband configuration',
1002 'Phone configuration',
1003 'Alarm configuration',
1004 'Alarm global configuration',
1005 'Edit advertising sources',
1006 'Edit global advertising sources',
1008 'View global templates',
1010 'Edit global templates',
1012 $menu{'Help'} = [ \%help_menu, '' ];
1015 use vars qw($gmenunum);
1019 my($submenu, $title) = @_;
1020 my $menunum = $gmenunum++;
1022 #return two args: html, menuname
1024 "var myMenu$menunum = new WebFXMenu;\n".
1025 #"myMenu$menunum.useAutoPosition = true;\n".
1026 # "myMenu$menunum.emptyText = '$title';\n".
1027 "myMenu$menunum.emptyText = '';\n".
1032 if ( !ref( $submenu->{$_} ) ) {
1034 "myMenu$menunum.add(new WebFXMenuSeparator());";
1038 my($url_or_submenu, $tooltip ) = @{ $submenu->{$_} };
1039 if ( ref($url_or_submenu) ) {
1041 my($subhtml, $submenuname ) = submenu($url_or_submenu, $_); #mmm, recursion
1044 "myMenu$menunum.add(new WebFXMenuItem(\"".mt($_)."\", null, \"".mt($tooltip)."\", $submenuname ));";
1048 "myMenu$menunum.add(new WebFXMenuItem(\"".mt($_)."\", \"$url_or_submenu\", \"".mt($tooltip)."\" ));";
1056 "myMenu$menunum.width = 256;\n",