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{'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_employee, 'Tie::IxHash',
472 'Employee activity' => [ $fsurl.'search/report_employee_audit.html', '' ],
473 'Employee sessions' => [ $fsurl.'search/report_access_user_session_log.html', '' ],
474 'Access log statistics' => [ $fsurl.'search/report_access_user_log.html?group_by=path', '' ],
477 tie my %report_menu, 'Tie::IxHash';
478 $report_menu{'Saved searches'} = [ \%report_saved_searches, 'My saved searches' ]
479 if keys(%report_saved_searches);
480 $report_menu{'Prospects'} = [ \%report_prospects, 'Prospect reports' ]
481 if $curuser->access_right('List prospects')
482 || $curuser->access_right('List contacts');
483 $report_menu{'Quotations'} = [ \%report_quotations, 'Quotation reports' ]
484 if $curuser->access_right('List quotations');
485 $report_menu{'Customers'} = [ \%report_customers, 'Customer reports' ]
486 if $curuser->access_right('List customers')
487 || $curuser->access_right('List contacts')
488 || $curuser->access_right('Advanced customer search')
489 || $curuser->access_right('List zip codes')
490 || $curuser->access_right('Financial reports')
491 || $curuser->access_right('Customers: Customer churn report');
492 $report_menu{'Invoices'} = [ \%report_invoices, 'Invoice reports' ]
493 if $curuser->access_right('List invoices');
494 $report_menu{'Discounts'} = [ \%report_discounts, 'Discount reports' ]
495 if $curuser->access_right('Financial reports');
496 $report_menu{'Payments'} = [ \%report_payments, 'Payment reports' ]
497 if keys %report_payments;
498 $report_menu{'Packages'} = [ \%report_packages, 'Package reports' ]
499 if $curuser->access_right('List packages');
500 $report_menu{'Services'} = [ \%report_services, 'Services reports' ]
501 if $curuser->access_right('List services');
502 $report_menu{'Inventory'} = [ \%report_inventory, 'Inventory reports' ]
503 if $curuser->access_right('Configuration'); #XXX List inventory?
504 $report_menu{'Usage'} = [ \%report_rating, 'Usage reports' ]
505 if $curuser->access_right('List rating data');
506 $report_menu{'Tickets'} = [ \%report_ticketing, 'Ticket reports' ]
507 if $conf->config('ticket_system')
508 ;#&& FS::TicketSystem->access_right(\%session, 'Something');
509 $report_menu{'Financial (Receivables)'} = [ \%report_financial, 'Financial reports (Receivables)' ]
510 if $curuser->access_right('Financial reports')
511 or $curuser->access_right('Receivables report');
512 $report_menu{'Financial (Payables)'} = [ \%report_payable, 'Financial reports (Payables)' ]
513 if $curuser->access_right('Financial reports');
515 $report_menu{'Employees'} = [ \%report_employee, 'Employee reports' ]
516 if $curuser->access_right('Employee Reports');
517 $report_menu{'Logs'} = [ \%report_logs, 'System and email logs' ]
518 if (keys %report_logs); # empty if the user has no rights to it
519 $report_menu{'SQL Query'} = [ $fsurl.'search/report_sql.html', 'SQL Query']
520 if $curuser->access_right('Raw SQL');
522 tie my %tools_customers, 'Tie::IxHash', ();
523 $tools_customers{'Appointments'} = [ $fsurl.'rt/Search/Schedule.html?LengthMin=0', 'View appointment schedule' ]
524 if $curuser->access_right('View appointments');
525 $tools_customers{'Attachments'} = [ $fsurl.'search/report_cust_attachment.html', 'View customer attachments' ]
526 if !$conf->config('disable_cust_attachment') and $curuser->access_right('View attachments') and $curuser->access_right('Browse attachments');
527 $tools_customers{'Customer email settings'} = [ $fsurl.'misc/manage_cust_email.html' ]
528 if $curuser->access_right('Edit customer');
530 tie my %tools_billing, 'Tie::IxHash', ();
531 $tools_billing{'Quick payment entry'} = [ $fsurl.'misc/batch-cust_pay.html', 'Enter multiple payments in a batch' ]
532 if $curuser->access_right('Post payment batch');
533 $tools_billing{'Process payment batches'} = [ $fsurl.'search/pay_batch.cgi?magic=_date;open=1;intransit=1', 'Process credit card and electronic check batches' ]
534 if ( $conf->exists('batch-enable') || $conf->config('batch-enable_payby') )
535 && $curuser->access_right('Process batches');
536 $tools_billing{'Download invoice batches'} = [ $fsurl.'search/bill_batch.cgi' ]
537 if $curuser->access_right('Process invoice batches')
538 || $curuser->access_right('Process global invoice batches')
539 || $curuser->access_right('Configuration'); #XXX remove in 2.5
540 #now there's a standalone event#if $conf->exists('invoice_print_pdf');
542 tie my %tools_importing, 'Tie::IxHash',
543 'Customers' => [ $fsurl.'misc/cust_main-import.cgi', '' ],
544 'Package definitions' => [ $fsurl.'misc/part_pkg-import.html', '' ],
545 'Customer packages' => [ $fsurl.'misc/cust_pkg-import.html', '' ],
546 # 'Customer broadband services' => [ $fsurl.'misc/svc_broadband-import.html', '' ],
547 'Customer notes' => [ $fsurl.'misc/cust_main_note-import.html', '' ],
548 'Customer contacts' => [ $fsurl.'misc/contact-import.cgi', '' ],
549 'One-time charges' => [ $fsurl.'misc/cust_main-import_charges.cgi', '' ],
550 'Payments' => [ $fsurl.'misc/cust_pay-import.cgi', '' ],
551 'Credits' => [ $fsurl.'misc/cust_credit-import.html', '' ],
552 'Phone numbers (DIDs)' => [ $fsurl.'misc/phone_avail-import.html', '' ],
553 'Call Detail Records (CDRs)' => [ $fsurl.'misc/cdr-import.html', '' ],
555 if ( $conf->config('tax_data_vendor') ) {
556 if ( $conf->exists('taxdatadirectdownload') ) {
557 $tools_importing{'Tax rates from vendor site'} =
558 [ $fsurl.'misc/tax-fetch_and_import.cgi', '' ];
560 $tools_importing{'Tax rates from CSV files'} =
561 [ $fsurl.'misc/tax-import.cgi', '' ];
565 tie my %tools_misc, 'Tie::IxHash', ();
566 $tools_misc{'Bulk DID Orders'} = [ $fsurl.'browse/did_order.html', 'View/manage bulk DID orders' ]
567 if $curuser->access_right('Import');
568 $tools_misc{'Business card scan'} = [ $fsurl.'edit/prospect_main-upload.html' ]
569 if $curuser->access_right('New prospect');
570 $tools_misc{'Time Queue'} = [ $fsurl.'search/report_timeworked.html', 'View pending support time' ]
571 if $curuser->access_right('Time queue');
573 #tie my %tools_exporting, 'Tie::IxHash',
574 # 'Download database dump' => [ $fsurl. 'misc/dump.cgi', '' ],
577 tie my %tools_ticketing_articles, 'Tie::IxHash',
578 'Overview' => [ $fsurl.'rt/Articles/index.html', '' ],
579 'Search' => [ $fsurl.'rt/Articles/Article/Search.html', '' ],
580 'Topics' => [ $fsurl.'rt/Articles/Topics.html', '' ],
583 tie my %tools_ticketing, 'Tie::IxHash',
584 'Articles' => [ \%tools_ticketing_articles, '' ],
585 'My Day' => [ $fsurl.'rt/Tools/MyDay.html', '' ],
586 'My Reminders' => [ $fsurl.'rt/Tools/MyReminders.html', '' ],
587 'Offline' => [ $fsurl.'rt/Tools/Offline.html', '' ],
588 'Approval' => [ $fsurl.'rt/Approvals/', '' ],
590 $tools_ticketing{'Cron Tool'} = [ $fsurl.'rt/Developer/CronTool/', '' ]
591 if $conf->exists('rt-crontool');
593 tie my %tools_system, 'Tie::IxHash', ();
594 $tools_system{'Status'} = [ $fsurl.'view/Status.html', 'System status' ]
595 if $curuser->access_right('Configuration'); # 'View system status');
596 $tools_system{'Job Queue'} = [ $fsurl.'search/queue.html', 'View pending job queue' ]
597 if $curuser->access_right('Job queue');
599 tie my %tools_menu, 'Tie::IxHash', ();
600 $tools_menu{'Customers'} = [ \%tools_customers, 'Customer tools' ]
601 if keys %tools_customers;
602 $tools_menu{'Billing'} = [ \%tools_billing, 'Payment and invoice tools' ]
603 if keys %tools_billing;
604 $tools_menu{'Ticketing'} = [ \%tools_ticketing, 'Ticketing tools' ]
605 if $conf->config('ticket_system');
606 $tools_menu{'Miscellaneous'} = [ \%tools_misc, '' ]
608 $tools_menu{'Importing'} = [ \%tools_importing, 'Import tools' ]
609 if $curuser->access_right('Import');
610 #$tools_menu{'Exporting'} = [ \%tools_exporting, 'Export tools' ]
611 # if $curuser->access_right('Export');
612 $tools_menu{'System'} = [ \%tools_system, 'System tools' ]
615 tie my %config_employees, 'Tie::IxHash',
616 'Employees' => [ $fsurl.'browse/access_user.html', 'Setup internal users' ],
617 'Employee groups and access control' => [ $fsurl.'browse/access_group.html', 'Employee groups allow you to control access to the backend' ],
618 'Installer availability' => [ $fsurl.'browse/sched_item.html', 'Installer availability' ],
621 tie my %config_dialup, 'Tie::IxHash',
622 'Access numbers' => [ $fsurl.'browse/svc_acct_pop.cgi', 'Points of Presence' ],
625 tie my %config_broadband, 'Tie::IxHash',
626 'Towers' => [ $fsurl.'browse/tower.html', 'Towers and sectors' ],
627 'Routers' => [ $fsurl.'browse/router.cgi', 'Broadband access routers' ],
628 'Address blocks' => [ $fsurl.'browse/addr_block.cgi', 'Manage address blocks and block assignments to broadband routers' ],
630 if ( $curuser->access_right('Broadband global configuration') ) {
631 $config_broadband{'Address ranges'} =
632 [ $fsurl.'browse/addr_range.html', 'Designate special address ranges' ];
635 tie my %config_phone, 'Tie::IxHash',
636 'View/Edit phone device types' => [ $fsurl.'browse/part_device.html', 'Phone device types' ],
637 'View/Edit bulk DID vendors' => [ $fsurl.'browse/did_vendor.html', 'Bulk DID vendors' ],
638 'View/Edit Carriers' => [ $fsurl.'browse/cdr_carrier.html', 'Carriers' ],
641 tie my %config_radius, 'Tie::IxHash',
642 'RADIUS Groups' => [ $fsurl.'browse/radius_group.html', 'Manage RADIUS groups' ],
643 'RADIUS Clients' => [ $fsurl.'browse/nas.html', 'Manage RADIUS clients' ],
646 tie my %config_cable, 'Tie::IxHash',
647 'Cable providers' => [ $fsurl.'browse/cable_provider.html', '' ],
648 'Cable modem models' => [ $fsurl.'browse/cable_model.html', '' ],
651 tie my %config_alarm, 'Tie::IxHash',
652 'Alarm system vendors' => [ $fsurl.'browse/alarm_system.html', '' ],
653 'Alarm system types' => [ $fsurl.'browse/alarm_type.html', '' ],
654 'Alarm central stations' => [ $fsurl.'browse/alarm_station.html', '' ],
657 tie my %config_conferencing, 'Tie::IxHash',
658 'Conferencing types' => [ $fsurl.'browse/conferencing_type.html', '' ],
659 'Quality levels' => [ $fsurl.'browse/conferencing_quality.html', '' ],
662 tie my %config_circuit, 'Tie::IxHash',
663 'Circuit types' => [ $fsurl.'browse/circuit_type.html', '' ],
664 'Circuit providers' => [ $fsurl.'browse/circuit_provider.html', '' ],
665 'Termination types' => [ $fsurl.'browse/circuit_termination.html', '' ],
668 tie my %config_fiber, 'Tie::IxHash',
669 'OLTs' => [ $fsurl.'browse/fiber_olt.html', '' ],
672 tie my %config_export_svc, 'Tie::IxHash', ();
673 if ( $curuser->access_right('Configuration') ) {
674 $config_export_svc{'Service definitions'} = [ $fsurl.'browse/part_svc.cgi', 'Services are items you offer to your customers' ];
675 $config_export_svc{'Service classes'} = [ $fsurl.'browse/part_svc_class.html', 'Services classes are user-defined, informational types for services' ];
676 $config_export_svc{'Service dependencies'} = [ $fsurl.'browse/part_svc_link.html', 'Services depencies define rules between service definitions' ];
677 $config_export_svc{'Provisioning exports'} = [ $fsurl.'browse/part_export.cgi', 'Provisioning services to external machines, databases and APIs' ];
679 $config_export_svc{'Dialup'} = [ \%config_dialup, '' ]
680 if $curuser->access_right('Dialup configuration');
681 $config_export_svc{'Wireless broadband'} = [ \%config_broadband, '' ]
682 if $curuser->access_right('Broadband configuration');
683 $config_export_svc{'Phone'} = [ \%config_phone, '' ]
684 if $curuser->access_right('Configuration');
685 $config_export_svc{'RADIUS'} = [ \%config_radius, '' ]
686 if $curuser->access_right('Configuration');
687 $config_export_svc{'Cable'} = [ \%config_cable, '' ]
688 if $curuser->access_right('Configuration');
689 $config_export_svc{'Conferencing'} = [ \%config_conferencing, '' ]
690 if $curuser->access_right('Configuration');
691 $config_export_svc{'Alarm'} = [ \%config_alarm, '' ]
692 if $curuser->access_right(['Alarm configuration', 'Alarm global configuration']);
693 $config_export_svc{'Circuits'} = [ \%config_circuit, '' ]
694 if $curuser->access_right('Configuration');
695 $config_export_svc{'Fiber'} = [ \%config_fiber, '' ]
696 if $curuser->access_right('Configuration');
697 $config_export_svc{'Hardware types'} = [ $fsurl.'browse/hardware_class.html', 'Set up hardware type catalog' ]
698 if $curuser->access_right('Edit hardware classes and types');
700 tie my %config_pkg_reason, 'Tie::IxHash',
701 'Cancel reasons' => [ $fsurl.'browse/reason_type.html?class=C', 'Cancel reasons explain why a service was cancelled.' ],
702 'Suspend reasons' => [ $fsurl.'browse/reason_type.html?class=S', 'Suspend reasons explain why a service was suspended.' ],
705 tie my %config_pkg, 'Tie::IxHash', ();
706 $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' ]
707 if $curuser->access_right('Edit package definitions')
708 || $curuser->access_right('Edit global package definitions');
709 if ( $curuser->access_right('Configuration') ) {
711 #package grouping sub-menu?
712 $config_pkg{'Package classes'} = [ $fsurl.'browse/pkg_class.html', 'Package classes define groups of packages, for taxation, ordering convenience and reporting.' ];
713 $config_pkg{'Package categories'} = [ $fsurl.'browse/pkg_category.html', 'Package categories define groups of package classes, for invoice sections.' ];
714 $config_pkg{'Package report classes'} = [ $fsurl.'browse/part_pkg_report_option.html', 'Package classes define optional groups of packages for reporting only.' ];
715 #eo package grouping sub-menu
717 if ( $curuser->access_right([ 'Edit fee definitions',
718 'Edit global fee definitions' ]) ) {
719 $config_pkg{'Fees'} = [ $fsurl.'browse/part_fee.html', '' ];
721 $config_pkg{'Discounts'} = [ $fsurl.'browse/discount.html', '' ];
722 $config_pkg{'Discount classes'} = [ $fsurl.'browse/discount_class.html', '' ];
723 $config_pkg{'Cancel/Suspend Reasons'} = [ \%config_pkg_reason, '' ];
726 tie my %config_cust, 'Tie::IxHash',
727 'Customer tags' => [ $fsurl.'browse/part_tag.html', '' ],
728 'Customer classes' => [ $fsurl.'browse/cust_class.html', 'Customer classes define groups of customers for reporting.' ],
729 'Customer categories' => [ $fsurl.'browse/cust_category.html', 'Customer categories define groups of customer classes.' ],
730 'separator' => '', #its a separator!
731 'Contact types' => [ $fsurl.'browse/contact_class.html', ''], #XXX useful description
734 $config_cust{'Note classes'} = [ $fsurl.'browse/cust_note_class.html', 'Note classes define groups of customer notes for reporting.' ];
736 tie my %config_agent, 'Tie::IxHash',
737 'Agent types' => [ $fsurl.'browse/agent_type.cgi', 'Agent types define groups of package definitions that you can then assign to particular agents' ],
738 '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)' ],
739 'Agent payment gateways' => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors for agent overrides' ],
741 'Commission schedules' => [ $fsurl.'browse/commission_schedule.html',
742 'Commission schedules for consecutive billing periods' ],
745 tie my %config_sales, 'Tie::IxHash',
746 'Sales People' => [ $fsurl.'browse/sales.html', 'Sales people bring in new business.' ],
749 tie my %config_billing_rates, 'Tie::IxHash';
750 $config_billing_rates{'Rate plans'} = [ $fsurl.'browse/rate.cgi', 'Manage rate plans' ]
751 if $curuser->access_right('Edit CDR rates')
752 #|| $curuser->access_right('Edit global CDR rates')
753 || $curuser->access_right('Configuration');
754 if ( $curuser->access_right('Configuration') ) {
755 $config_billing_rates{'Regions and prefixes'} = [ $fsurl.'browse/rate_region.html', 'Manage regions and prefixes' ];
756 $config_billing_rates{'Usage classes'} = [ $fsurl.'browse/usage_class.html', 'Usage classes define groups of usage for taxation.' ];
757 $config_billing_rates{'Time periods'} = [ $fsurl.'browse/rate_time.html', 'Time periods define days and hours for rate plans' ];
758 $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" ?
759 $config_billing_rates{'separator'} = ''; #its a separator!
760 $config_billing_rates{'Tiering plans'} = [ $fsurl.'browse/rate_tier.html', 'Rating tiers' ];
763 tie my %config_billing, 'Tie::IxHash';
764 # 'Payment gateways' => [ $fsurl.'browse/payment_gateway.html', 'Credit card and electronic check processors' ];
765 $config_billing{'Billing events'} = [ $fsurl.'browse/part_event.html', 'Billing actions for customers, invoices and packages' ]
766 if $curuser->access_right('Edit billing events')
767 || $curuser->access_right('Edit global billing events');
768 if ( $curuser->access_right('Configuration') ) {
769 $config_billing{'Invoice configurations'} = [ $fsurl.'browse/invoice_conf.html', 'Adjust invoice settings for special-purpose notices' ];
770 $config_billing{'Invoice templates'} = [ $fsurl.'browse/invoice_template.html', 'Edit templates for HTML, plaintext and typeset invoices' ];
771 $config_billing{'separator'} = ''; #its a separator!
772 $config_billing{'Prepaid cards'} = [ $fsurl.'search/prepay_credit.html', 'View outstanding cards, generate new cards' ];
774 $config_billing{'Call rates and regions'} = [ \%config_billing_rates, 'Manage rate plans, regions and prefixes for VoIP and call billing' ]
775 if keys %config_billing_rates;
776 if ( $curuser->access_right('Configuration') ) {
777 $config_billing{'separator2'} = ''; #its a separator!
779 my $config_taxes_name = 'Locales and tax rates'.
780 ( $conf->config('tax_data_vendor')
781 ? ' (internal tax class system)'
784 $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' ];
785 $config_billing{'Tax rates (vendor data tax products system)'} = [ $fsurl.'browse/tax_rate.cgi', 'Edit tax rates for the vendor data tax products system' ]
786 if $conf->config('tax_data_vendor');
787 $config_billing{'Tax classes'} = [ $fsurl. 'browse/part_pkg_taxclass.html', 'Tax classes' ];
789 if ( $conf->config('currencies') ) {
790 $config_billing{'separator3'} = ''; #its a separator!
791 $config_billing{'Exchange rates'} = [ $fsurl.'edit/currency_exchange.html', 'Currency exchange rates' ];
794 $config_billing{'separator4'} = ''; #its a separator!
795 $config_billing{'Credit reasons'} = [ $fsurl.'browse/reason_type.html?class=R', 'Credit reasons explain why a credit was issued.' ];
797 $config_billing{'Refund reasons'} = [ $fsurl.'browse/reason_type.html?class=F', 'Refund reasons explain why a refund was issued.' ];
799 $config_billing{'Invoice void reasons'} = [ $fsurl.'browse/reason_type.html?class=I', 'Invoice void reasons explain why an invoice was voided.' ];
800 $config_billing{'Payment void reasons'} = [ $fsurl.'browse/reason_type.html?class=P', 'Payment void reasons explain why a payment was voided.' ];
801 $config_billing{'Credit void reasons'} = [ $fsurl.'browse/reason_type.html?class=X', 'Credit void reasons explain why a credit was voided.' ];
804 #XXX also to be unified
805 tie my %config_ticketing_groups, 'Tie::IxHash',
806 'Select' => [ $fsurl.'rt/Admin/Groups', '' ],
807 'Create' => [ $fsurl.'rt/Admin/Groups/Modify.html?Create=1', '' ],
810 tie my %config_ticketing_queues, 'Tie::IxHash',
811 'Select' => [ $fsurl.'rt/Admin/Queues', '' ],
812 'Create' => [ $fsurl.'rt/Admin/Queues/Modify.html?Create=1', '' ],
815 tie my %config_ticketing_customfields, 'Tie::IxHash',
816 'Select' => [ $fsurl.'rt/Admin/CustomFields', '' ],
817 'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1', '' ],
820 tie my %config_ticketing_articles_classes, 'Tie::IxHash',
821 'Select' => [ $fsurl.'rt/Admin/Articles/Classes/', '' ],
822 'Create' => [ $fsurl.'rt/Admin/Articles/Classes/Modify.html?Create=1', '' ],
825 tie my %config_ticketing_articles_customfields, 'Tie::IxHash',
826 'Select' => [ $fsurl.'rt/Admin/CustomFields/index.html?type=RT%3A%3AClass-RT%3A%3AArticle', '' ],
827 'Create' => [ $fsurl.'rt/Admin/CustomFields/Modify.html?Create=1&LookupType=RT%3A%3AClass-RT%3A%3AArticle', '' ],
830 tie my %config_ticketing_articles, 'Tie::IxHash',
831 'Classes' => [ \%config_ticketing_articles_classes, '' ],
832 'Custom Fields' => [ \%config_ticketing_articles_customfields, '' ],
835 tie my %config_ticketing, 'Tie::IxHash',
836 'Ticketing Users' => [ $fsurl.'rt/Admin/Users', 'Edit ticketing users' ], #XXX to be unified
837 'Ticketing Groups' => [ \%config_ticketing_groups, 'View/Edit ticketing groups and group membership' ], #XXX to be unified
838 'Ticketing Queues' => [ \%config_ticketing_queues, 'View/Edit ticketing queues and queue-specific properties' ],
839 'Ticket Custom Fields' => [ \%config_ticketing_customfields, 'View/Edit ticketing custom fields' ],
840 'Ticketing Global' => [ $fsurl.'rt/Admin/Global', 'View/Edit ticketing configuration applicable to all queues' ], #XXX the individual items
841 'Ticketing Articles' => [ \%config_ticketing_articles, '' ],
842 #"System Configuraiton"? useless, just makes people report errors about missing Module::Versions::Report #'Ticketing Tools' => [ $fsurl.'rt/Admin/Tools', '' ],
845 tie my %config_nms, 'Tie::IxHash',
846 'View/Edit virtual ports' => [ $fsurl.'browse/torrus_srvderive.html', '' ],
849 tie my %config_misc, 'Tie::IxHash';
850 $config_misc{'Message templates'} = [ $fsurl.'browse/msg_template/email.html', 'Templates for customer notices' ]
851 if $curuser->access_right(['View templates', 'View global templates',
852 'Edit templates', 'Edit global templates', ]);
853 $config_misc{'Advertising sources'} = [ $fsurl.'browse/part_referral.html', 'Where a customer heard about your service.' ]
854 if $curuser->access_right('Edit advertising sources')
855 || $curuser->access_right('Edit global advertising sources');
856 $config_misc{'Custom fields'} = [ $fsurl.'browse/part_virtual_field.html', 'Locally defined fields', ]
857 if $curuser->access_right('Edit custom fields');
858 $config_misc{'Translation strings'} = [ $fsurl.'browse/msgcat.html', 'Translations and other customizable labels for each locale' ]
859 if $curuser->access_right('Configuration');
860 $config_misc{'Inventory classes and inventory'} = [ $fsurl.'browse/inventory_class.html', 'Setup inventory classes and stock inventory' ]
861 if $curuser->access_right('Edit inventory')
862 || $curuser->access_right('Edit global inventory')
863 || $curuser->access_right('Configuration');
865 $config_misc{'Real estate inventory'} = [ $fsurl.'browse/realestate_unit.html', 'Setup real estate inventory' ]
866 if $curuser->access_right('Edit realestate inventory')
867 || $curuser->access_right('Edit global inventory')
868 || $curuser->access_right('Configuration');
870 $config_misc{'Upload targets'} = [ $fsurl.'browse/upload_target.html', 'Billing and payment upload destinations' ]
871 if $curuser->access_right('Configuration');
873 $config_misc{'System log emails'} = [ $fsurl.'browse/log_email.html', 'Configure conditions for sending email when logging' ]
874 if $curuser->access_right('View system logs')
875 || $curuser->access_right('Configuration');
877 tie my %config_menu, 'Tie::IxHash';
878 if ( $curuser->access_right('Configuration' ) ) {
880 'Settings' => [ $fsurl.'config/config-view.cgi', '' ],
881 'separator' => '', #its a separator!
882 'Companies' => [ \%config_agent, '' ],
886 $config_menu{'Sales People'} = [ \%config_sales, '' ]
887 if $curuser->access_right('Edit sales people');
889 if ( $curuser->access_right('Configuration' ) ) {
890 $config_menu{'Employees'} = [ \%config_employees, '' ];
891 $config_menu{'separator2'} = ''; #its a separator!
892 $config_menu{'Customers'} = [ \%config_cust, '' ];
893 #or this? 'Customers and Contacts'
896 $config_menu{'Packages'} = [ \%config_pkg, '' ]
897 if $curuser->access_right('Configuration' )
898 || $curuser->access_right('Edit package definitions')
899 || $curuser->access_right('Edit global package definitions');
901 if ( $curuser->access_right('Configuration') ) {
902 $config_menu{'Services'} = [ \%config_export_svc, '' ];
903 $config_menu{separator3} = '';
906 tie my %config_vendor, 'Tie::IxHash',
907 'Vendor classes' => [ $fsurl.'browse/vend_class.html', '' ],
908 'Vendors' => [ $fsurl.'browse/vend_main.html', '' ],
911 if ( $curuser->access_right('Configuration') ) {
912 $config_menu{'Vendors'} = [ \%config_vendor, '' ];
913 $config_menu{separator4} = '';
916 $config_menu{'Billing'} = [ \%config_billing, '' ]
917 if keys %config_billing;
918 $config_menu{'Ticketing'} = [ \%config_ticketing, '' ]
919 if $conf->config('ticket_system')
920 && eval { FS::TicketSystem->access_right(\%session, 'ShowConfigTab') };
921 $config_menu{'Network Monitoring'} = [ \%config_nms, '' ]
922 if $curuser->access_right('Configure network monitoring')
923 && $conf->config('network_monitoring_system') eq 'Torrus_Internal';
925 if ( $curuser->access_right([ 'Configuration',
927 'View global templates',
929 'Edit global templates',
932 $config_menu{separator9} = '' if keys %config_menu;
933 $config_menu{'Miscellaneous'} = [ \%config_misc, '' ];
937 my $wiki = 'http://www.freeside.biz/mediawiki/index.php';
938 my $doc_link = $conf->config('support-key')
939 ? "$wiki/Supported:Documentation"
940 : $curuser->access_right('Configuration')
941 ? "$wiki/Freeside:4:Documentation"
942 : "$wiki/Freeside:2.1:Documentation:User"; #no page for other versions yet :/
945 if $conf->config('ticket_system') eq 'RT_Internal';
947 tie my %help_menu, 'Tie::IxHash';
948 my $agentnum = $conf->config('brand-agent');
950 my $company_name = $conf->config('company_name', $agentnum);
951 $help_menu{"About $company_name"} = [ "javascript:about_freeside()", '' ];
953 $help_menu{'Billing documentation'} = [ $doc_link, 'Freeside documentation' ];
954 $help_menu{'Ticketing documentation'} = [ 'http://wiki.bestpractical.com/', 'Request Tracker Wiki' ]
955 if $conf->config('ticket_system') eq 'RT_Internal';
956 $help_menu{'Networking monitoring documentation'} = [ 'http://torrus.org/userguide.pod.html', 'Torrus User Guide' ]
957 if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
958 $help_menu{'Developer documentation'} = [ "${fsurl}docs/library/FS.html", 'Developer documentation' ];
959 $help_menu{'separator'} = '';
960 $help_menu{"About Freeside v$FS::VERSION"} = [ "javascript:about_freeside()", '' ];
961 $help_menu{"About RT v$RT::VERSION"} = [ 'http://www.bestpractical.com/rt', 'Request Tracker Homepage' ]
962 if $conf->config('ticket_system') eq 'RT_Internal';
963 $help_menu{"About Torrus v1.0.9"} = [ 'http://www.torrus.org/', 'Torrus Homepage' ] #XXX manual version
964 if $conf->config('network_monitoring_system') eq 'Torrus_Internal';
968 tie my %menu, 'Tie::IxHash';
970 if ( $conf->config('menu-prepend_links')) {
971 my @links = split(/\n/, $conf->config('menu-prepend_links'));
972 foreach my $link (@links) {
973 $link =~ /^\s*(\S+)\s+(.*?)(\s*\(([^\)]*)\))?$/ or next;
974 my($url, $label, $alt) = ($1, $2, $4);
975 $menu{$label} = [ $url, $alt ];
979 $menu{'Billing Main'} = [ $fsurl, 'Billing start page', ];
981 if ( $conf->config('ticket_system') ) {
982 $menu{'Ticketing Main'} =
984 ( $conf->config('ticket_system') eq 'RT_External'
985 ? FS::TicketSystem->baseurl()
988 'Ticketing start page',
992 if ( $conf->config('network_monitoring_system') eq 'Torrus_Internal' &&
993 $curuser->access_right('Configure network monitoring') ) {
994 $menu{'Network Main'} =
995 [ $fsurl.'torrus/main', 'Network monitoring start page' ],
998 $menu{'New prospect'} = [ $fsurl.'edit/prospect_main.html', 'Add a new prospect' ]
999 if $curuser->access_right('New prospect');
1000 $menu{'New customer'} = [ $fsurl.'edit/cust_main.cgi', 'Add a new customer' ]
1001 if $curuser->access_right('New customer');
1002 $menu{'Reports'} = [ \%report_menu, 'Lists, reporting and graphing' ]
1003 if keys %report_menu;
1004 $menu{'Tools'} = [ \%tools_menu, 'Tools' ]
1005 if keys %tools_menu;
1006 $menu{'Configuration'} = [ \%config_menu, 'Configuration and setup' ]
1007 if $curuser->access_right([ 'Configuration',
1008 'Edit package definitions',
1009 'Edit global package definitions',
1010 'Edit billing events',
1011 'Edit global billing events',
1012 'Dialup configuration',
1013 'Wireless broadband configuration',
1014 'Phone configuration',
1015 'Alarm configuration',
1016 'Alarm global configuration',
1017 'Edit advertising sources',
1018 'Edit global advertising sources',
1020 'View global templates',
1022 'Edit global templates',
1024 $menu{'Help'} = [ \%help_menu, '' ];
1027 use vars qw($gmenunum);
1031 my($submenu, $title) = @_;
1032 my $menunum = $gmenunum++;
1034 #return two args: html, menuname
1036 "var myMenu$menunum = new WebFXMenu;\n".
1037 #"myMenu$menunum.useAutoPosition = true;\n".
1038 # "myMenu$menunum.emptyText = '$title';\n".
1039 "myMenu$menunum.emptyText = '';\n".
1044 if ( !ref( $submenu->{$_} ) ) {
1046 "myMenu$menunum.add(new WebFXMenuSeparator());";
1050 my($url_or_submenu, $tooltip ) = @{ $submenu->{$_} };
1051 if ( ref($url_or_submenu) ) {
1053 my($subhtml, $submenuname ) = submenu($url_or_submenu, $_); #mmm, recursion
1056 "myMenu$menunum.add(new WebFXMenuItem(\"".mt($_)."\", null, \"".mt($tooltip)."\", $submenuname ));";
1060 "myMenu$menunum.add(new WebFXMenuItem(\"".mt($_)."\", \"$url_or_submenu\", \"".mt($tooltip)."\" ));";
1068 "myMenu$menunum.width = 256;\n",