Merge pull request #8756 from xurizaemon/CRM-19131
[civicrm-core.git] / CRM / Report / Form / Contribute / Summary.php
1 <?php
2 /*
3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2016 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
9 | |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
13 | |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
18 | |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
26 */
27
28 /**
29 *
30 * @package CRM
31 * @copyright CiviCRM LLC (c) 2004-2016
32 */
33 class CRM_Report_Form_Contribute_Summary extends CRM_Report_Form {
34 protected $_addressField = FALSE;
35
36 protected $_charts = array(
37 '' => 'Tabular',
38 'barChart' => 'Bar Chart',
39 'pieChart' => 'Pie Chart',
40 );
41 protected $_customGroupExtends = array('Contribution');
42 protected $_customGroupGroupBy = TRUE;
43
44 public $_drilldownReport = array('contribute/detail' => 'Link to Detail Report');
45
46 /**
47 * To what frequency group-by a date column
48 *
49 * @var array
50 */
51 protected $_groupByDateFreq = array(
52 'MONTH' => 'Month',
53 'YEARWEEK' => 'Week',
54 'QUARTER' => 'Quarter',
55 'YEAR' => 'Year',
56 'FISCALYEAR' => 'Fiscal Year',
57 );
58
59 /**
60 * Class constructor.
61 */
62 public function __construct() {
63
64 // Check if CiviCampaign is a) enabled and b) has active campaigns
65 $config = CRM_Core_Config::singleton();
66 $campaignEnabled = in_array("CiviCampaign", $config->enableComponents);
67 if ($campaignEnabled) {
68 $getCampaigns = CRM_Campaign_BAO_Campaign::getPermissionedCampaigns(NULL, NULL, TRUE, FALSE, TRUE);
69 $this->activeCampaigns = $getCampaigns['campaigns'];
70 asort($this->activeCampaigns);
71 }
72
73 $this->_columns = array(
74 'civicrm_contact' => array(
75 'dao' => 'CRM_Contact_DAO_Contact',
76 'fields' => array_merge(
77 $this->getBasicContactFields(),
78 array(
79 'sort_name' => array(
80 'title' => ts('Contact Name'),
81 'no_repeat' => TRUE,
82 ),
83 )
84 ),
85 'grouping' => 'contact-fields',
86 'group_bys' => array(
87 'id' => array('title' => ts('Contact ID')),
88 'sort_name' => array(
89 'title' => ts('Contact Name'),
90 ),
91 ),
92 ),
93 'civicrm_email' => array(
94 'dao' => 'CRM_Core_DAO_Email',
95 'fields' => array(
96 'email' => array(
97 'title' => ts('Email'),
98 'no_repeat' => TRUE,
99 ),
100 ),
101 'grouping' => 'contact-fields',
102 ),
103 'civicrm_line_item' => array(
104 'dao' => 'CRM_Price_DAO_LineItem',
105 ),
106 'civicrm_phone' => array(
107 'dao' => 'CRM_Core_DAO_Phone',
108 'fields' => array(
109 'phone' => array(
110 'title' => ts('Phone'),
111 'no_repeat' => TRUE,
112 ),
113 ),
114 'grouping' => 'contact-fields',
115 ),
116 'civicrm_financial_type' => array(
117 'dao' => 'CRM_Financial_DAO_FinancialType',
118 'fields' => array('financial_type' => NULL),
119 'grouping' => 'contri-fields',
120 'group_bys' => array(
121 'financial_type' => array('title' => ts('Financial Type')),
122 ),
123 ),
124 'civicrm_contribution' => array(
125 'dao' => 'CRM_Contribute_DAO_Contribution',
126 //'bao' => 'CRM_Contribute_BAO_Contribution',
127 'fields' => array(
128 'contribution_status_id' => array(
129 'title' => ts('Contribution Status'),
130 ),
131 'contribution_source' => array('title' => ts('Source')),
132 'currency' => array(
133 'required' => TRUE,
134 'no_display' => TRUE,
135 ),
136 'total_amount' => array(
137 'title' => ts('Contribution Amount Stats'),
138 'default' => TRUE,
139 'statistics' => array(
140 'count' => ts('Contributions'),
141 'sum' => ts('Contribution Aggregate'),
142 'avg' => ts('Contribution Avg'),
143 ),
144 ),
145 ),
146 'grouping' => 'contri-fields',
147 'filters' => array(
148 'receive_date' => array('operatorType' => CRM_Report_Form::OP_DATE),
149 'contribution_status_id' => array(
150 'title' => ts('Contribution Status'),
151 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
152 'options' => CRM_Contribute_PseudoConstant::contributionStatus(),
153 'default' => array(1),
154 'type' => CRM_Utils_Type::T_INT,
155 ),
156 'currency' => array(
157 'title' => 'Currency',
158 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
159 'options' => CRM_Core_OptionGroup::values('currencies_enabled'),
160 'default' => NULL,
161 'type' => CRM_Utils_Type::T_STRING,
162 ),
163 'financial_type_id' => array(
164 'title' => ts('Financial Type'),
165 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
166 'options' => CRM_Financial_BAO_FinancialType::getAvailableFinancialTypes(),
167 'type' => CRM_Utils_Type::T_INT,
168 ),
169 'contribution_page_id' => array(
170 'title' => ts('Contribution Page'),
171 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
172 'options' => CRM_Contribute_PseudoConstant::contributionPage(),
173 'type' => CRM_Utils_Type::T_INT,
174 ),
175 'total_amount' => array(
176 'title' => ts('Contribution Amount'),
177 ),
178 'total_sum' => array(
179 'title' => ts('Contribution Aggregate'),
180 'type' => CRM_Report_Form::OP_INT,
181 'dbAlias' => 'civicrm_contribution_total_amount_sum',
182 'having' => TRUE,
183 ),
184 'total_count' => array(
185 'title' => ts('Contribution Count'),
186 'type' => CRM_Report_Form::OP_INT,
187 'dbAlias' => 'civicrm_contribution_total_amount_count',
188 'having' => TRUE,
189 ),
190 'total_avg' => array(
191 'title' => ts('Contribution Avg'),
192 'type' => CRM_Report_Form::OP_INT,
193 'dbAlias' => 'civicrm_contribution_total_amount_avg',
194 'having' => TRUE,
195 ),
196 ),
197 'group_bys' => array(
198 'receive_date' => array(
199 'frequency' => TRUE,
200 'default' => TRUE,
201 'chart' => TRUE,
202 ),
203 'contribution_source' => NULL,
204 'contribution_status_id' => array(
205 'title' => ts('Contribution Status'),
206 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
207 'options' => CRM_Contribute_PseudoConstant::contributionStatus(),
208 'default' => array(1),
209 'type' => CRM_Utils_Type::T_INT,
210 ),
211 ),
212 ),
213 'civicrm_batch' => array(
214 'dao' => 'CRM_Batch_DAO_EntityBatch',
215 'grouping' => 'contri-fields',
216 'filters' => array(
217 'batch_id' => array(
218 'title' => ts('Batch Title'),
219 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
220 'options' => CRM_Batch_BAO_Batch::getBatches(),
221 'type' => CRM_Utils_Type::T_INT,
222 ),
223 ),
224 ),
225 'civicrm_contribution_soft' => array(
226 'dao' => 'CRM_Contribute_DAO_ContributionSoft',
227 'fields' => array(
228 'soft_amount' => array(
229 'title' => ts('Soft Credit Amount Stats'),
230 'name' => 'amount',
231 'statistics' => array(
232 'count' => ts('Soft Credits'),
233 'sum' => ts('Soft Credit Aggregate'),
234 'avg' => ts('Soft Credit Avg'),
235 ),
236 ),
237 ),
238 'grouping' => 'contri-fields',
239 'filters' => array(
240 'amount' => array(
241 'title' => ts('Soft Credit Amount'),
242 ),
243 'soft_credit_type_id' => array(
244 'title' => 'Soft Credit Type',
245 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
246 'options' => CRM_Core_OptionGroup::values('soft_credit_type'),
247 'default' => NULL,
248 'type' => CRM_Utils_Type::T_STRING,
249 ),
250 'soft_sum' => array(
251 'title' => ts('Soft Credit Aggregate'),
252 'type' => CRM_Report_Form::OP_INT,
253 'dbAlias' => 'civicrm_contribution_soft_soft_amount_sum',
254 'having' => TRUE,
255 ),
256 'soft_count' => array(
257 'title' => ts('Soft Credits Count'),
258 'type' => CRM_Report_Form::OP_INT,
259 'dbAlias' => 'civicrm_contribution_soft_soft_amount_count',
260 'having' => TRUE,
261 ),
262 'soft_avg' => array(
263 'title' => ts('Soft Credit Avg'),
264 'type' => CRM_Report_Form::OP_INT,
265 'dbAlias' => 'civicrm_contribution_soft_soft_amount_avg',
266 'having' => TRUE,
267 ),
268 ),
269 ),
270 ) + $this->addAddressFields();
271
272 // If we have a campaign, build out the relevant elements
273 if ($campaignEnabled && !empty($this->activeCampaigns)) {
274 $this->_columns['civicrm_contribution']['fields']['campaign_id'] = array(
275 'title' => 'Campaign',
276 'default' => 'false',
277 );
278 $this->_columns['civicrm_contribution']['filters']['campaign_id'] = array(
279 'title' => ts('Campaign'),
280 'type' => CRM_Utils_Type::T_INT,
281 'operatorType' => CRM_Report_Form::OP_MULTISELECT,
282 'options' => $this->activeCampaigns,
283 );
284 $this->_columns['civicrm_contribution']['group_bys']['campaign_id'] = array('title' => ts('Campaign'));
285 }
286
287 $this->_tagFilter = TRUE;
288 $this->_groupFilter = TRUE;
289 $this->_currencyColumn = 'civicrm_contribution_currency';
290 parent::__construct();
291 }
292
293 /**
294 * Set select clause.
295 */
296 public function select() {
297 $select = array();
298 $this->_columnHeaders = array();
299 foreach ($this->_columns as $tableName => $table) {
300 if (array_key_exists('group_bys', $table)) {
301 foreach ($table['group_bys'] as $fieldName => $field) {
302 if ($tableName == 'civicrm_address') {
303 $this->_addressField = TRUE;
304 }
305 if (!empty($this->_params['group_bys'][$fieldName])) {
306 switch (CRM_Utils_Array::value($fieldName, $this->_params['group_bys_freq'])) {
307 case 'YEARWEEK':
308 $select[] = "DATE_SUB({$field['dbAlias']}, INTERVAL WEEKDAY({$field['dbAlias']}) DAY) AS {$tableName}_{$fieldName}_start";
309 $select[] = "YEARWEEK({$field['dbAlias']}) AS {$tableName}_{$fieldName}_subtotal";
310 $select[] = "WEEKOFYEAR({$field['dbAlias']}) AS {$tableName}_{$fieldName}_interval";
311 $field['title'] = 'Week';
312 break;
313
314 case 'YEAR':
315 $select[] = "MAKEDATE(YEAR({$field['dbAlias']}), 1) AS {$tableName}_{$fieldName}_start";
316 $select[] = "YEAR({$field['dbAlias']}) AS {$tableName}_{$fieldName}_subtotal";
317 $select[] = "YEAR({$field['dbAlias']}) AS {$tableName}_{$fieldName}_interval";
318 $field['title'] = 'Year';
319 break;
320
321 case 'FISCALYEAR':
322 $config = CRM_Core_Config::singleton();
323 $fy = $config->fiscalYearStart;
324 $fiscal = self::fiscalYearOffset($field['dbAlias']);
325
326 $select[] = "DATE_ADD(MAKEDATE({$fiscal}, 1), INTERVAL ({$fy{'M'}})-1 MONTH) AS {$tableName}_{$fieldName}_start";
327 $select[] = "{$fiscal} AS {$tableName}_{$fieldName}_subtotal";
328 $select[] = "{$fiscal} AS {$tableName}_{$fieldName}_interval";
329 $field['title'] = 'Fiscal Year';
330 break;
331
332 case 'MONTH':
333 $select[] = "DATE_SUB({$field['dbAlias']}, INTERVAL (DAYOFMONTH({$field['dbAlias']})-1) DAY) as {$tableName}_{$fieldName}_start";
334 $select[] = "MONTH({$field['dbAlias']}) AS {$tableName}_{$fieldName}_subtotal";
335 $select[] = "MONTHNAME({$field['dbAlias']}) AS {$tableName}_{$fieldName}_interval";
336 $field['title'] = 'Month';
337 break;
338
339 case 'QUARTER':
340 $select[] = "STR_TO_DATE(CONCAT( 3 * QUARTER( {$field['dbAlias']} ) -2 , '/', '1', '/', YEAR( {$field['dbAlias']} ) ), '%m/%d/%Y') AS {$tableName}_{$fieldName}_start";
341 $select[] = "QUARTER({$field['dbAlias']}) AS {$tableName}_{$fieldName}_subtotal";
342 $select[] = "QUARTER({$field['dbAlias']}) AS {$tableName}_{$fieldName}_interval";
343 $field['title'] = 'Quarter';
344 break;
345 }
346 if (!empty($this->_params['group_bys_freq'][$fieldName])) {
347 $this->_interval = $field['title'];
348 $this->_columnHeaders["{$tableName}_{$fieldName}_start"]['title'] = $field['title'] . ' Beginning';
349 $this->_columnHeaders["{$tableName}_{$fieldName}_start"]['type'] = $field['type'];
350 $this->_columnHeaders["{$tableName}_{$fieldName}_start"]['group_by'] = $this->_params['group_bys_freq'][$fieldName];
351
352 // just to make sure these values are transferred to rows.
353 // since we need that for calculation purpose,
354 // e.g making subtotals look nicer or graphs
355 $this->_columnHeaders["{$tableName}_{$fieldName}_interval"] = array('no_display' => TRUE);
356 $this->_columnHeaders["{$tableName}_{$fieldName}_subtotal"] = array('no_display' => TRUE);
357 }
358 }
359 }
360 }
361
362 if (array_key_exists('fields', $table)) {
363 foreach ($table['fields'] as $fieldName => $field) {
364 if ($tableName == 'civicrm_address') {
365 $this->_addressField = TRUE;
366 }
367 if (!empty($field['required']) ||
368 !empty($this->_params['fields'][$fieldName])
369 ) {
370 // only include statistics columns if set
371 if (!empty($field['statistics'])) {
372 foreach ($field['statistics'] as $stat => $label) {
373 $this->_columnHeaders["{$tableName}_{$fieldName}_{$stat}"]['title'] = $label;
374 $this->_columnHeaders["{$tableName}_{$fieldName}_{$stat}"]['type'] = $field['type'];
375 $this->_statFields[] = "{$tableName}_{$fieldName}_{$stat}";
376 switch (strtolower($stat)) {
377 case 'sum':
378 $select[] = "SUM({$field['dbAlias']}) as {$tableName}_{$fieldName}_{$stat}";
379 break;
380
381 case 'count':
382 $select[] = "COUNT({$field['dbAlias']}) as {$tableName}_{$fieldName}_{$stat}";
383 $this->_columnHeaders["{$tableName}_{$fieldName}_{$stat}"]['type'] = CRM_Utils_Type::T_INT;
384 break;
385
386 case 'avg':
387 $select[] = "ROUND(AVG({$field['dbAlias']}),2) as {$tableName}_{$fieldName}_{$stat}";
388 break;
389 }
390 }
391 }
392 else {
393 $select[] = "{$field['dbAlias']} as {$tableName}_{$fieldName}";
394 $this->_columnHeaders["{$tableName}_{$fieldName}"]['type'] = CRM_Utils_Array::value('type', $field);
395 $this->_columnHeaders["{$tableName}_{$fieldName}"]['title'] = CRM_Utils_Array::value('title', $field);
396 }
397 }
398 }
399 }
400 }
401
402 $this->_selectClauses = $select;
403 $this->_select = "SELECT " . implode(', ', $select) . " ";
404 }
405
406 /**
407 * Set form rules.
408 *
409 * @param array $fields
410 * @param array $files
411 * @param CRM_Report_Form_Contribute_Summary $self
412 *
413 * @return array
414 */
415 public static function formRule($fields, $files, $self) {
416 // Check for searching combination of display columns and
417 // grouping criteria
418 $ignoreFields = array('total_amount', 'sort_name');
419 $errors = $self->customDataFormRule($fields, $ignoreFields);
420
421 if (empty($fields['fields']['total_amount'])) {
422 foreach (array(
423 'total_count_value',
424 'total_sum_value',
425 'total_avg_value',
426 ) as $val) {
427 if (!empty($fields[$val])) {
428 $errors[$val] = ts("Please select the Amount Statistics");
429 }
430 }
431 }
432
433 return $errors;
434 }
435
436 /**
437 * Set from clause.
438 *
439 * @param string $entity
440 */
441 public function from($entity = NULL) {
442 $softCreditJoinType = "LEFT";
443 if (!empty($this->_params['fields']['soft_amount']) &&
444 empty($this->_params['fields']['total_amount'])
445 ) {
446 // if its only soft credit stats, use inner join
447 $softCreditJoinType = "INNER";
448 }
449
450 $softCreditJoin = "{$softCreditJoinType} JOIN civicrm_contribution_soft {$this->_aliases['civicrm_contribution_soft']}
451 ON {$this->_aliases['civicrm_contribution_soft']}.contribution_id = {$this->_aliases['civicrm_contribution']}.id";
452 if ($entity == 'contribution' || empty($this->_params['fields']['soft_amount'])) {
453 $softCreditJoin .= " AND {$this->_aliases['civicrm_contribution_soft']}.id = (SELECT MIN(id) FROM civicrm_contribution_soft cs WHERE cs.contribution_id = {$this->_aliases['civicrm_contribution']}.id) ";
454 }
455
456 $this->_from = "
457 FROM civicrm_contact {$this->_aliases['civicrm_contact']} {$this->_aclFrom}
458 INNER JOIN civicrm_contribution {$this->_aliases['civicrm_contribution']}
459 ON {$this->_aliases['civicrm_contact']}.id = {$this->_aliases['civicrm_contribution']}.contact_id AND
460 {$this->_aliases['civicrm_contribution']}.is_test = 0
461 {$softCreditJoin}
462 LEFT JOIN civicrm_financial_type {$this->_aliases['civicrm_financial_type']}
463 ON {$this->_aliases['civicrm_contribution']}.financial_type_id ={$this->_aliases['civicrm_financial_type']}.id
464 LEFT JOIN civicrm_email {$this->_aliases['civicrm_email']}
465 ON ({$this->_aliases['civicrm_contact']}.id = {$this->_aliases['civicrm_email']}.contact_id AND
466 {$this->_aliases['civicrm_email']}.is_primary = 1)
467
468 LEFT JOIN civicrm_phone {$this->_aliases['civicrm_phone']}
469 ON ({$this->_aliases['civicrm_contact']}.id = {$this->_aliases['civicrm_phone']}.contact_id AND
470 {$this->_aliases['civicrm_phone']}.is_primary = 1)";
471
472 if ($this->_addressField) {
473 $this->_from .= "
474 LEFT JOIN civicrm_address {$this->_aliases['civicrm_address']}
475 ON {$this->_aliases['civicrm_contact']}.id =
476 {$this->_aliases['civicrm_address']}.contact_id AND
477 {$this->_aliases['civicrm_address']}.is_primary = 1\n";
478 }
479 if (!empty($this->_params['batch_id_value'])) {
480 $this->_from .= "
481 LEFT JOIN civicrm_entity_financial_trxn eft
482 ON eft.entity_id = {$this->_aliases['civicrm_contribution']}.id AND
483 eft.entity_table = 'civicrm_contribution'
484 LEFT JOIN civicrm_entity_batch {$this->_aliases['civicrm_batch']}
485 ON {$this->_aliases['civicrm_batch']}.entity_id = eft.financial_trxn_id AND
486 {$this->_aliases['civicrm_batch']}.entity_table = 'civicrm_financial_trxn'\n";
487 }
488 }
489
490 /**
491 * Set group by clause.
492 */
493 public function groupBy() {
494 $this->_groupBy = "";
495 $append = FALSE;
496 if (!empty($this->_params['group_bys']) &&
497 is_array($this->_params['group_bys'])
498 ) {
499 foreach ($this->_columns as $tableName => $table) {
500 if (array_key_exists('group_bys', $table)) {
501 foreach ($table['group_bys'] as $fieldName => $field) {
502 if (!empty($this->_params['group_bys'][$fieldName])) {
503 if (!empty($field['chart'])) {
504 $this->assign('chartSupported', TRUE);
505 }
506
507 if (!empty($table['group_bys'][$fieldName]['frequency']) &&
508 !empty($this->_params['group_bys_freq'][$fieldName])
509 ) {
510
511 $append = "YEAR({$field['dbAlias']});;";
512 if (in_array(strtolower($this->_params['group_bys_freq'][$fieldName]),
513 array('year')
514 )) {
515 $append = '';
516 }
517 if ($this->_params['group_bys_freq'][$fieldName] == 'FISCALYEAR') {
518 $this->_groupBy[] = self::fiscalYearOffset($field['dbAlias']);
519 }
520 else {
521 $this->_groupBy[] = "$append {$this->_params['group_bys_freq'][$fieldName]}({$field['dbAlias']})";
522 }
523 $append = TRUE;
524 }
525 else {
526 $this->_groupBy[] = $field['dbAlias'];
527 }
528 }
529 }
530 }
531 }
532
533 if (!empty($this->_statFields) &&
534 (($append && count($this->_groupBy) <= 1) || (!$append)) &&
535 !$this->_having
536 ) {
537 $this->_rollup = " WITH ROLLUP";
538 }
539 $groupBy = array();
540 foreach ($this->_groupBy as $key => $val) {
541 if (strpos($val, ';;') !== FALSE) {
542 $groupBy = array_merge($groupBy, explode(';;', $val));
543 }
544 else {
545 $groupBy[] = $this->_groupBy[$key];
546 }
547 }
548 $this->_groupBy = "GROUP BY " . implode(', ', $groupBy);
549 }
550 else {
551 $groupBy = "{$this->_aliases['civicrm_contact']}.id";
552 $this->_groupBy = "GROUP BY {$this->_aliases['civicrm_contact']}.id";
553 }
554 $this->_groupBy .= $this->_rollup;
555 // append select with ANY_VALUE() keyword
556 $this->appendSelect($this->_selectClauses, $groupBy);
557 }
558
559 /**
560 * Store having clauses as an array.
561 */
562 public function storeWhereHavingClauseArray() {
563 parent::storeWhereHavingClauseArray();
564 if (empty($this->_params['fields']['soft_amount']) &&
565 !empty($this->_havingClauses)
566 ) {
567 foreach ($this->_havingClauses as $key => $havingClause) {
568 if (stristr($havingClause, 'soft_soft')) {
569 unset($this->_havingClauses[$key]);
570 }
571 }
572 }
573 }
574
575 /**
576 * Set statistics.
577 *
578 * @param array $rows
579 *
580 * @return array
581 */
582 public function statistics(&$rows) {
583 $statistics = parent::statistics($rows);
584
585 $softCredit = CRM_Utils_Array::value('soft_amount', $this->_params['fields']);
586 $onlySoftCredit = $softCredit && !CRM_Utils_Array::value('total_amount', $this->_params['fields']);
587 $group = "\nGROUP BY {$this->_aliases['civicrm_contribution']}.currency";
588
589 $this->from('contribution');
590 $this->customDataFrom();
591
592 $contriQuery = "
593 COUNT({$this->_aliases['civicrm_contribution']}.total_amount ) as civicrm_contribution_total_amount_count,
594 SUM({$this->_aliases['civicrm_contribution']}.total_amount ) as civicrm_contribution_total_amount_sum,
595 ROUND(AVG({$this->_aliases['civicrm_contribution']}.total_amount), 2) as civicrm_contribution_total_amount_avg,
596 {$this->_aliases['civicrm_contribution']}.currency as currency
597 {$this->_from} {$this->_where}";
598
599 if ($softCredit) {
600 $this->from();
601 $select = "
602 COUNT({$this->_aliases['civicrm_contribution_soft']}.amount ) as civicrm_contribution_soft_soft_amount_count,
603 SUM({$this->_aliases['civicrm_contribution_soft']}.amount ) as civicrm_contribution_soft_soft_amount_sum,
604 ROUND(AVG({$this->_aliases['civicrm_contribution_soft']}.amount), 2) as civicrm_contribution_soft_soft_amount_avg";
605 $contriQuery = "{$select}, {$contriQuery}";
606 $softSQL = "SELECT {$select}, {$this->_aliases['civicrm_contribution']}.currency as currency
607 {$this->_from} {$this->_where} {$group} {$this->_having}";
608 }
609
610 $contriSQL = "SELECT {$contriQuery} {$group} {$this->_having}";
611 $contriDAO = CRM_Core_DAO::executeQuery($contriSQL);
612
613 $totalAmount = $average = $mode = $median = $softTotalAmount = $softAverage = array();
614 $count = $softCount = 0;
615 while ($contriDAO->fetch()) {
616 $totalAmount[]
617 = CRM_Utils_Money::format($contriDAO->civicrm_contribution_total_amount_sum, $contriDAO->currency) .
618 " (" . $contriDAO->civicrm_contribution_total_amount_count . ")";
619 $average[] = CRM_Utils_Money::format($contriDAO->civicrm_contribution_total_amount_avg, $contriDAO->currency);
620 $count += $contriDAO->civicrm_contribution_total_amount_count;
621 }
622
623 $groupBy = "\n{$group}, {$this->_aliases['civicrm_contribution']}.total_amount";
624 $orderBy = "\nORDER BY civicrm_contribution_total_amount_count DESC";
625 $modeSQL = "SELECT MAX(civicrm_contribution_total_amount_count) as civicrm_contribution_total_amount_count,
626 SUBSTRING_INDEX(GROUP_CONCAT(amount ORDER BY mode.civicrm_contribution_total_amount_count DESC SEPARATOR ';'), ';', 1) as amount,
627 currency
628 FROM (SELECT {$this->_aliases['civicrm_contribution']}.total_amount as amount,
629 {$contriQuery} {$groupBy} {$orderBy}) as mode GROUP BY currency";
630
631 $mode = CRM_Contribute_BAO_Contribution::computeStats('mode', $modeSQL);
632
633 $medianSQL = "{$this->_from} {$this->_where}";
634 $median = CRM_Contribute_BAO_Contribution::computeStats('median', $medianSQL, $this->_aliases['civicrm_contribution']);
635
636 if ($softCredit) {
637 $softDAO = CRM_Core_DAO::executeQuery($softSQL);
638 while ($softDAO->fetch()) {
639 $softTotalAmount[]
640 = CRM_Utils_Money::format($softDAO->civicrm_contribution_soft_soft_amount_sum, $softDAO->currency) .
641 " (" . $softDAO->civicrm_contribution_soft_soft_amount_count . ")";
642 $softAverage[] = CRM_Utils_Money::format($softDAO->civicrm_contribution_soft_soft_amount_avg, $softDAO->currency);
643 $softCount += $softDAO->civicrm_contribution_soft_soft_amount_count;
644 }
645 }
646
647 if (!$onlySoftCredit) {
648 $statistics['counts']['amount'] = array(
649 'title' => ts('Total Amount'),
650 'value' => implode(', ', $totalAmount),
651 'type' => CRM_Utils_Type::T_STRING,
652 );
653 $statistics['counts']['count'] = array(
654 'title' => ts('Total Contributions'),
655 'value' => $count,
656 );
657 $statistics['counts']['avg'] = array(
658 'title' => ts('Average'),
659 'value' => implode(', ', $average),
660 'type' => CRM_Utils_Type::T_STRING,
661 );
662 $statistics['counts']['mode'] = array(
663 'title' => ts('Mode'),
664 'value' => implode(', ', $mode),
665 'type' => CRM_Utils_Type::T_STRING,
666 );
667 $statistics['counts']['median'] = array(
668 'title' => ts('Median'),
669 'value' => implode(', ', $median),
670 'type' => CRM_Utils_Type::T_STRING,
671 );
672 }
673 if ($softCredit) {
674 $statistics['counts']['soft_amount'] = array(
675 'title' => ts('Total Soft Credit Amount'),
676 'value' => implode(', ', $softTotalAmount),
677 'type' => CRM_Utils_Type::T_STRING,
678 );
679 $statistics['counts']['soft_count'] = array(
680 'title' => ts('Total Soft Credits'),
681 'value' => $softCount,
682 );
683 $statistics['counts']['soft_avg'] = array(
684 'title' => ts('Average Soft Credit'),
685 'value' => implode(', ', $softAverage),
686 'type' => CRM_Utils_Type::T_STRING,
687 );
688 }
689 return $statistics;
690 }
691
692 /**
693 * Post process function.
694 */
695 public function postProcess() {
696 $this->buildACLClause($this->_aliases['civicrm_contact']);
697 parent::postProcess();
698 }
699
700 /**
701 * Build table rows for output.
702 *
703 * @param string $sql
704 * @param array $rows
705 */
706 public function buildRows($sql, &$rows) {
707 $dao = CRM_Core_DAO::executeQuery($sql);
708 if (!is_array($rows)) {
709 $rows = array();
710 }
711
712 // use this method to modify $this->_columnHeaders
713 $this->modifyColumnHeaders();
714 $contriRows = array();
715 $unselectedSectionColumns = $this->unselectedSectionColumns();
716
717 //CRM-16338 if both soft-credit and contribution are enabled then process the contribution's
718 //total amount's average, count and sum separately and add it to the respective result list
719 $softCredit = (!empty($this->_params['fields']['soft_amount']) && !empty($this->_params['fields']['total_amount'])) ? TRUE : FALSE;
720 if ($softCredit) {
721 $this->from('contribution');
722 $contriSQL = "{$this->_select} {$this->_from} {$this->_where} {$this->_groupBy} {$this->_having} {$this->_orderBy} {$this->_limit}";
723 $contriDAO = CRM_Core_DAO::executeQuery($contriSQL);
724 $contriFields = array(
725 'civicrm_contribution_total_amount_sum',
726 'civicrm_contribution_total_amount_avg',
727 'civicrm_contribution_total_amount_count');
728 $contriRows = array();
729 while ($contriDAO->fetch()) {
730 $contriRow = array();
731 foreach ($contriFields as $column) {
732 $contriRow[$column] = $contriDAO->$column;
733 }
734 $contriRows[] = $contriRow;
735 }
736 }
737
738 $count = 0;
739 while ($dao->fetch()) {
740 $row = array();
741 foreach ($this->_columnHeaders as $key => $value) {
742 if ($softCredit && array_key_exists($key, $contriRows[$count])) {
743 $row[$key] = $contriRows[$count][$key];
744 }
745 elseif (property_exists($dao, $key)) {
746 $row[$key] = $dao->$key;
747 }
748 }
749
750 // section headers not selected for display need to be added to row
751 foreach ($unselectedSectionColumns as $key => $values) {
752 if (property_exists($dao, $key)) {
753 $row[$key] = $dao->$key;
754 }
755 }
756
757 $count++;
758 $rows[] = $row;
759 }
760
761 }
762
763 /**
764 * Build chart.
765 *
766 * @param array $rows
767 */
768 public function buildChart(&$rows) {
769 $graphRows = array();
770
771 if (!empty($this->_params['charts'])) {
772 if (!empty($this->_params['group_bys']['receive_date'])) {
773
774 $contrib = !empty($this->_params['fields']['total_amount']) ? TRUE : FALSE;
775 $softContrib = !empty($this->_params['fields']['soft_amount']) ? TRUE : FALSE;
776
777 foreach ($rows as $key => $row) {
778 if ($row['civicrm_contribution_receive_date_subtotal']) {
779 $graphRows['receive_date'][] = $row['civicrm_contribution_receive_date_start'];
780 $graphRows[$this->_interval][] = $row['civicrm_contribution_receive_date_interval'];
781 if ($softContrib && $contrib) {
782 // both contri & soft contri stats are present
783 $graphRows['multiValue'][0][] = $row['civicrm_contribution_total_amount_sum'];
784 $graphRows['multiValue'][1][] = $row['civicrm_contribution_soft_soft_amount_sum'];
785 }
786 elseif ($softContrib) {
787 // only soft contributions
788 $graphRows['multiValue'][0][] = $row['civicrm_contribution_soft_soft_amount_sum'];
789 }
790 else {
791 // only contributions
792 $graphRows['multiValue'][0][] = $row['civicrm_contribution_total_amount_sum'];
793 }
794 }
795 }
796
797 if ($softContrib && $contrib) {
798 $graphRows['barKeys'][0] = ts('Contributions');
799 $graphRows['barKeys'][1] = ts('Soft Credits');
800 $graphRows['legend'] = ts('Contributions and Soft Credits');
801 }
802 elseif ($softContrib) {
803 $graphRows['legend'] = ts('Soft Credits');
804 }
805
806 // build the chart.
807 $config = CRM_Core_Config::Singleton();
808 $graphRows['xname'] = $this->_interval;
809 $graphRows['yname'] = "Amount ({$config->defaultCurrency})";
810 CRM_Utils_OpenFlashChart::chart($graphRows, $this->_params['charts'], $this->_interval);
811 $this->assign('chartType', $this->_params['charts']);
812 }
813 }
814 }
815
816 /**
817 * Alter display of rows.
818 *
819 * Iterate through the rows retrieved via SQL and make changes for display purposes,
820 * such as rendering contacts as links.
821 *
822 * @param array $rows
823 * Rows generated by SQL, with an array for each row.
824 */
825 public function alterDisplay(&$rows) {
826 $entryFound = FALSE;
827 $contributionStatus = CRM_Contribute_PseudoConstant::contributionStatus();
828
829 foreach ($rows as $rowNum => $row) {
830 // make count columns point to detail report
831 if (!empty($this->_params['group_bys']['receive_date']) &&
832 !empty($row['civicrm_contribution_receive_date_start']) &&
833 CRM_Utils_Array::value('civicrm_contribution_receive_date_start', $row) &&
834 !empty($row['civicrm_contribution_receive_date_subtotal'])
835 ) {
836
837 $dateStart = CRM_Utils_Date::customFormat($row['civicrm_contribution_receive_date_start'], '%Y%m%d');
838 $endDate = new DateTime($dateStart);
839 $dateEnd = array();
840
841 list($dateEnd['Y'], $dateEnd['M'], $dateEnd['d']) = explode(':', $endDate->format('Y:m:d'));
842
843 switch (strtolower($this->_params['group_bys_freq']['receive_date'])) {
844 case 'month':
845 $dateEnd = date("Ymd", mktime(0, 0, 0, $dateEnd['M'] + 1,
846 $dateEnd['d'] - 1, $dateEnd['Y']
847 ));
848 break;
849
850 case 'year':
851 $dateEnd = date("Ymd", mktime(0, 0, 0, $dateEnd['M'],
852 $dateEnd['d'] - 1, $dateEnd['Y'] + 1
853 ));
854 break;
855
856 case 'fiscalyear':
857 $dateEnd = date("Ymd", mktime(0, 0, 0, $dateEnd['M'],
858 $dateEnd['d'] - 1, $dateEnd['Y'] + 1
859 ));
860 break;
861
862 case 'yearweek':
863 $dateEnd = date("Ymd", mktime(0, 0, 0, $dateEnd['M'],
864 $dateEnd['d'] + 6, $dateEnd['Y']
865 ));
866 break;
867
868 case 'quarter':
869 $dateEnd = date("Ymd", mktime(0, 0, 0, $dateEnd['M'] + 3,
870 $dateEnd['d'] - 1, $dateEnd['Y']
871 ));
872 break;
873 }
874 $url = CRM_Report_Utils_Report::getNextUrl('contribute/detail',
875 "reset=1&force=1&receive_date_from={$dateStart}&receive_date_to={$dateEnd}",
876 $this->_absoluteUrl,
877 $this->_id,
878 $this->_drilldownReport
879 );
880 $rows[$rowNum]['civicrm_contribution_receive_date_start_link'] = $url;
881 $rows[$rowNum]['civicrm_contribution_receive_date_start_hover'] = ts('List all contribution(s) for this date unit.');
882 $entryFound = TRUE;
883 }
884
885 // make subtotals look nicer
886 if (array_key_exists('civicrm_contribution_receive_date_subtotal', $row) &&
887 !$row['civicrm_contribution_receive_date_subtotal']
888 ) {
889 $this->fixSubTotalDisplay($rows[$rowNum], $this->_statFields);
890 $entryFound = TRUE;
891 }
892
893 // convert display name to links
894 if (array_key_exists('civicrm_contact_sort_name', $row) &&
895 array_key_exists('civicrm_contact_id', $row)
896 ) {
897 $url = CRM_Report_Utils_Report::getNextUrl('contribute/detail',
898 'reset=1&force=1&id_op=eq&id_value=' . $row['civicrm_contact_id'],
899 $this->_absoluteUrl, $this->_id, $this->_drilldownReport
900 );
901 $rows[$rowNum]['civicrm_contact_sort_name_link'] = $url;
902 $rows[$rowNum]['civicrm_contact_sort_name_hover'] = ts("Lists detailed contribution(s) for this record.");
903 $entryFound = TRUE;
904 }
905
906 // convert contribution status id to status name
907 if ($value = CRM_Utils_Array::value('civicrm_contribution_contribution_status_id', $row)) {
908 $rows[$rowNum]['civicrm_contribution_contribution_status_id'] = $contributionStatus[$value];
909 $entryFound = TRUE;
910 }
911
912 // If using campaigns, convert campaign_id to campaign title
913 if (array_key_exists('civicrm_contribution_campaign_id', $row)) {
914 if ($value = $row['civicrm_contribution_campaign_id']) {
915 $rows[$rowNum]['civicrm_contribution_campaign_id'] = $this->activeCampaigns[$value];
916 }
917 $entryFound = TRUE;
918 }
919
920 $entryFound = $this->alterDisplayAddressFields($row, $rows, $rowNum, 'contribute/detail', 'List all contribution(s) for this ') ? TRUE : $entryFound;
921 $entryFound = $this->alterDisplayContactFields($row, $rows, $rowNum, 'contribute/detail', 'List all contribution(s) for this ') ? TRUE : $entryFound;
922
923 // skip looking further in rows, if first row itself doesn't
924 // have the column we need
925 if (!$entryFound) {
926 break;
927 }
928 }
929 }
930
931 }