'Tabular', 'barChart' => 'Bar Chart', 'pieChart' => 'Pie Chart', ); protected $_customGroupExtends = array( 'Contact', 'Individual', 'Contribution', ); public $_drilldownReport = array('contribute/detail' => 'Link to Detail Report'); /** * This report has been optimised for group filtering. * * CRM-19170 * * @var bool */ protected $groupFilterNotOptimised = FALSE; /** * Class constructor. */ public function __construct() { $this->_rollup = 'WITH ROLLUP'; $this->_autoIncludeIndexedFieldsAsOrderBys = 1; $yearsInPast = 10; $yearsInFuture = 1; $date = CRM_Core_SelectValues::date('custom', NULL, $yearsInPast, $yearsInFuture); $count = $date['maxYear']; while ($date['minYear'] <= $count) { $optionYear[$date['minYear']] = $date['minYear']; $date['minYear']++; } // Check if CiviCampaign is a) enabled and b) has active campaigns $config = CRM_Core_Config::singleton(); $campaignEnabled = in_array("CiviCampaign", $config->enableComponents); if ($campaignEnabled) { $getCampaigns = CRM_Campaign_BAO_Campaign::getPermissionedCampaigns(NULL, NULL, TRUE, FALSE, TRUE); $this->activeCampaigns = $getCampaigns['campaigns']; asort($this->activeCampaigns); } $this->_columns = array( 'civicrm_contact' => array( 'dao' => 'CRM_Contact_DAO_Contact', 'grouping' => 'contact-field', 'fields' => array( 'sort_name' => array( 'title' => ts('Donor Name'), 'required' => TRUE, ), 'first_name' => array( 'title' => ts('First Name'), ), 'middle_name' => array( 'title' => ts('Middle Name'), ), 'last_name' => array( 'title' => ts('Last Name'), ), 'id' => array( 'no_display' => TRUE, 'required' => TRUE, ), 'gender_id' => array( 'title' => ts('Gender'), ), 'birth_date' => array( 'title' => ts('Birth Date'), ), 'age' => array( 'title' => ts('Age'), 'dbAlias' => 'TIMESTAMPDIFF(YEAR, contact_civireport.birth_date, CURDATE())', ), 'contact_type' => array( 'title' => ts('Contact Type'), ), 'contact_sub_type' => array( 'title' => ts('Contact Subtype'), ), ), 'order_bys' => array( 'sort_name' => array( 'title' => ts('Last Name, First Name'), 'default' => '1', 'default_weight' => '0', 'default_order' => 'ASC', ), 'first_name' => array( 'name' => 'first_name', 'title' => ts('First Name'), ), 'gender_id' => array( 'name' => 'gender_id', 'title' => ts('Gender'), ), 'birth_date' => array( 'name' => 'birth_date', 'title' => ts('Birth Date'), ), 'age_at_event' => array( 'name' => 'age_at_event', 'title' => ts('Age at Event'), ), 'contact_type' => array( 'title' => ts('Contact Type'), ), 'contact_sub_type' => array( 'title' => ts('Contact Subtype'), ), ), 'filters' => array( 'sort_name' => array( 'title' => ts('Donor Name'), 'operator' => 'like', ), 'id' => array( 'title' => ts('Contact ID'), 'no_display' => TRUE, ), 'gender_id' => array( 'title' => ts('Gender'), 'operatorType' => CRM_Report_Form::OP_MULTISELECT, 'options' => CRM_Core_PseudoConstant::get('CRM_Contact_DAO_Contact', 'gender_id'), ), 'birth_date' => array( 'title' => ts('Birth Date'), 'operatorType' => CRM_Report_Form::OP_DATE, ), 'contact_type' => array( 'title' => ts('Contact Type'), ), 'contact_sub_type' => array( 'title' => ts('Contact Subtype'), ), ), ), 'civicrm_line_item' => array( 'dao' => 'CRM_Price_DAO_LineItem', ), 'civicrm_email' => array( 'dao' => 'CRM_Core_DAO_Email', 'grouping' => 'contact-field', 'fields' => array( 'email' => array( 'title' => ts('Email'), 'default' => TRUE, ), ), ), 'civicrm_phone' => array( 'dao' => 'CRM_Core_DAO_Phone', 'grouping' => 'contact-field', 'fields' => array( 'phone' => array( 'title' => ts('Phone'), 'default' => TRUE, ), ), ), ); $this->_columns += $this->addAddressFields(); $this->_columns += array( 'civicrm_contribution' => array( 'dao' => 'CRM_Contribute_DAO_Contribution', 'fields' => array( 'contact_id' => array( 'title' => ts('contactId'), 'no_display' => TRUE, 'required' => TRUE, 'no_repeat' => TRUE, ), 'total_amount' => array( 'title' => ts('Total Amount'), 'no_display' => TRUE, 'required' => TRUE, 'no_repeat' => TRUE, ), 'receive_date' => array( 'title' => ts('Year'), 'no_display' => TRUE, 'required' => TRUE, 'no_repeat' => TRUE, ), ), 'filters' => array( 'yid' => array( 'name' => 'receive_date', 'title' => ts('This Year'), 'operatorType' => CRM_Report_Form::OP_SELECT, 'options' => $optionYear, 'default' => date('Y'), 'type' => CRM_Utils_Type::T_INT, ), 'financial_type_id' => array( 'title' => ts('Financial Type'), 'type' => CRM_Utils_Type::T_INT, 'operatorType' => CRM_Report_Form::OP_MULTISELECT, 'options' => CRM_Financial_BAO_FinancialType::getAvailableFinancialTypes(), ), 'contribution_status_id' => array( 'title' => ts('Contribution Status'), 'operatorType' => CRM_Report_Form::OP_MULTISELECT, 'options' => CRM_Contribute_PseudoConstant::contributionStatus(), 'default' => array('1'), ), ), ), ); $this->_columns += array( 'civicrm_financial_trxn' => array( 'dao' => 'CRM_Financial_DAO_FinancialTrxn', 'fields' => array( 'card_type_id' => array( 'title' => ts('Credit Card Type'), 'dbAlias' => 'GROUP_CONCAT(financial_trxn_civireport.card_type_id SEPARATOR ",")', ), ), 'filters' => array( 'card_type_id' => array( 'title' => ts('Credit Card Type'), 'operatorType' => CRM_Report_Form::OP_MULTISELECT, 'default' => NULL, 'options' => CRM_Financial_DAO_FinancialTrxn::buildOptions('card_type_id'), 'type' => CRM_Utils_Type::T_STRING, ), ), ), ); // If we have a campaign, build out the relevant elements if ($campaignEnabled && !empty($this->activeCampaigns)) { $this->_columns['civicrm_contribution']['fields']['campaign_id'] = array( 'title' => ts('Campaign'), 'default' => 'false', ); $this->_columns['civicrm_contribution']['filters']['campaign_id'] = array( 'title' => ts('Campaign'), 'operatorType' => CRM_Report_Form::OP_MULTISELECT, 'options' => $this->activeCampaigns, 'type' => CRM_Utils_Type::T_INT, ); } $this->_groupFilter = TRUE; $this->_tagFilter = TRUE; parent::__construct(); } public function preProcess() { parent::preProcess(); } public function select() { $select = array(); $this->_columnHeaders = array(); $current_year = $this->_params['yid_value']; $previous_year = $current_year - 1; $previous_pyear = $current_year - 2; $previous_ppyear = $current_year - 3; $upTo_year = $current_year - 4; foreach ($this->_columns as $tableName => $table) { if (array_key_exists('fields', $table)) { foreach ($table['fields'] as $fieldName => $field) { if (!empty($field['required']) || !empty($this->_params['fields'][$fieldName]) ) { if ($fieldName == 'total_amount') { $select[] = "SUM({$field['dbAlias']}) as {$tableName}_{$fieldName}"; $this->_columnHeaders["civicrm_upto_{$upTo_year}"]['type'] = $field['type']; $this->_columnHeaders["civicrm_upto_{$upTo_year}"]['title'] = ts("Up To %1", array(1 => $upTo_year)); $this->_columnHeaders["year_{$previous_ppyear}"]['type'] = $field['type']; $this->_columnHeaders["year_{$previous_ppyear}"]['title'] = $previous_ppyear; $this->_columnHeaders["year_{$previous_pyear}"]['type'] = $field['type']; $this->_columnHeaders["year_{$previous_pyear}"]['title'] = $previous_pyear; $this->_columnHeaders["year_{$previous_year}"]['type'] = $field['type']; $this->_columnHeaders["year_{$previous_year}"]['title'] = $previous_year; $this->_columnHeaders["civicrm_life_time_total"]['type'] = $field['type']; $this->_columnHeaders["civicrm_life_time_total"]['title'] = ts('LifeTime'); } elseif ($fieldName == 'receive_date') { $select[] = self::fiscalYearOffset($field['dbAlias']) . " as {$tableName}_{$fieldName}"; } else { $select[] = "{$field['dbAlias']} as {$tableName}_{$fieldName}"; $this->_columnHeaders["{$tableName}_{$fieldName}"]['type'] = CRM_Utils_Array::value('type', $field); $this->_columnHeaders["{$tableName}_{$fieldName}"]['title'] = $field['title']; } if (!empty($field['no_display'])) { $this->_columnHeaders["{$tableName}_{$fieldName}"]['no_display'] = TRUE; } } } } } $this->_selectClauses = $select; $this->_select = "SELECT " . implode(', ', $select) . " "; } public function from() { $this->setFromBase('civicrm_contribution', 'contact_id'); $this->_from .= " INNER JOIN civicrm_contact {$this->_aliases['civicrm_contact']} ON {$this->_aliases['civicrm_contact']}.id = {$this->_aliases['civicrm_contribution']}.contact_id {$this->_aclFrom}"; $this->joinPhoneFromContact(); $this->joinEmailFromContact(); // for credit card type $this->addFinancialTrxnFromClause(); $this->joinAddressFromContact(); } public function where() { $this->_statusClause = ""; $clauses = array($this->_aliases['civicrm_contribution'] . '.is_test = 0'); foreach ($this->_columns as $tableName => $table) { if (array_key_exists('filters', $table)) { foreach ($table['filters'] as $fieldName => $field) { $clause = NULL; if ($fieldName == 'yid') { $clause = "contribution_civireport.contact_id NOT IN (SELECT distinct cont.id FROM civicrm_contact cont, civicrm_contribution contri WHERE cont.id = contri.contact_id AND " . self::fiscalYearOffset('contri.receive_date') . " = {$this->_params['yid_value']} AND contri.is_test = 0 )"; } elseif (CRM_Utils_Array::value('type', $field) & CRM_Utils_Type::T_DATE ) { $relative = CRM_Utils_Array::value("{$fieldName}_relative", $this->_params); $from = CRM_Utils_Array::value("{$fieldName}_from", $this->_params); $to = CRM_Utils_Array::value("{$fieldName}_to", $this->_params); if ($relative || $from || $to) { $clause = $this->dateClause($field['name'], $relative, $from, $to, $field['type']); } } else { $op = CRM_Utils_Array::value("{$fieldName}_op", $this->_params); if ($op) { $clause = $this->whereClause($field, $op, CRM_Utils_Array::value("{$fieldName}_value", $this->_params), CRM_Utils_Array::value("{$fieldName}_min", $this->_params), CRM_Utils_Array::value("{$fieldName}_max", $this->_params) ); if (($fieldName == 'contribution_status_id' || $fieldName == 'financial_type_id') && !empty($clause) ) { $this->_statusClause .= " AND " . $clause; } } } if (!empty($clause)) { $clauses[] = $clause; } } } } $this->_where = "WHERE " . implode(' AND ', $clauses); if ($this->_aclWhere) { $this->_where .= " AND {$this->_aclWhere} "; } } public function groupBy() { $this->assign('chartSupported', TRUE); $fiscalYearOffset = self::fiscalYearOffset("{$this->_aliases['civicrm_contribution']}.receive_date"); $this->_groupBy = "GROUP BY {$this->_aliases['civicrm_contribution']}.contact_id, {$fiscalYearOffset}"; $this->_select = CRM_Contact_BAO_Query::appendAnyValueToSelect($this->_selectClauses, array("{$this->_aliases['civicrm_contribution']}.contact_id", $fiscalYearOffset)); $this->_groupBy .= " {$this->_rollup}"; } /** * @param $rows * * @return array */ public function statistics(&$rows) { $statistics = parent::statistics($rows); if (!empty($rows)) { $select = " SELECT SUM({$this->_aliases['civicrm_contribution']}.total_amount ) as amount "; $sql = "{$select} {$this->_from} {$this->_where}"; $dao = CRM_Core_DAO::executeQuery($sql); if ($dao->fetch()) { $statistics['counts']['amount'] = array( 'value' => $dao->amount, 'title' => ts('Total LifeTime'), 'type' => CRM_Utils_Type::T_MONEY, ); } } return $statistics; } public function postProcess() { // get ready with post process params $this->beginPostProcess(); $this->buildACLClause($this->_aliases['civicrm_contact']); $this->buildQuery(); $rows = $contactIds = array(); if (empty($this->_params['charts'])) { $this->limit(); $getContacts = "SELECT SQL_CALC_FOUND_ROWS {$this->_aliases['civicrm_contact']}.id as cid {$this->_from} {$this->_where} GROUP BY {$this->_aliases['civicrm_contact']}.id {$this->_limit}"; $dao = CRM_Core_DAO::executeQuery($getContacts); while ($dao->fetch()) { $contactIds[] = $dao->cid; } $dao->free(); $this->setPager(); } if (!empty($contactIds) || !empty($this->_params['charts'])) { if (!empty($this->_params['charts'])) { $sql = "{$this->_select} {$this->_from} {$this->_where} {$this->_groupBy}"; } else { $sql = "" . "{$this->_select} {$this->_from} WHERE {$this->_aliases['civicrm_contact']}.id IN (" . implode(',', $contactIds) . ") AND {$this->_aliases['civicrm_contribution']}.is_test = 0 {$this->_statusClause} {$this->_groupBy} "; } $current_year = $this->_params['yid_value']; $previous_year = $current_year - 1; $previous_pyear = $current_year - 2; $previous_ppyear = $current_year - 3; $upTo_year = $current_year - 4; $rows = $row = array(); $dao = CRM_Core_DAO::executeQuery($sql); $contributionSum = 0; $yearcal = array(); while ($dao->fetch()) { if (!$dao->civicrm_contribution_contact_id) { continue; } $row = array(); foreach ($this->_columnHeaders as $key => $value) { if (property_exists($dao, $key)) { $rows[$dao->civicrm_contribution_contact_id][$key] = $dao->$key; } } if ($dao->civicrm_contribution_receive_date) { if ($dao->civicrm_contribution_receive_date > $upTo_year) { $contributionSum += $dao->civicrm_contribution_total_amount; $rows[$dao->civicrm_contribution_contact_id]['year_' . $dao->civicrm_contribution_receive_date] = $dao->civicrm_contribution_total_amount; } } else { $rows[$dao->civicrm_contribution_contact_id]['civicrm_life_time_total'] = $dao->civicrm_contribution_total_amount; if (($dao->civicrm_contribution_total_amount - $contributionSum) > 0 ) { $rows[$dao->civicrm_contribution_contact_id]["civicrm_upto_{$upTo_year}"] = $dao->civicrm_contribution_total_amount - $contributionSum; } $contributionSum = 0; } } $dao->free(); } // format result set. $this->formatDisplay($rows, FALSE); // assign variables to templates $this->doTemplateAssignment($rows); // do print / pdf / instance stuff if needed $this->endPostProcess($rows); } /** * @param $rows */ public function buildChart(&$rows) { $graphRows = array(); $count = 0; $current_year = $this->_params['yid_value']; $previous_year = $current_year - 1; $previous_two_year = $current_year - 2; $previous_three_year = $current_year - 3; $upto = $current_year - 4; $interval[$previous_year] = $previous_year; $interval[$previous_two_year] = $previous_two_year; $interval[$previous_three_year] = $previous_three_year; $interval["upto_{$upto}"] = "Up To {$upto}"; foreach ($rows as $key => $row) { $display["upto_{$upto}"] = CRM_Utils_Array::value("upto_{$upto}", $display) + CRM_Utils_Array::value("civicrm_upto_{$upto}", $row); $display[$previous_year] = CRM_Utils_Array::value($previous_year, $display) + CRM_Utils_Array::value($previous_year, $row); $display[$previous_two_year] = CRM_Utils_Array::value($previous_two_year, $display) + CRM_Utils_Array::value($previous_two_year, $row); $display[$previous_three_year] = CRM_Utils_Array::value($previous_three_year, $display) + CRM_Utils_Array::value($previous_three_year, $row); } $graphRows['value'] = $display; $config = CRM_Core_Config::Singleton(); $chartInfo = array( 'legend' => ts('Sybunt Report'), 'xname' => ts('Year'), 'yname' => ts('Amount (%1)', array(1 => $config->defaultCurrency)), ); if ($this->_params['charts']) { // build the chart. CRM_Utils_OpenFlashChart::reportChart($graphRows, $this->_params['charts'], $interval, $chartInfo); $this->assign('chartType', $this->_params['charts']); } } /** * Alter display of rows. * * Iterate through the rows retrieved via SQL and make changes for display purposes, * such as rendering contacts as links. * * @param array $rows * Rows generated by SQL, with an array for each row. */ public function alterDisplay(&$rows) { $entryFound = FALSE; foreach ($rows as $rowNum => $row) { //Convert Display name into link if (array_key_exists('civicrm_contact_sort_name', $row) && array_key_exists('civicrm_contribution_contact_id', $row) ) { $url = CRM_Report_Utils_Report::getNextUrl('contribute/detail', 'reset=1&force=1&id_op=eq&id_value=' . $row['civicrm_contribution_contact_id'], $this->_absoluteUrl, $this->_id, $this->_drilldownReport ); $rows[$rowNum]['civicrm_contact_sort_name_link'] = $url; $rows[$rowNum]['civicrm_contact_sort_name_hover'] = ts("View Contribution Details for this Contact."); $entryFound = TRUE; } // convert campaign_id to campaign title if (array_key_exists('civicrm_contribution_campaign_id', $row)) { if ($value = $row['civicrm_contribution_campaign_id']) { $rows[$rowNum]['civicrm_contribution_campaign_id'] = $this->activeCampaigns[$value]; $entryFound = TRUE; } } $entryFound = $this->alterDisplayAddressFields($row, $rows, $rowNum, 'contribute/detail', 'List all contribution(s)') ? TRUE : $entryFound; //handle gender if (array_key_exists('civicrm_contact_gender_id', $row)) { if ($value = $row['civicrm_contact_gender_id']) { $gender = CRM_Core_PseudoConstant::get('CRM_Contact_DAO_Contact', 'gender_id'); $rows[$rowNum]['civicrm_contact_gender_id'] = $gender[$value]; } $entryFound = TRUE; } // display birthday in the configured custom format if (array_key_exists('civicrm_contact_birth_date', $row)) { $birthDate = $row['civicrm_contact_birth_date']; if ($birthDate) { $rows[$rowNum]['civicrm_contact_birth_date'] = CRM_Utils_Date::customFormat($birthDate, '%Y%m%d'); } $entryFound = TRUE; } if (!empty($row['civicrm_financial_trxn_card_type_id'])) { $rows[$rowNum]['civicrm_financial_trxn_card_type_id'] = $this->getLabels($row['civicrm_financial_trxn_card_type_id'], 'CRM_Financial_DAO_FinancialTrxn', 'card_type_id'); $entryFound = TRUE; } // skip looking further in rows, if first row itself doesn't // have the column we need if (!$entryFound) { break; } } } /** * Override "This Year" $op options * @param string $type * @param null $fieldName * * @return array */ public function getOperationPair($type = "string", $fieldName = NULL) { if ($fieldName == 'yid') { return array( 'calendar' => ts('Is Calendar Year'), 'fiscal' => ts('Fiscal Year Starting'), ); } return parent::getOperationPair($type, $fieldName); } }