CRM/Report/Page/InstanceList.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.7                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2015                                |
   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-2015
  32  */
  33
  34 /**
  35  * Page for invoking report instances.
  36  */
  37 class CRM_Report_Page_InstanceList extends CRM_Core_Page {
  38
  39   static $_links = NULL;
  40
  41   static $_exceptions = array('logging/contact/detail');
  42
  43   /**
  44    * Name of component if report list is filtered.
  45    *
  46    * @var string
  47    */
  48   protected $_compName = NULL;
  49
  50   /**
  51    * ID of component if report list is filtered.
  52    *
  53    * @var int
  54    */
  55   protected $_compID = NULL;
  56
  57   /**
  58    * ID of grouping if report list is filtered.
  59    *
  60    * @var int
  61    */
  62   protected $_grouping = NULL;
  63
  64   /**
  65    * ID of parent report template if list is filtered by template.
  66    *
  67    * @var int
  68    */
  69   protected $_ovID = NULL;
  70
  71   /**
  72    * Title of parent report template if list is filtered by template.
  73    *
  74    * @var string
  75    */
  76   protected $_title = NULL;
  77
  78   /**
  79    * Retrieves report instances, optionally filtered.
  80    *
  81    * Filtering available by parent report template ($ovID) or by component ($compID).
  82    *
  83    * @return array
  84    */
  85   public function info() {
  86
  87     $report = '';
  88     if ($this->ovID) {
  89       $report .= " AND v.id = {$this->ovID} ";
  90     }
  91
  92     if ($this->compID) {
  93       if ($this->compID == 99) {
  94         $report .= " AND v.component_id IS NULL ";
  95         $this->_compName = 'Contact';
  96       }
  97       else {
  98         $report .= " AND v.component_id = {$this->compID} ";
  99         $cmpName = CRM_Core_DAO::getFieldValue('CRM_Core_DAO_Component', $this->compID,
 100           'name', 'id'
 101         );
 102         $this->_compName = substr($cmpName, 4);
 103         if ($this->_compName == 'Contribute') {
 104           $this->_compName = 'Contribution';
 105         }
 106       }
 107     }
 108     elseif ($this->grouping) {
 109       $report .= " AND v.grouping = '{$this->grouping}' ";
 110     }
 111
 112     $sql = "
 113         SELECT inst.id, inst.title, inst.report_id, inst.description, v.label, v.grouping, v.name as class_name,
 114         CASE
 115           WHEN comp.name IS NOT NULL THEN SUBSTRING(comp.name, 5)
 116           WHEN v.grouping IS NOT NULL THEN v.grouping
 117           ELSE 'Contact'
 118           END as compName
 119           FROM civicrm_option_group g
 120           LEFT JOIN civicrm_option_value v
 121                  ON v.option_group_id = g.id AND
 122                     g.name  = 'report_template'
 123           LEFT JOIN civicrm_report_instance inst
 124                  ON v.value = inst.report_id
 125           LEFT JOIN civicrm_component comp
 126                  ON v.component_id = comp.id
 127
 128           WHERE v.is_active = 1 {$report}
 129                 AND inst.domain_id = %1
 130           ORDER BY  v.weight";
 131
 132     $dao = CRM_Core_DAO::executeQuery($sql, array(
 133       1 => array(CRM_Core_Config::domainID(), 'Integer'),
 134     ));
 135
 136     $config = CRM_Core_Config::singleton();
 137     $rows = array();
 138     $url = 'civicrm/report/instance';
 139     while ($dao->fetch()) {
 140       if (in_array($dao->report_id, self::$_exceptions)) {
 141         continue;
 142       }
 143
 144       $enabled = in_array("Civi{$dao->compName}", $config->enableComponents);
 145       if ($dao->compName == 'Contact' || $dao->compName == $dao->grouping) {
 146         $enabled = TRUE;
 147       }
 148       //filter report listings by permissions
 149       if (!($enabled && CRM_Report_Utils_Report::isInstancePermissioned($dao->id))) {
 150         continue;
 151       }
 152       //filter report listing by group/role
 153       if (!($enabled && CRM_Report_Utils_Report::isInstanceGroupRoleAllowed($dao->id))) {
 154         continue;
 155       }
 156
 157       if (trim($dao->title)) {
 158         if ($this->ovID) {
 159           $this->title = ts("Report(s) created from the template: %1", array(1 => $dao->label));
 160         }
 161         $rows[$dao->compName][$dao->id]['title'] = $dao->title;
 162         $rows[$dao->compName][$dao->id]['label'] = $dao->label;
 163         $rows[$dao->compName][$dao->id]['description'] = $dao->description;
 164         $rows[$dao->compName][$dao->id]['url'] = CRM_Utils_System::url("{$url}/{$dao->id}", "reset=1&output=criteria");
 165         $rows[$dao->compName][$dao->id]['viewUrl'] = CRM_Utils_System::url("{$url}/{$dao->id}", 'force=1&reset=1');
 166         $rows[$dao->compName][$dao->id]['actions'] = $this->getActionLinks($dao->id, $dao->class_name);
 167       }
 168     }
 169     return $rows;
 170   }
 171
 172   /**
 173    * Run this page (figure out the action needed and perform it).
 174    */
 175   public function run() {
 176     //Filters by source report template or by component
 177     $this->ovID = CRM_Utils_Request::retrieve('ovid', 'Positive', $this);
 178     $this->compID = CRM_Utils_Request::retrieve('compid', 'Positive', $this);
 179     $this->grouping = CRM_Utils_Request::retrieve('grp', 'String', $this);
 180
 181     $rows = $this->info();
 182
 183     $this->assign('list', $rows);
 184     if ($this->ovID OR $this->compID) {
 185       // link to view all reports
 186       $reportUrl = CRM_Utils_System::url('civicrm/report/list', "reset=1");
 187       $this->assign('reportUrl', $reportUrl);
 188       if ($this->ovID) {
 189         $this->assign('title', $this->title);
 190       }
 191       else {
 192         CRM_Utils_System::setTitle(ts('%1 Reports', array(1 => $this->_compName)));
 193       }
 194     }
 195     // assign link to template list for users with appropriate permissions
 196     if (CRM_Core_Permission::check('administer Reports')) {
 197       if ($this->compID) {
 198         $newButton = ts('New %1 Report', array(1 => $this->_compName));
 199         $templateUrl = CRM_Utils_System::url('civicrm/report/template/list', "reset=1&compid={$this->compID}");
 200       }
 201       else {
 202         $newButton = ts('New Report');
 203         $templateUrl = CRM_Utils_System::url('civicrm/report/template/list', "reset=1");
 204       }
 205       $this->assign('newButton', $newButton);
 206       $this->assign('templateUrl', $templateUrl);
 207       $this->assign('compName', $this->_compName);
 208     }
 209     return parent::run();
 210   }
 211
 212   /**
 213    * Get action links.
 214    *
 215    * @param int $instanceID
 216    * @param string $className
 217    *
 218    * @return array
 219    */
 220   protected function getActionLinks($instanceID, $className) {
 221     $urlCommon = 'civicrm/report/instance/' . $instanceID;
 222     $actions = array(
 223       'copy' => array(
 224         'url' => CRM_Utils_System::url($urlCommon, 'reset=1&output=copy'),
 225         'label' => ts('Save a Copy'),
 226       ),
 227       'pdf' => array(
 228         'url' => CRM_Utils_System::url($urlCommon, 'reset=1&force=1&output=pdf'),
 229         'label' => ts('View as pdf'),
 230       ),
 231       'print' => array(
 232         'url' => CRM_Utils_System::url($urlCommon, 'reset=1&force=1&output=print'),
 233         'label' => ts('Print report'),
 234       ),
 235     );
 236     // Hackery, Hackera, Hacker ahahahahahaha a super nasty hack.
 237     // Almost all report classes support csv & loading each class to call the method seems too
 238     // expensive. We also have on our later list 'do they support charts' which is instance specific
 239     // e.g use of group by might affect it. So, lets just skip for the few that don't for now.
 240     $csvBlackList = array(
 241       'CRM_Report_Form_Contact_Detail',
 242       'CRM_Report_Form_Event_Income',
 243     );
 244     if (!in_array($className, $csvBlackList)) {
 245       $actions['csv'] = array(
 246         'url' => CRM_Utils_System::url($urlCommon, 'reset=1&force=1&output=csv'),
 247         'label' => ts('Export to csv'),
 248       );
 249     }
 250     if (CRM_Core_Permission::check('administer Reports')) {
 251       $actions['delete'] = array(
 252         'url' => CRM_Utils_System::url($urlCommon, 'reset=1&action=delete'),
 253         'label' => ts('Delete report'),
 254         'confirm_message' => ts('Are you sure you want delete this report? This action cannot be undone.'),
 255       );
 256     }
 257
 258     return $actions;
 259   }
 260
 261 }