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 referrals'} = [ $fsurl. 'search/cust_main.html?with_referrals=1' ];
134 tie my %report_customers, 'Tie::IxHash';
135 $report_customers{'List customers'} = [ \%report_customers_lists, 'List customers' ]
136 if $curuser->access_right('List all customers');
137 $report_customers{'Zip code distribution'} = [ $fsurl. 'search/report_cust_main-zip.html', 'Zip codes by number of customers' ]
138 if $curuser->access_right('List zip codes');
139 $report_customers{'Customer signup report'} = [ $fsurl. 'graph/report_cust_signup.html', 'New customer signups by date' ]
140 if $curuser->access_right('Financial reports');
141 $report_customers{'Customer churn report'} = [ $fsurl.'graph/report_cust_churn.html', 'New customers, suspensions, and cancellations summary' ]
142 if $curuser->access_right('Customers: Customer churn report');
143 $report_customers{'Signup date report'} = [ $fsurl. 'graph/report_signupdate.html', 'Signup date report (by date of signup)' ];
144 $report_customers{'Advanced customer reports'} = [ $fsurl. 'search/report_cust_main.html', 'by status, signup date, agent, etc.' ]
145 if $curuser->access_right('Advanced customer search');
146 if ( $curuser->access_right('List contacts') ) {
147 $report_customers{'separator'} = '';
148 $report_customers{'Customer contacts'} = [ $fsurl. 'search/report_contact.html?link=cust_main' ];
149 $report_customers{'Customer stored payment information'} = [ $fsurl. 'search/report_cust_payby.html' ];
150 $report_customers{'Customer timespan'} = [ $fsurl. 'search/report_cust_timespan.html' ];
153 tie my %report_invoices_open, 'Tie::IxHash',
154 'All open invoices' => [ $fsurl.'search/cust_bill.html?OPEN_date', 'All invoices with an unpaid balance' ],
155 '15 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN15_date', 'Invoices 15 days or older with an unpaid balance' ],
156 '30 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN30_date', 'Invoices 30 days or older with an unpaid balance' ],
157 '60 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN60_date', 'Invoices 60 days or older with an unpaid balance' ],
158 '90 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN90_date', 'Invoices 90 days or older with an unpaid balance' ],
159 '120 day open invoices' => [ $fsurl.'search/cust_bill.html?OPEN120_date', 'Invoices 120 days or older with an unpaid balance' ],
162 tie my %report_invoices, 'Tie::IxHash',
163 'Open invoices' => [ \%report_invoices_open, 'Open invoices' ],
164 'All invoices' => [ $fsurl. 'search/cust_bill.html?date', 'List all invoices' ],
165 'Advanced invoice reports' => [ $fsurl.'search/report_cust_bill.html', 'by agent, date range, etc.' ],
167 'Line items' => [ $fsurl. 'search/report_cust_bill_pkg.html', 'Individual line item detail' ],
169 'Voided invoices' => [ $fsurl.'search/report_cust_bill_void.html', 'Search for voided invoices' ],
173 tie my %report_discounts, 'Tie::IxHash',
174 'Discount graph' => [ $fsurl. 'graph/report_cust_bill_pkg_discount.html', 'Discount overview per month' ],
175 'Discount detail' => [ $fsurl.'search/report_cust_bill_pkg_discount.html', 'Discount report (by employee and/or date range)' ],
177 'Package discounts' => [ $fsurl.'search/report_cust_pkg_discount.html', 'Active/inactive discounts by package' ],
180 tie my %report_services, 'Tie::IxHash';
181 if ( $curuser->access_right('Configuration') ) {
182 $report_services{'Service definitions'} = [ $fsurl.'browse/part_svc.cgi?orderby=active', 'Service definitions by number of active packages' ];
183 $report_services{'separator'} = '';
186 if ( $curuser->access_right('List services') ) {
187 $report_services{'Unprovisioned services'} = [ $fsurl.'search/report_unprovisioned_services.html', 'Unprovisioned services' ];
188 $report_services{'separator2'} = '';
191 foreach my $svcdb ( FS::part_svc->svc_tables() ) {
193 my $name = "FS::$svcdb"->table_info->{'name_plural'}
194 || PL( "FS::$svcdb"->table_info->{'name'} );
195 my $lcname = "FS::$svcdb"->table_info->{'lcname_plural'} || lc($name);
196 my $lcsname = lc("FS::$svcdb"->table_info->{'name'});
197 my $longname = "FS::$svcdb"->table_info->{'longname_plural'} || $name;
198 my $lclongname = lc($longname);
199 my $sorts = "FS::$svcdb"->table_info->{'sorts'} || [ 'svcnum' ];
200 $sorts = [ $sorts ] unless ref($sorts);
201 my %svc_url = ( 'm' => $m,
202 'action' => 'search',
206 tie my %report_svc, 'Tie::IxHash';
208 foreach my $sort ( @$sorts ) {
210 my $field_info = FS::part_svc->svc_table_fields($svcdb)->{$sort};
211 my $label = $field_info->{'label_sort'} || 'by '.$field_info->{'label'};
213 my $title = "All $lcname";
215 if scalar(@$sorts) > 1;
217 $report_svc{$title} =
218 [ svc_url( %svc_url, 'query' => "magic=all;sortby=$sort" ),
223 if ( $svcdb eq 'svc_acct' ) {
225 $report_svc{"All $lcname never logged in"} =
226 [ svc_url( %svc_url, 'query' => "magic=nologin;sortby=svcnum" ),
230 } elsif ( $svcdb eq 'svc_phone' ) {
232 $report_svc{"${name}' total usage by time period"} =
233 [ $fsurl. 'search/report_svc_phone_usage.html',
234 'Total usage (minutes, and amount billed) for the specified time period, per phone number.',
236 $report_svc{"${name} by state"} =
237 [ $fsurl. 'search/phone_state.html',
238 'Current or historical phone services broken down by state.',
243 if ( $curuser->access_right('View/link unlinked services') ) {
244 $report_svc{"Unlinked $lcname"} =
245 [ svc_url( %svc_url, 'query' => "magic=unlinked;sortby=". $sorts->[0] ),
246 "Pre-Freeside $lcname without a customer record",
250 if ( $curuser->access_right("Services: $name: Advanced search")
251 && $svcdb =~ /^svc_(acct|broadband|hardware|phone|fiber)$/ ) {
253 $report_svc{"Advanced $lcsname reports"} =
254 [ $fsurl."search/report_$svcdb.html", '' ]
257 if ( $svcdb eq 'svc_phone' ) {
259 $report_svc{"Phone number (DID) availability"} =
260 [ $fsurl."search/report_phone_avail.html", '' ];
261 $report_svc{"Inventory/Provisioning Status"} =
262 [ $fsurl."search/phone_inventory_provisioned.html", '' ];
264 } elsif ( $svcdb eq 'svc_dsl' ) {
266 $report_svc{'Qualifications'} = [ $fsurl. 'search/qual.cgi', #XXX qual.html
272 $report_services{$name} = [ \%report_svc, $longname ]
273 if $curuser->access_right("Services: $name");
277 ## adding export test reports
278 tie my %report_exports, 'Tie::IxHash';
279 my $exports = FS::part_export::export_info();
281 tie my %export_list, 'Tie::IxHash',
283 map { $_ => "$_ - ". $exports->{$_}{desc} }
288 foreach my $export (keys %export_list) {
289 $report_exports{"$export export test"} =
290 [ $fsurl. 'search/report_svc_export_test.cgi?export='.$export,
291 "Report of invalid service setup for services tied to $export export",
292 ] if "FS::part_export::$export"->can('test_export_report');
294 $report_services{'exports'} = [ \%report_exports, "Exports" ];
296 tie my %report_packages, 'Tie::IxHash';
297 $report_packages{'Package definitions (by # active)'} = [ $fsurl.'browse/part_pkg.cgi?active=1', 'Package definitions by number of active packages' ]
298 if $curuser->access_right('Edit package definitions')
299 || $curuser->access_right('Edit global package definitions');
300 $report_packages{'Package costs'} = [ $fsurl.'graph/report_cust_pkg_cost.html', 'Package setup and recurring costs graph' ]
301 if $curuser->access_right('Financial reports');
302 $report_packages{'separator'} = ''
303 if keys %report_packages;
304 if ( $curuser->access_right('Financial reports') ) {
305 $report_packages{'Package churn'} = [ $fsurl.'graph/report_cust_pkg.html', 'Orders, suspensions and cancellations summary graph' ];
306 $report_packages{'separator2'} = '';
308 $report_packages{'All customer packages'} = [ $fsurl.'search/cust_pkg.cgi?pkgnum', 'List all customer packages', ];
309 $report_packages{'Package summary'} = [ $fsurl.'search/cust_pkg_summary.html', 'Show package sales summary', ]
310 if $curuser->access_right('Summarize packages');
311 $report_packages{'Suspended customer packages'} = [ $fsurl.'search/cust_pkg.cgi?magic=suspended', 'List suspended packages' ];
312 $report_packages{'Suspension summary'} = [ $fsurl.'search/cust_pkg_susp.html', 'Show suspension activity', ]
313 if $curuser->access_right('Summarize packages');
314 $report_packages{'Customer packages with unconfigured services'} = [ $fsurl.'search/cust_pkg.cgi?APKG_pkgnum', 'List packages which have provisionable services' ];
315 $report_packages{'FCC Form 477'} = [ $fsurl.'search/report_477.html' ]
316 if $conf->exists('part_pkg-show_fcc_options');
317 $report_packages{'Contract end dates'} = [ $fsurl.'search/report_cust_pkg-date.html?date=contract_end', 'Show packages by contract end date' ];
318 $report_packages{'Advanced package reports'} = [ $fsurl.'search/report_cust_pkg.html', 'by agent, date range, status, package definition' ];
320 tie my %report_inventory, 'Tie::IxHash',
321 'Inventory by agent' => [ $fsurl.'search/report_agent_inventory.html', '' ],
322 'Inventory activity' => [ $fsurl.'search/report_h_inventory_item.html', '' ],
325 tie my %report_rating, 'Tie::IxHash';
326 $report_rating{'RADIUS sessions'} = [ $fsurl.'search/sqlradius.html', '' ]
327 if $curuser->access_right("Usage: RADIUS sessions");
328 $report_rating{'RADIUS data usage'} = [ $fsurl.'search/report_sqlradius_usage.html', '' ]
329 if $curuser->access_right("Usage: RADIUS sessions");
330 $report_rating{'Call Detail Records (CDRs)'} = [ $fsurl.'search/report_cdr.html', '' ]
331 if $curuser->access_right("Usage: Call Detail Records (CDRs)");
332 $report_rating{'Unrateable CDRs'} = [ $fsurl.'search/cdr.html?freesidestatus=failed;cdrbatchnum=_ALL_' ]
333 if $curuser->access_right("Usage: Unrateable CDRs");
334 $report_rating{'Customer CDRs Profit/Loss'} = [ $fsurl.'search/report_customer_cdr_profit.html', 'Profit/loss from customer CDRs' ]
335 if $curuser->access_right('Financial reports');
336 if ( $curuser->access_right("Usage: Time worked") ) {
337 $report_rating{'Time worked'} = [ $fsurl.'search/report_rt_transaction.html', '' ];
338 $report_rating{'Time worked summary per ticket'} = [ $fsurl.'search/report_rt_ticket.html', '' ];
339 $report_rating{'Time worked summary per customer'} = [ $fsurl.'search/report_rt_cust.html', '' ];
342 tie my %report_ticketing_statistics, 'Tie::IxHash',
343 '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' ],
344 'Ticket status by Queue' => [ $fsurl.'rt/RTx/Statistics/OpenStalled', 'View numbers of new, open and stalled tickets in a selected Queue' ],
345 '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' ],
346 'Tickets per Day of Week' => [ $fsurl.'rt/RTx/Statistics/DayOfWeek', 'View trends showing when tickets are created, resolved or deleted' ],
347 'Time to resolve' => [ $fsurl.'rt/RTx/Statistics/Resolution', 'View how long tickets take to be resolved by Queue' ],
348 'Time to resolve (scatter graph)' => [ $fsurl.'rt/RTx/Statistics/TimeToResolve', 'View a detailed scatter graph of time to resolve tickets by Queue' ],
351 tie my %report_ticketing, 'Tie::IxHash',
352 # fix TimeToResolve extension? or redo in a more modern way?
353 # 'Resolved by owner' => [ $fsurl.'rt/Tools/Reports/ResolvedByOwner.html', '' ],
354 # 'Resolved in date range' => [ $fsurl.'rt/Tools/Reports/ResolvedByDates.html', '' ],
355 # 'Created in date range' => [ $fsurl.'rt/Tools/Reports/CreatedByDates.html', '' ],
357 'Statistics' => [ \%report_ticketing_statistics, '' ],
359 'Advanced ticket reports' => [ $fsurl.'rt/Search/Build.html?NewQuery=1', 'List tickets by any criteria' ],
362 tie my %report_bill_event, 'Tie::IxHash',
363 'Billing event errors' => [ $fsurl.'search/report_cust_event.html?failed=1', 'Failed credit cards, processor or printer problems, etc.' ],
366 tie my %report_payments, 'Tie::IxHash';
367 $report_payments{'Payments'} = [ $fsurl.'search/report_cust_pay.html', 'Payment report (by type and/or date range)' ]
368 if $curuser->access_right('Basic payment and refund reports');
369 $report_payments{'Payment application detail'} = [ $fsurl.'search/report_cust_bill_pay_pkg.html', 'Line item application detail' ]
370 if $curuser->access_right('Financial reports');
371 $report_payments{'Pending Payments'} = [ $fsurl.'search/cust_pay_pending.html?magic=_date;statusNOT=done', 'Pending real-time payments' ]
372 if $curuser->access_right('View customer pending payments');
373 $report_payments{'Unapplied Payments'} = [ $fsurl.'search/report_cust_pay.html?unapplied=1', 'Unapplied payment report (by type and/or date range)' ]
374 if $curuser->access_right('Financial reports'); #not enforced
375 $report_payments{'Voided Payments'} = [ $fsurl.'search/report_cust_pay.html?void=1', 'Voided payment report (by type and/or date range)' ]
376 if $curuser->access_right('Financial reports'); #not enforced
377 $report_payments{'Payment Batches'} = [ $fsurl.'search/pay_batch.html', 'Payment batches (by status and/or date range)' ]
378 if ( $conf->exists('batch-enable') || $conf->config('batch-enable_payby') )
379 && $curuser->access_right('Financial reports');
380 $report_payments{'Unapplied Payment Aging'} = [ $fsurl.'search/report_unapplied_cust_pay.html', 'Unapplied payment aging report' ]
381 if $curuser->access_right('Financial reports');
382 $report_payments{'Deleted Payments / Payment history table'} = [ $fsurl.'search/report_h_cust_pay.html', 'Deleted payments / payment history table' ]
383 if $conf->exists('payment-history-report')
384 && $curuser->access_right('Financial reports');
386 tie my %report_credits, 'Tie::IxHash',
387 'Credit Report' => [ $fsurl.'search/report_cust_credit.html', 'Credit report (by employee and/or date range)' ],
388 'Credit package source detail' => [ $fsurl.'search/report_cust_credit_source_bill_pkg.html', 'Line-item detail for triggered package credits' ],
389 'Credit application detail' => [ $fsurl.'search/report_cust_credit_bill_pkg.html', 'Line item application detail' ],
390 'Unapplied Credits' => [ $fsurl.'search/report_cust_credit.html?unapplied=1', 'Unapplied credit report (by type and/or date range)' ],
391 'Voided Credits' => [ $fsurl.'search/report_cust_credit_void.html', 'Voided credit report (by employee and/or date range)' ],
394 tie my %report_refunds, 'Tie::IxHash',
395 'Refund Report' => [ $fsurl.'search/report_cust_refund.html', 'Refund report (by type and/or date range)' ],
396 'Unapplied Refunds' => [ $fsurl.'search/report_cust_refund.html?unapplied=1', 'Unapplied refund report (by type and/or date range)' ],
399 tie my %report_sales, 'Tie::IxHash',
400 'Sales, Credits and Receipts' => [ $fsurl.'graph/report_money_time.html', 'Sales, credits and receipts summary graph' ],
401 'Daily Sales, Credits and Receipts' => [ $fsurl.'graph/report_money_time_daily.html', 'Sales, credits and receipts (broken down by day) summary graph' ],
402 'Sales Report' => [ $fsurl.'graph/report_cust_bill_pkg.html', 'Sales report and graph (by agent, package class and/or date range)' ],
403 '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)' ],
404 'Sales with Advertising Source' => [ $fsurl.'search/report_cust_bill_pkg_referral.html' ],
407 tie my %report_commissions, 'Tie::IxHash',
408 'Agent' => [ $fsurl.'search/report_agent_commission.html' ],
409 'Agent per package' => [ $fsurl.'search/report_agent_commission_pkg.html' ],
410 'Sales Person' => [ $fsurl.'search/report_sales_commission.html' ],
411 'Sales Person per package' => [ $fsurl.'search/report_sales_commission_pkg.html' ],
412 'Employee' => [ $fsurl.'search/report_employee_commission.html', '' ],
413 'Agent Credits and Payments' => [ $fsurl.'search/report_agent_credit_payment.html' ],
416 tie my %report_financial, 'Tie::IxHash';
417 if( $curuser->access_right('Financial reports') ) {
419 %report_financial = (
420 'Sales' => [ \%report_sales, 'Sales reports', ],
421 'Commissions' => [ \%report_commissions, 'Commission reports', ],
422 'Credits' => [ \%report_credits, 'Credit reports', ],
423 'Refunds' => [ \%report_refunds, 'Refund reports', ],
425 $report_financial{'A/R Aging'} = [ $fsurl.'search/report_receivables.html', 'Accounts Receivable Aging report' ];
426 $report_financial{'Prepaid Income'} = [ $fsurl.'search/report_prepaid_income.html', 'Prepaid income (unearned revenue) report' ];
428 my $taxproducts = $conf->config('tax_data_vendor');
429 $report_financial{'Tax Liability'. ($taxproducts ? ' (internal tax data)' : '')} = [ $fsurl.'search/report_tax.html', 'Tax liability report (internal tax data)' ];
430 $report_financial{'Tax Liability (vendor tax data)'} = [ $fsurl.'search/report_newtax.html', 'Tax liability report (vendor tax data)' ]
433 $report_financial{'Monthly Sales and Taxes'} = [$fsurl.'search/tax_sales.html', 'Monthly sales and taxes report'];
435 # most sites don't need this but there isn't really a config to enable it
436 $report_financial{'E911 Fee Summary'} = [ $fsurl.'search/report_e911.html', 'E911 fee summary' ];
438 $report_financial{'Customer Accounting Summary'} = [ $fsurl.'search/report_customer_accounting_summary.html', 'Customer accounting summary report' ];
440 if ( my $report_title = FS::cust_payby->future_autobill_report_title ) {
441 $report_financial{$report_title} = [ $fsurl.'search/report_future_autobill.html', "$report_title for customers with automatic payment methods (by date)" ];
444 } elsif($curuser->access_right('Receivables report')) {
446 $report_financial{'A/R Aging'} = [ $fsurl.'search/report_receivables.html', 'Accounts Receivable Aging report' ];
448 } # else $report_financial contains nothing.
450 tie my %report_payable, 'Tie::IxHash',
451 'Payables summary' => [ $fsurl. 'search/report_vend_main.html', 'Payables summary by vendor' ],
452 'Payables detail' => [ $fsurl. 'search/report_vend_bill.html' ],
455 tie my %report_logs, 'Tie::IxHash';
456 $report_logs{'Billing events'} = [ $fsurl.'search/report_cust_event.html', 'Search billing events by date and status' ]
457 if $curuser->access_right('Billing event reports');
458 $report_logs{'Billing event fees'} = [ $fsurl.'search/report_cust_event_fee.html', 'Search fees triggered by billing events' ]
459 if $curuser->access_right('Billing event reports');
460 $report_logs{'Credit limit incidents'} = [ $fsurl.'search/report_cust_main_credit_limit.html', '' ]
461 if $curuser->access_right('List rating data');
462 $report_logs{'Employee activity'} = [ $fsurl.'search/report_employee_audit.html', '' ]
463 if $curuser->access_right('Employees: Audit Report');
464 $report_logs{'System log'} = [ $fsurl.'search/log.html', 'View system events and debugging information.' ],
465 if $curuser->access_right('View system logs')
466 || $curuser->access_right('Configuration');
467 $report_logs{'Outgoing messages'} = [ $fsurl.'search/cust_msg.html', 'View outgoing message log' ]
468 if $curuser->access_right('View email logs')
469 || $curuser->access_right('Configuration');
471 tie my %report_menu, 'Tie::IxHash';
472 $report_menu{'Saved searches'} = [ \%report_saved_searches, 'My saved searches' ]
473 if keys(%report_saved_searches);
474 $report_menu{'Prospects'} = [ \%report_prospects, 'Prospect reports' ]
475 if $curuser->access_right('List prospects')
476 || $curuser->access_right('List contacts');
477 $report_menu{'Quotations'} = [ \%report_quotations, 'Quotation reports' ]
478 if $curuser->access_right('List quotations');
479 $report_menu{'Customers'} = [ \%report_customers, 'Customer reports' ]
480 if $curuser->access_right('List customers')
481 || $curuser->access_right('List contacts')
482 || $curuser->access_right('Advanced customer search')
483 || $curuser->access_right('List zip codes')
484 || $curuser->access_right('Financial reports')
485 || $curuser->access_right('Customers: Customer churn report');
486 $report_menu{'Invoices'} = [ \%report_invoices, 'Invoice reports' ]
487 if $curuser->access_right('List invoices');
488 $report_menu{'Discounts'} = [ \%report_discounts, 'Discount reports' ]
489 if $curuser->access_right('Financial reports');
490 $report_menu{'Payments'} = [ \%report_payments, 'Payment reports' ]
491 if keys %report_payments;
492 $report_menu{'Packages'} = [ \%report_packages, 'Package reports' ]
493 if $curuser->access_right('List packages');
494 $report_menu{'Services'} = [ \%report_services, 'Services reports' ]
495 if $curuser->access_right('List services');
496 $report_menu{'Inventory'} = [ \%report_inventory, 'Inventory reports' ]
497 if $curuser->access_right('Configuration'); #XXX List inventory?
498 $report_menu{'Usage'} = [ \%report_rating, 'Usage reports' ]
499 if $curuser->access_right('List rating data');
500 $report_menu{'Tickets'} = [ \%report_ticketing, 'Ticket reports' ]
501 if $conf->config('ticket_system')
502 ;#&& FS::TicketSystem->access_right(\%session, 'Something');
503 $report_menu{'Financial (Receivables)'} = [ \%report_financial, 'Financial reports (Receivables)' ]
504 if $curuser->access_right('Financial reports')
505 or $curuser->access_right('Receivables report');
506 $report_menu{'Financial (Payables)'} = [ \%report_payable, 'Financial reports (Payables)' ]
507 if $curuser->access_right('Financial reports');
509 $report_menu{'Logs'} = [ \%report_logs, 'System and email logs' ]
510 if (keys %report_logs); # empty if the user has no rights to it
511 $report_menu{'SQL Query'} = [ $fsurl.'search/report_sql.html', 'SQL Query']
512 if $curuser->access_right('Raw SQL');
514 tie my %tools_customers, 'Tie::IxHash', ();
515 $tools_customers{'Appointments'} = [ $fsurl.'rt/Search/Schedule.html?LengthMin=0', 'View appointment schedule' ]
516 if $curuser->access_right('View appointments');
517 $tools_customers{'Attachments'} = [ $fsurl.'search/report_cust_attachment.html', 'View customer attachments' ]
518 if !$conf->config('disable_cust_attachment') and $curuser->access_right('View attachments') and $curuser->access_right('Browse attachments');
519 $tools_customers{'Customer email settings'} = [ $fsurl.'misc/manage_cust_email.html' ]
520 if $curuser->access_right('Edit customer');
522 tie my %tools_billing, 'Tie::IxHash', ();
523 $tools_billing{'Quick payment entry'} = [ $fsurl.'misc/batch-cust_pay.html', 'Enter multiple payments in a batch' ]
524 if $curuser->access_right('Post payment batch');
525 $tools_billing{'Process payment batches'} = [ $fsurl.'search/pay_batch.cgi?magic=_date;open=1;intransit=1', 'Process credit card and electronic check batches' ]
526 if ( $conf->exists('batch-enable') || $conf->config('batch-enable_payby') )
527 && $curuser->access_right('Process batches');
528 $tools_billing{'Download invoice batches'} = [ $fsurl.'search/bill_batch.cgi' ]
529 if $curuser->access_right('Process invoice batches')
530 || $curuser->access_right('Process global invoice batches')
531 || $curuser->access_right('Configuration'); #XXX remove in 2.5
532 #now there's a standalone event#if $conf->exists('invoice_print_pdf');
534 tie my %tools_importing, 'Tie::IxHash',
535 'Customers' => [ $fsurl.'misc/cust_main-import.cgi', '' ],
536 'Package definitions' => [ $fsurl.'misc/part_pkg-import.html', '' ],
537 'Customer packages' => [ $fsurl.'misc/cust_pkg-import.html', '' ],
538 # 'Customer broadband services' => [ $fsurl.'misc/svc_broadband-import.html', '' ],
539 'Customer notes' => [ $fsurl.'misc/cust_main_note-import.html', '' ],
540 'Customer contacts' => [ $fsurl.'misc/contact-import.cgi', '' ],
541 'One-time charges' => [ $fsurl.'misc/cust_main-import_charges.cgi', '' ],
542 'Payments' => [ $fsurl.'misc/cust_pay-import.cgi', '' ],
543 'Credits' => [ $fsurl.'misc/cust_credit-import.html', '' ],
544 'Phone numbers (DIDs)' => [ $fsurl.'misc/phone_avail-import.html', '' ],
545 'Call Detail Records (CDRs)' => [ $fsurl.'misc/cdr-import.html', '' ],
547 if ( $conf->config('tax_data_vendor') eq 'cch' ) {
548 if ( $conf->exists('taxdatadirectdownload') ) {
549 $tools_importing{'Tax rates from vendor site'} =
550 [ $fsurl.'misc/tax-fetch_and_import.cgi', '' ];
552 $tools_importing{'Tax rates from CSV files'} =
553 [ $fsurl.'misc/tax-import.cgi', '' ];
557 tie my %tools_misc, 'Tie::IxHash', ();
558 $tools_misc{'Bulk DID Orders'} = [ $fsurl.'browse/did_order.html', 'View/manage bulk DID orders' ]
559 if $curuser->access_right('Import');
560 $tools_misc{'Business card scan'} = [ $fsurl.'edit/prospect_main-upload.html' ]
561 if $curuser->access_right('New prospect');
562 $tools_misc{'Time Queue'} = [ $fsurl.'search/report_timeworked.html', 'View pending support time' ]
563 if $curuser->access_right('Time queue');
565 #tie my %tools_exporting, 'Tie::IxHash',
566 # 'Download database dump' => [ $fsurl. 'misc/dump.cgi', '' ],
569 tie my %tools_ticketing_articles, 'Tie::IxHash',
570 'Overview' => [ $fsurl.'rt/Articles/index.html', '' ],
571 'Search' => [ $fsurl.'rt/Articles/Article/Search.html', '' ],
572 'Topics' => [ $fsurl.'rt/Articles/Topics.html', '' ],
575 tie my %tools_ticketing, 'Tie::IxHash',
576 'Articles' => [ \%tools_ticketing_articles, '' ],
577 'My Day' => [ $fsurl.'rt/Tools/MyDay.html', '' ],
578 'My Reminders' => [ $fsurl.'rt/Tools/MyReminders.html', '' ],
579 'Offline' => [ $fsurl.'rt/Tools/Offline.html', '' ],
580 'Approval' => [ $fsurl.'rt/Approvals/', '' ],
582 $tools_ticketing{'Cron Tool'} = [ $fsurl.'rt/Developer/CronTool/', '' ]
583 if $conf->exists('rt-crontool');
585 tie my %tools_system, 'Tie::IxHash', ();
586 $tools_system{'Status'} = [ $fsurl.'view/Status.html', 'System status' ]
587 if $curuser->access_right('Configuration'); # 'View system status');
588 $tools_system{'Job Queue'} = [ $fsurl.'search/queue.html', 'View pending job queue' ]
589 if $curuser->access_right('Job queue');
590 $tools_system{'Access log statistics'} = [ $fsurl.'search/report_access_user_log.html?group_by=path', '' ]
591 if $curuser->access_right('Configuration'); # 'View profiling data');
593 tie my %tools_menu, 'Tie::IxHash', ();
594 $tools_menu{'Customers'} = [ \%tools_customers, 'Customer tools' ]
595 if keys %tools_customers;
596 $tools_menu{'Billing'} = [ \%tools_billing, 'Payment and invoice tools' ]
597 if keys %tools_billing;
598 $tools_menu{'Ticketing'} = [ \%tools_ticketing, 'Ticketing tools' ]
599 if $conf->config('ticket_system');
600 $tools_menu{'Miscellaneous'} = [ \%tools_misc, '' ]
602 $tools_menu{'Importing'} = [ \%tools_importing, 'Import tools' ]
603 if $curuser->access_right('Import');
604 #$tools_menu{'Exporting'} = [ \%tools_exporting, 'Export tools' ]
605 # if $curuser->access_right('Export');
606 $tools_menu{'System'} = [ \%tools_system, 'System tools' ]
609 tie my %config_employees, 'Tie::IxHash',
610 'Employees' => [ $fsurl.'browse/access_user.html', 'Setup internal users' ],
611 'Employee groups and access control' => [ $fsurl.'browse/access_group.html', 'Employee groups allow you to control access to the backend' ],
612 'Installer availability' => [ $fsurl.'browse/sched_item.html', 'Installer availability' ],
615 tie my %config_dialup, 'Tie::IxHash',
616 'Access numbers' => [ $fsurl.'browse/svc_acct_pop.cgi', 'Points of Presence' ],
619 tie my %config_broadband, 'Tie::IxHash',
620 'Towers' => [ $fsurl.'browse/tower.html', 'Towers and sectors' ],
621 'Routers' => [ $fsurl.'browse/router.cgi', 'Broadband access routers' ],
622 'Address blocks' => [ $fsurl.'browse/addr_block.cgi', 'Manage address blocks and block assignments to broadband routers' ],
624 if ( $curuser->access_right('Broadband global configuration') ) {
625 $config_broadband{'Address ranges'} =
626 [ $fsurl.'browse/addr_range.html', 'Designate special address ranges' ];
629 tie my %config_phone, 'Tie::IxHash',
630 'View/Edit phone device types' => [ $fsurl.'browse/part_device.html', 'Phone device types' ],
631 'View/Edit bulk DID vendors' => [ $fsurl.'browse/did_vendor.html', 'Bulk DID vendors' ],
632 'View/Edit Carriers' => [ $fsurl.'browse/cdr_carrier.html', 'Carriers' ],
635 tie my %config_radius, 'Tie::IxHash',
636 'RADIUS Groups' => [ $fsurl.'browse/radius_group.html', 'Manage RADIUS groups' ],
637 'RADIUS Clients' => [ $fsurl.'browse/nas.html', 'Manage RADIUS clients' ],
640 tie my %config_cable, 'Tie::IxHash',
641 'Cable providers' => [ $fsurl.'browse/cable_provider.html', '' ],
642 'Cable modem models' => [ $fsurl.'browse/cable_model.html', '' ],
645 tie my %config_alarm, 'Tie::IxHash',
646 'Alarm system vendors' => [ $fsurl.'browse/alarm_system.html', '' ],
647 'Alarm system types' => [ $fsurl.'browse/alarm_type.html', '' ],
648 'Alarm central stations' => [ $fsurl.'browse/alarm_station.html', '' ],
651 tie my %config_conferencing, 'Tie::IxHash',
652 'Conferencing types' => [ $fsurl.'browse/conferencing_type.html', '' ],
653 'Quality levels' => [ $fsurl.'browse/conferencing_quality.html', '' ],
656 tie my %config_circuit, 'Tie::IxHash',
657 'Circuit types' => [ $fsurl.'browse/circuit_type.html', '' ],
658 'Circuit providers' => [ $fsurl.'browse/circuit_provider.html', '' ],
659 'Termination types' => [ $fsurl.'browse/circuit_termination.html', '' ],
662 tie my %config_fiber, 'Tie::IxHash',
663 'OLTs' => [ $fsurl.'browse/fiber_olt.html', '' ],
666 tie my %config_export_svc, 'Tie::IxHash', ();
667 if ( $curuser->access_right('Configuration') ) {
668 $config_export_svc{'Service definitions'} = [ $fsurl.'browse/part_svc.cgi', 'Services are items you offer to your customers' ];
669 $config_export_svc{'Service classes'} = [ $fsurl.'browse/part_svc_class.html', 'Services classes are user-defined, informational types for services' ];
670 $config_export_svc{'Service dependencies'} = [ $fsurl.'browse/part_svc_link.html', 'Services depencies define rules between service definitions' ];
671 $config_export_svc{'Provisioning exports'} = [ $fsurl.'browse/part_export.cgi', 'Provisioning services to external machines, databases and APIs' ];
673 $config_export_svc{'Dialup'} = [ \%config_dialup, '' ]
674 if $curuser->access_right('Dialup configuration');
675 $config_export_svc{'Wireless broadband'} = [ \%config_broadband, '' ]
676 if $curuser->access_right('Broadband configuration');
677 $config_export_svc{'Phone'} = [ \%config_phone, '' ]
678 if $curuser->access_right('Configuration');
679 $config_export_svc{'RADIUS'} = [ \%config_radius, '' ]
680 if $curuser->access_right('Configuration');
681 $config_export_svc{'Cable'} = [ \%config_cable, '' ]
682 if $curuser->access_right('Configuration');
683 $config_export_svc{'Conferencing'} = [ \%config_conferencing, '' ]
684 if $curuser->access_right('Configuration');
685 $config_export_svc{'Alarm'} = [ \%config_alarm, '' ]
686 if $curuser->access_right(['Alarm configuration', 'Alarm global configuration']);
687 $config_export_svc{'Circuits'} = [ \%config_circuit, '' ]
688 if $curuser->access_right('Configuration');
689 $config_export_svc{'Fiber'} = [ \%config_fiber, '' ]
690 if $curuser->access_right('Configuration');
691 $config_export_svc{'Hardware types'} = [ $fsurl.'browse/hardware_class.html', 'Set up hardware type catalog' ]
692 if $curuser->access_right('Configuration');
694 tie my %config_pkg_reason, 'Tie::IxHash',
695 'Cancel reasons' => [ $fsurl.'browse/reason_type.html?class=C', 'Cancel reasons explain why a service was cancelled.' ],
696 'Suspend reasons' => [ $fsurl.'browse/reason_type.html?class=S', 'Suspend reasons explain why a service was suspended.' ],
699 tie my %config_pkg, 'Tie::IxHash', ();
700 $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' ]
701 if $curuser->access_right('Edit package definitions')
702 || $curuser->access_right('Edit global package definitions');
703 if ( $curuser->access_right('Configuration') ) {
705 #package grouping sub-menu?
706 $config_pkg{'Package classes'} = [ $fsurl.'browse/pkg_class.html', 'Package classes define groups of packages, for taxation, ordering convenience and reporting.' ];
707 $config_pkg{'Package categories'} = [ $fsurl.'browse/pkg_category.html', 'Package categories define groups of package classes, for invoice sections.' ];
708 $config_pkg{'Package report classes'} = [ $fsurl.'browse/part_pkg_report_option.html', 'Package classes define optional groups of packages for reporting only.' ];
709 #eo package grouping sub-menu
711 if ( $curuser->access_right([ 'Edit fee definitions',
712 'Edit global fee definitions' ]) ) {
713 $config_pkg{'Fees'} = [ $fsurl.'browse/part_fee.html', '' ];
715 $config_pkg{'Discounts'} = [ $fsurl.'browse/discount.html', '' ];
716 $config_pkg{'Discount classes'} = [ $fsurl.'browse/discount_class.html', '' ];
717 $config_pkg{'Cancel/Suspend Reasons'} = [ \%config_pkg_reason, '' ];
720 tie my %config_cust, 'Tie::IxHash',
721 'Customer tags' => [ $fsurl.'browse/part_tag.html', '' ],
722 'Customer classes' => [ $fsurl.'browse/cust_class.html', 'Customer classes define groups of customers for reporting.' ],
723 'Customer categories' => [ $fsurl.'browse/cust_category.html', 'Customer categories define groups of customer classes.' ],
724 'separator' => '', #its a separator!
725 'Contact types' => [ $fsurl.'browse/contact_class.html', ''], #XXX useful description
728 $config_cust{'Note classes'} = [ $fsurl.'browse/cust_note_class.html', 'Note classes define groups of customer notes for reporting.' ];
730 tie my %config_agent, 'Tie::IxHash',
731 'Agent types' => [ $fsurl.'browse/agent_type.cgi', 'Agent types define groups of package definitions that you can then assign to particular agents' ],
732 '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)' ],
733 'Agent payment gateways' => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors for agent overrides' ];
736 tie my %config_sales, 'Tie::IxHash',
737 'Sales People' => [ $fsurl.'browse/sales.html', 'Sales people bring in new business.' ],
740 tie my %config_billing_rates, 'Tie::IxHash';
741 $config_billing_rates{'Rate plans'} = [ $fsurl.'browse/rate.cgi', 'Manage rate plans' ]
742 if $curuser->access_right('Edit CDR rates')
743 #|| $curuser->access_right('Edit global CDR rates')
744 || $curuser->access_right('Configuration');
745 if ( $curuser->access_right('Configuration') ) {
746 $config_billing_rates{'Regions and prefixes'} = [ $fsurl.'browse/rate_region.html', 'Manage regions and prefixes' ];
747 $config_billing_rates{'Usage classes'} = [ $fsurl.'browse/usage_class.html', 'Usage classes define groups of usage for taxation.' ];
748 $config_billing_rates{'Time periods'} = [ $fsurl.'browse/rate_time.html', 'Time periods define days and hours for rate plans' ];
749 $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" ?
750 $config_billing_rates{'separator'} = ''; #its a separator!
751 $config_billing_rates{'Tiering plans'} = [ $fsurl.'browse/rate_tier.html', 'Rating tiers' ];
754 tie my %config_billing, 'Tie::IxHash';
755 # 'Payment gateways' => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors' ];
756 $config_billing{'Billing events'} = [ $fsurl.'browse/part_event.html', 'Billing actions for customers, invoices and packages' ]
757 if $curuser->access_right('Edit billing events')
758 || $curuser->access_right('Edit global billing events');
759 if ( $curuser->access_right('Configuration') ) {
760 $config_billing{'Invoice configurations'} = [ $fsurl.'browse/invoice_conf.html', 'Adjust invoice settings for special-purpose notices' ];
761 $config_billing{'Invoice templates'} = [ $fsurl.'browse/invoice_template.html', 'Edit templates for HTML, plaintext and typeset invoices' ];
762 $config_billing{'separator'} = ''; #its a separator!
763 $config_billing{'Prepaid cards'} = [ $fsurl.'search/prepay_credit.html', 'View outstanding cards, generate new cards' ];
765 $config_billing{'Call rates and regions'} = [ \%config_billing_rates, 'Manage rate plans, regions and prefixes for VoIP and call billing' ]
766 if keys %config_billing_rates;
767 if ( $curuser->access_right('Configuration') ) {
768 $config_billing{'separator2'} = ''; #its a separator!
770 my $config_taxes_name = 'Locales and tax rates'.
771 ( $conf->config('tax_data_vendor')
772 ? ' (internal tax class system)'
775 $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' ];
776 $config_billing{'Tax rates (vendor data tax products system)'} = [ $fsurl.'browse/tax_rate.cgi', 'Edit tax rates for the vendor data tax products system' ]
777 if $conf->config('tax_data_vendor');
778 $config_billing{'Tax classes'} = [ $fsurl. 'browse/part_pkg_taxclass.html', 'Tax classes' ];
780 if ( $conf->config('currencies') ) {
781 $config_billing{'separator3'} = ''; #its a separator!
782 $config_billing{'Exchange rates'} = [ $fsurl.'edit/currency_exchange.html', 'Currency exchange rates' ];
785 $config_billing{'separator4'} = ''; #its a separator!
786 $config_billing{'Credit reasons'} = [ $fsurl.'browse/reason_type.html?class=R', 'Credit reasons explain why a credit was issued.' ];
788 $config_billing{'Refund reasons'} = [ $fsurl.'browse/reason_type.html?class=F', 'Refund reasons explain why a refund was issued.' ];
790 $config_billing{'Invoice void reasons'} = [ $fsurl.'browse/reason_type.html?class=I', 'Invoice void reasons explain why an invoice was voided.' ];
791 $config_billing{'Payment void reasons'} = [ $fsurl.'browse/reason_type.html?class=P', 'Payment void reasons explain why a payment was voided.' ];
792 $config_billing{'Credit void reasons'} = [ $fsurl.'browse/reason_type.html?class=X', 'Credit void reasons explain why a credit was voided.' ];
795 #XXX also to be unified
796 tie my %config_ticketing_groups, 'Tie::IxHash',
797 'Select' => [ $fsurl.'rt/Admin/Groups', '' ],
798 'Create' => [ $fsurl.'rt/Admin/Groups/Modify.html?Create=1', '' ],
801 tie my %config_ticketing_queues, 'Tie::IxHash',
802 'Select' => [ $fsurl.'rt/Admin/Queues', '' ],
803 'Create' => [ $fsurl.'rt/Admin/Queues/Modify.html?Create=1', '' ],
806 tie my %config_ticketing_customfields, 'Tie::IxHash',
807 'Select' => [ $fsurl.'rt/Admin/CustomFields', '' ],
808 'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1', '' ],
811 tie my %config_ticketing_articles_classes, 'Tie::IxHash',
812 'Select' => [ $fsurl.'rt/Admin/Articles/Classes/', '' ],
813 'Create' => [ $fsurl.'rt/Admin/Articles/Classes/Modify.html?Create=1', '' ],
816 tie my %config_ticketing_articles_customfields, 'Tie::IxHash',
817 'Select' => [ $fsurl.'rt/Admin/CustomFields/index.html?type=RT%3A%3AClass-RT%3A%3AArticle', '' ],
818 'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1&LookupType=RT%3A%3AClass-RT%3A%3AArticle', '' ],
821 tie my %config_ticketing_articles, 'Tie::IxHash',
822 'Classes' => [ \%config_ticketing_articles_classes, '' ],
823 'Custom Fields' => [ \%config_ticketing_articles_customfields, '' ],
826 tie my %config_ticketing, 'Tie::IxHash',
827 'Ticketing Users' => [ $fsurl.'rt/Admin/Users', 'Edit ticketing users' ], #XXX to be unified
828 'Ticketing Groups' => [ \%config_ticketing_groups, 'View/Edit ticketing groups and group membership' ], #XXX to be unified
829 'Ticketing Queues' => [ \%config_ticketing_queues, 'View/Edit ticketing queues and queue-specific properties' ],
830 'Ticket Custom Fields' => [ \%config_ticketing_customfields, 'View/Edit ticketing custom fields' ],
831 'Ticketing Global' => [ $fsurl.'rt/Admin/Global', 'View/Edit ticketing configuration applicable to all queues' ], #XXX the individual items
832 'Ticketing Articles' => [ \%config_ticketing_articles, '' ],
833 #"System Configuraiton"? useless, just makes people report errors about missing Module::Versions::Report #'Ticketing Tools' => [ $fsurl.'rt/Admin/Tools', '' ],
836 tie my %config_nms, 'Tie::IxHash',
837 'View/Edit virtual ports' => [ $fsurl.'browse/torrus_srvderive.html', '' ],
840 tie my %config_misc, 'Tie::IxHash';
841 $config_misc{'Message templates'} = [ $fsurl.'browse/msg_template/email.html', 'Templates for customer notices' ]
842 if $curuser->access_right(['View templates', 'View global templates',
843 'Edit templates', 'Edit global templates', ]);
844 $config_misc{'Advertising sources'} = [ $fsurl.'browse/part_referral.html', 'Where a customer heard about your service.' ]
845 if $curuser->access_right('Edit advertising sources')
846 || $curuser->access_right('Edit global advertising sources');
847 $config_misc{'Custom fields'} = [ $fsurl.'browse/part_virtual_field.html', 'Locally defined fields', ]
848 if $curuser->access_right('Edit custom fields');
849 $config_misc{'Translation strings'} = [ $fsurl.'browse/msgcat.html', 'Translations and other customizable labels for each locale' ]
850 if $curuser->access_right('Configuration');
851 $config_misc{'Inventory classes and inventory'} = [ $fsurl.'browse/inventory_class.html', 'Setup inventory classes and stock inventory' ]
852 if $curuser->access_right('Edit inventory')
853 || $curuser->access_right('Edit global inventory')
854 || $curuser->access_right('Configuration');
856 $config_misc{'Upload targets'} = [ $fsurl.'browse/upload_target.html', 'Billing and payment upload destinations' ]
857 if $curuser->access_right('Configuration');
859 $config_misc{'System log emails'} = [ $fsurl.'browse/log_email.html', 'Configure conditions for sending email when logging' ]
860 if $curuser->access_right('View system logs')
861 || $curuser->access_right('Configuration');
863 tie my %config_menu, 'Tie::IxHash';
864 if ( $curuser->access_right('Configuration' ) ) {
866 'Settings' => [ $fsurl.'config/config-view.cgi', '' ],
867 'separator' => '', #its a separator!
868 'Companies' => [ \%config_agent, '' ],
872 $config_menu{'Sales People'} = [ \%config_sales, '' ]
873 if $curuser->access_right('Edit sales people');
875 if ( $curuser->access_right('Configuration' ) ) {
876 $config_menu{'Employees'} = [ \%config_employees, '' ];
877 $config_menu{'separator2'} = ''; #its a separator!
878 $config_menu{'Customers'} = [ \%config_cust, '' ];
879 #or this? 'Customers and Contacts'
882 $config_menu{'Packages'} = [ \%config_pkg, '' ]
883 if $curuser->access_right('Configuration' )
884 || $curuser->access_right('Edit package definitions')
885 || $curuser->access_right('Edit global package definitions');
887 if ( $curuser->access_right('Configuration') ) {
888 $config_menu{'Services'} = [ \%config_export_svc, '' ];
889 $config_menu{separator3} = '';
892 tie my %config_vendor, 'Tie::IxHash',
893 'Vendor classes' => [ $fsurl.'browse/vend_class.html', '' ],
894 'Vendors' => [ $fsurl.'browse/vend_main.html', '' ],
897 if ( $curuser->access_right('Configuration') ) {
898 $config_menu{'Vendors'} = [ \%config_vendor, '' ];
899 $config_menu{separator4} = '';
902 $config_menu{'Billing'} = [ \%config_billing, '' ]
903 if keys %config_billing;
904 $config_menu{'Ticketing'} = [ \%config_ticketing, '' ]
905 if $conf->config('ticket_system')
906 && eval { FS::TicketSystem->access_right(\%session, 'ShowConfigTab') };
907 $config_menu{'Network Monitoring'} = [ \%config_nms, '' ]
908 if $curuser->access_right('Configure network monitoring')
909 && $conf->config('network_monitoring_system') eq 'Torrus_Internal';
911 if ( $curuser->access_right([ 'Configuration',
913 'View global templates',
915 'Edit global templates',
918 $config_menu{separator9} = '' if keys %config_menu;
919 $config_menu{'Miscellaneous'} = [ \%config_misc, '' ];
923 my $wiki = 'http://www.freeside.biz/mediawiki/index.php';
924 my $doc_link = $conf->config('support-key')
925 ? "$wiki/Supported:Documentation"
926 : $curuser->access_right('Configuration')
927 ? "$wiki/Freeside:4:Documentation"
928 : "$wiki/Freeside:2.1:Documentation:User"; #no page for other versions yet :/
931 if $conf->config('ticket_system') eq 'RT_Internal';
933 tie my %help_menu, 'Tie::IxHash';
934 my $agentnum = $conf->config('brand-agent');
936 my $company_name = $conf->config('company_name', $agentnum);
937 $help_menu{"About $company_name"} = [ "javascript:about_freeside()", '' ];
939 $help_menu{'Billing documentation'} = [ $doc_link, 'Freeside documentation' ];
940 $help_menu{'Ticketing documentation'} = [ 'http://wiki.bestpractical.com/', 'Request Tracker Wiki' ]
941 if $conf->config('ticket_system') eq 'RT_Internal';
942 $help_menu{'Networking monitoring documentation'} = [ 'http://torrus.org/userguide.pod.html', 'Torrus User Guide' ]
943 if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
944 $help_menu{'Developer documentation'} = [ "${fsurl}docs/library/FS.html", 'Developer documentation' ];
945 $help_menu{'separator'} = '';
946 $help_menu{"About Freeside v$FS::VERSION"} = [ "javascript:about_freeside()", '' ];
947 $help_menu{"About RT v$RT::VERSION"} = [ 'http://www.bestpractical.com/rt', 'Request Tracker Homepage' ]
948 if $conf->config('ticket_system') eq 'RT_Internal';
949 $help_menu{"About Torrus v1.0.9"} = [ 'http://www.torrus.org/', 'Torrus Homepage' ] #XXX manual version
950 if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
954 tie my %menu, 'Tie::IxHash';
956 if ( $conf->config('menu-prepend_links')) {
957 my @links = split(/\n/, $conf->config('menu-prepend_links'));
958 foreach my $link (@links) {
959 $link =~ /^\s*(\S+)\s+(.*?)(\s*\(([^\)]*)\))?$/ or next;
960 my($url, $label, $alt) = ($1, $2, $4);
961 $menu{$label} = [ $url, $alt ];
965 $menu{'Billing Main'} = [ $fsurl, 'Billing start page', ];
967 if ( $conf->config('ticket_system') ) {
968 $menu{'Ticketing Main'} =
970 ( $conf->config('ticket_system') eq 'RT_External'
971 ? FS::TicketSystem->baseurl()
974 'Ticketing start page',
978 if ( $conf->config('network_monitoring_system') eq 'Torrus_Internal' &&
979 $curuser->access_right('Configure network monitoring') ) {
980 $menu{'Network Main'} =
981 [ $fsurl.'torrus/main', 'Network monitoring start page' ],
984 $menu{'New prospect'} = [ $fsurl.'edit/prospect_main.html', 'Add a new prospect' ]
985 if $curuser->access_right('New prospect');
986 $menu{'New customer'} = [ $fsurl.'edit/cust_main.cgi', 'Add a new customer' ]
987 if $curuser->access_right('New customer');
988 $menu{'Reports'} = [ \%report_menu, 'Lists, reporting and graphing' ]
989 if keys %report_menu;
990 $menu{'Tools'} = [ \%tools_menu, 'Tools' ]
992 $menu{'Configuration'} = [ \%config_menu, 'Configuration and setup' ]
993 if $curuser->access_right([ 'Configuration',
994 'Edit package definitions',
995 'Edit global package definitions',
996 'Edit billing events',
997 'Edit global billing events',
998 'Dialup configuration',
999 'Wireless broadband configuration',
1000 'Phone configuration',
1001 'Alarm configuration',
1002 'Alarm global configuration',
1003 'Edit advertising sources',
1004 'Edit global advertising sources',
1006 'View global templates',
1008 'Edit global templates',
1010 $menu{'Help'} = [ \%help_menu, '' ];
1013 use vars qw($gmenunum);
1017 my($submenu, $title) = @_;
1018 my $menunum = $gmenunum++;
1020 #return two args: html, menuname
1022 "var myMenu$menunum = new WebFXMenu;\n".
1023 #"myMenu$menunum.useAutoPosition = true;\n".
1024 # "myMenu$menunum.emptyText = '$title';\n".
1025 "myMenu$menunum.emptyText = '';\n".
1030 if ( !ref( $submenu->{$_} ) ) {
1032 "myMenu$menunum.add(new WebFXMenuSeparator());";
1036 my($url_or_submenu, $tooltip ) = @{ $submenu->{$_} };
1037 if ( ref($url_or_submenu) ) {
1039 my($subhtml, $submenuname ) = submenu($url_or_submenu, $_); #mmm, recursion
1042 "myMenu$menunum.add(new WebFXMenuItem(\"".mt($_)."\", null, \"".mt($tooltip)."\", $submenuname ));";
1046 "myMenu$menunum.add(new WebFXMenuItem(\"".mt($_)."\", \"$url_or_submenu\", \"".mt($tooltip)."\" ));";
1054 "myMenu$menunum.width = 256;\n",