httemplate/graph/elements/monthly.html

   1 <%doc>
   2
   3 Example:
   4
   5   include('elements/monthly.html',
   6     #required
   7     'title'           => 'Page title',
   8     'items'           => \@items,
   9     'labels'          => \@labels,       # or \%labels (keys are items)
  10
  11     #required?
  12     'colors'          => \@colors,       # or \%colors,
  13
  14     #recommended
  15     'graph_labels'    => \@graph_labels, # or \%graph_labels,
  16
  17     #optional
  18     'params'          => \@params, # opt,
  19     'links'           => \@links,      # or \%link, #opt
  20     'link_fromparam'  => 'param_from', #defaults to 'begin'
  21     'link_toparam'    => 'param_to',   #defaults to 'end'
  22     'daily'           => 1, # omit for monthly granularity
  23
  24     #optional, pulled from CGI params if not specified
  25     'start_month'     => $smonth,
  26     'start_year'      => $syear,
  27     'end_month'       => $emonth,
  28     'end_year'        => $eyear,
  29
  30
  31     #optional, pulled from CGI params if not specified,
  32     #only if 'daily' option is given
  33     'start_day'       => $sday,
  34     'end_day'         => $eday,
  35
  36     #optional
  37     'agentnum'        => $agentnum,
  38     'nototal'         => 1,
  39     'graph_type'      => 'LinesPoints',
  40     'remove_empty'    => 1,
  41     'bottom_total'    => 1,
  42     'sprintf'         => '%u', #sprintf format, overrides default %.2f
  43     'disable_money'   => 1,
  44   );
  45
  46 </%doc>
  47 <% include('report.html',
  48             'items'         => $data->{'items'},
  49             'data'          => $data->{'data'},
  50             'row_labels'    => $data->{'item_labels'},
  51             'graph_labels'  => $opt{'graph_labels'} || $data->{'item_labels'},
  52             'col_labels'    => $col_labels,
  53             'axis_labels'   => $data->{label},
  54             'colors'        => $data->{colors},
  55             'links'         => \@links,
  56             'bottom_link'   => \@bottom_link,
  57             map { $_, $opt{$_} } (qw(title
  58                                     nototal
  59                                     graph_type
  60                                     bottom_total
  61                                     sprintf
  62                                     disable_money)),
  63           ) %>
  64 <%init>
  65
  66 my(%opt) = @_;
  67
  68 my $conf = new FS::Conf;
  69 my $money_char = $opt{'disable_money'} ? '' : $conf->config('money_char');
  70
  71 my $fromparam = $opt{'link_fromparam'} || 'begin';
  72 my $toparam   = $opt{'link_toparam'} || 'end';
  73
  74 my @items = @{ $opt{'items'} };
  75
  76 foreach my $other (qw( labels graph_labels colors links )) {
  77   if ( ref($opt{$other}) eq 'HASH' ) {
  78     $opt{$other} = [ map $opt{$other}{$_}, @items ];
  79   }
  80 }
  81
  82 my @mon = qw(Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec);
  83
  84 #find first month
  85 $opt{'start_month'} ||= $cgi->param('start_month'); # || $curmon+1;
  86 $opt{'start_year'}  ||= $cgi->param('start_year'); # || 1899+$curyear;
  87
  88 #find last month
  89 $opt{'end_month'} ||= $cgi->param('end_month'); # || $curmon+1;
  90 $opt{'end_year'}  ||= $cgi->param('end_year'); # || 1900+$curyear;
  91
  92 if ( $opt{'daily'} ) { # daily granularity
  93     $opt{'start_day'} ||= $cgi->param('start_day');
  94     $opt{'end_day'} ||= $cgi->param('end_day');
  95 }
  96
  97 my %reportopts = (
  98       'items'        => \@items,
  99       'params'       => $opt{'params'},
 100       'item_labels'  => ( $cgi->param('_type') =~ /^(png)$/
 101                             ? $opt{'graph_labels'}
 102                             : $opt{'labels'}
 103                         ),
 104       'colors'       => $opt{'colors'},
 105       'links'        => $opt{'links'},
 106
 107       'start_day'    => $opt{'start_day'},
 108       'start_month'  => $opt{'start_month'},
 109       'start_year'   => $opt{'start_year'},
 110       'end_day'      => $opt{'end_day'},
 111       'end_month'    => $opt{'end_month'},
 112       'end_year'     => $opt{'end_year'},
 113       'agentnum'     => $opt{'agentnum'},
 114       'remove_empty' => $opt{'remove_empty'},
 115       'doublemonths' => $opt{'doublemonths'},
 116 );
 117
 118 my $report;
 119 $report = new FS::Report::Table::Daily(%reportopts) if $opt{'daily'};
 120 $report = new FS::Report::Table::Monthly(%reportopts) unless $opt{'daily'};
 121 my $data = $report->data;
 122
 123 my $col_labels = [ map { my $m = $_; $m =~ s/^(\d+)\//$mon[$1-1] / ; $m }
 124                              @{$data->{label}} ];
 125 $col_labels = $data->{label} if $opt{'daily'};
 126
 127 my @links;
 128 foreach my $link (@{ $data->{'links'} }) {
 129   my @speriod = @{$data->{'speriod'}};
 130   my @eperiod = @{$data->{'eperiod'}};
 131   my ($begin, $end) = ($fromparam, $toparam);
 132
 133   my @new = ( $link );
 134   if(ref($link)) {
 135     $begin = $link->{'fromparam'};
 136     $end   = $link->{'toparam'};
 137     @new = ( $link->{'link'} );
 138   }
 139   while(@speriod) {
 140     push @new, "$begin=". shift(@speriod).";$end=".shift(@eperiod);
 141   }
 142   if(! $opt{'nototal'}) {
 143     push @new, "$begin=". $data->{'speriod'}[0] . ";$end=". $data->{'eperiod'}[-1];
 144   }
 145   push @links, \@new;
 146 }
 147
 148 my @bottom_link;
 149 if($opt{'bottom_link'}) {
 150   my @speriod = (@{$data->{'speriod'}}, $data->{'speriod'}[0]);
 151   my @eperiod = (@{$data->{'eperiod'}}, $data->{'eperiod'}[-1]);
 152
 153   push @bottom_link, $opt{'bottom_link'};
 154   while(@speriod) {
 155     push @bottom_link, "$fromparam=". shift(@speriod). ";$toparam=". shift(@eperiod);
 156   }
 157 }
 158
 159 </%init>