CRM/Core/Page.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 5                                                  |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2019                                |
   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-2019
  32  */
  33
  34 /**
  35  * A Page is basically data in a nice pretty format.
  36  *
  37  * Pages should not have any form actions / elements in them. If they
  38  * do, make sure you use CRM_Core_Form and the related structures. You can
  39  * embed simple forms in Page and do your own form handling.
  40  *
  41  */
  42 class CRM_Core_Page {
  43
  44   /**
  45    * The name of the page (auto generated from class name)
  46    *
  47    * @var string
  48    */
  49   protected $_name;
  50
  51   /**
  52    * The title associated with this page.
  53    *
  54    * @var object
  55    */
  56   protected $_title;
  57
  58   /**
  59    * A page can have multiple modes. (i.e. displays
  60    * a different set of data based on the input
  61    * @var int
  62    */
  63   protected $_mode;
  64
  65   /**
  66    * Is this object being embedded in another object. If
  67    * so the display routine needs to not do any work. (The
  68    * parent object takes care of the display)
  69    *
  70    * @var bool
  71    */
  72   protected $_embedded = FALSE;
  73
  74   /**
  75    * Are we in print mode? if so we need to modify the display
  76    * functionality to do a minimal display :)
  77    *
  78    * @var bool
  79    */
  80   protected $_print = FALSE;
  81
  82   /**
  83    * Cache the smarty template for efficiency reasons
  84    *
  85    * @var CRM_Core_Smarty
  86    */
  87   static protected $_template;
  88
  89   /**
  90    * Cache the session for efficiency reasons
  91    *
  92    * @var CRM_Core_Session
  93    */
  94   static protected $_session;
  95
  96   /**
  97    * What to return to the client if in ajax mode (snippet=json)
  98    *
  99    * @var array
 100    */
 101   public $ajaxResponse = [];
 102
 103   /**
 104    * Url path used to reach this page
 105    *
 106    * @var array
 107    */
 108   public $urlPath = [];
 109
 110   /**
 111    * Should crm.livePage.js be added to the page?
 112    * @var bool
 113    */
 114   public $useLivePageJS;
 115
 116   /**
 117    * Class constructor.
 118    *
 119    * @param string $title
 120    *   Title of the page.
 121    * @param int $mode
 122    *   Mode of the page.
 123    *
 124    * @return CRM_Core_Page
 125    */
 126   public function __construct($title = NULL, $mode = NULL) {
 127     $this->_name = CRM_Utils_System::getClassName($this);
 128     $this->_title = $title;
 129     $this->_mode = $mode;
 130
 131     // let the constructor initialize this, should happen only once
 132     if (!isset(self::$_template)) {
 133       self::$_template = CRM_Core_Smarty::singleton();
 134       self::$_session = CRM_Core_Session::singleton();
 135     }
 136
 137     // FIXME - why are we messing with 'snippet'? Why not just pass it directly into $this->_print?
 138     if (!empty($_REQUEST['snippet'])) {
 139       if ($_REQUEST['snippet'] == CRM_Core_Smarty::PRINT_PDF) {
 140         $this->_print = CRM_Core_Smarty::PRINT_PDF;
 141       }
 142       // FIXME - why does this number not match the constant?
 143       elseif ($_REQUEST['snippet'] == 5) {
 144         $this->_print = CRM_Core_Smarty::PRINT_NOFORM;
 145       }
 146       // Support 'json' as well as legacy value '6'
 147       elseif (in_array($_REQUEST['snippet'], [CRM_Core_Smarty::PRINT_JSON, 6])) {
 148         $this->_print = CRM_Core_Smarty::PRINT_JSON;
 149       }
 150       else {
 151         $this->_print = CRM_Core_Smarty::PRINT_SNIPPET;
 152       }
 153     }
 154
 155     // if the request has a reset value, initialize the controller session
 156     if (!empty($_REQUEST['reset'])) {
 157       $this->reset();
 158     }
 159   }
 160
 161   /**
 162    * This function takes care of all the things common to all pages.
 163    *
 164    * This typically involves assigning the appropriate smarty variables :)
 165    */
 166   public function run() {
 167     if ($this->_embedded) {
 168       return NULL;
 169     }
 170
 171     self::$_template->assign('mode', $this->_mode);
 172
 173     $pageTemplateFile = $this->getHookedTemplateFileName();
 174     self::$_template->assign('tplFile', $pageTemplateFile);
 175
 176     // invoke the pagRun hook, CRM-3906
 177     CRM_Utils_Hook::pageRun($this);
 178
 179     if ($this->_print) {
 180       if (in_array($this->_print, [
 181         CRM_Core_Smarty::PRINT_SNIPPET,
 182         CRM_Core_Smarty::PRINT_PDF,
 183         CRM_Core_Smarty::PRINT_NOFORM,
 184         CRM_Core_Smarty::PRINT_JSON,
 185       ])) {
 186         $content = self::$_template->fetch('CRM/common/snippet.tpl');
 187       }
 188       else {
 189         $content = self::$_template->fetch('CRM/common/print.tpl');
 190       }
 191
 192       CRM_Utils_System::appendTPLFile($pageTemplateFile,
 193         $content,
 194         $this->overrideExtraTemplateFileName()
 195       );
 196
 197       //its time to call the hook.
 198       CRM_Utils_Hook::alterContent($content, 'page', $pageTemplateFile, $this);
 199
 200       if ($this->_print == CRM_Core_Smarty::PRINT_PDF) {
 201         CRM_Utils_PDF_Utils::html2pdf($content, "{$this->_name}.pdf", FALSE,
 202           ['paper_size' => 'a3', 'orientation' => 'landscape']
 203         );
 204       }
 205       elseif ($this->_print == CRM_Core_Smarty::PRINT_JSON) {
 206         $this->ajaxResponse['content'] = $content;
 207         CRM_Core_Page_AJAX::returnJsonResponse($this->ajaxResponse);
 208       }
 209       else {
 210         echo $content;
 211       }
 212       CRM_Utils_System::civiExit();
 213     }
 214
 215     $config = CRM_Core_Config::singleton();
 216
 217     // @fixme this is probably the wrong place for this.  It is required by jsortable.tpl which is inherited from many page templates.
 218     //   So we have to add it here to deprecate $config->defaultCurrencySymbol
 219     $this->assign('defaultCurrencySymbol', CRM_Core_BAO_Country::defaultCurrencySymbol());
 220
 221     // Intermittent alert to admins
 222     CRM_Utils_Check::singleton()->showPeriodicAlerts();
 223
 224     if ($this->useLivePageJS && Civi::settings()->get('ajaxPopupsEnabled')) {
 225       CRM_Core_Resources::singleton()->addScriptFile('civicrm', 'js/crm.livePage.js', 1, 'html-header');
 226     }
 227
 228     $content = self::$_template->fetch('CRM/common/' . strtolower($config->userFramework) . '.tpl');
 229
 230     // Render page header
 231     if (!defined('CIVICRM_UF_HEAD') && $region = CRM_Core_Region::instance('html-header', FALSE)) {
 232       CRM_Utils_System::addHTMLHead($region->render(''));
 233     }
 234     CRM_Utils_System::appendTPLFile($pageTemplateFile, $content);
 235
 236     //its time to call the hook.
 237     CRM_Utils_Hook::alterContent($content, 'page', $pageTemplateFile, $this);
 238
 239     echo CRM_Utils_System::theme($content, $this->_print);
 240   }
 241
 242   /**
 243    * Store the variable with the value in the form scope.
 244    *
 245    * @param string|array $name name of the variable or an assoc array of name/value pairs
 246    * @param mixed $value
 247    *   Value of the variable if string.
 248    */
 249   public function set($name, $value = NULL) {
 250     self::$_session->set($name, $value, $this->_name);
 251   }
 252
 253   /**
 254    * Get the variable from the form scope.
 255    *
 256    * @param string $name name of the variable
 257    *
 258    * @return mixed
 259    */
 260   public function get($name) {
 261     return self::$_session->get($name, $this->_name);
 262   }
 263
 264   /**
 265    * Assign value to name in template.
 266    *
 267    * @param string $var
 268    * @param mixed $value
 269    *   Value of variable.
 270    */
 271   public function assign($var, $value = NULL) {
 272     self::$_template->assign($var, $value);
 273   }
 274
 275   /**
 276    * Assign value to name in template by reference.
 277    *
 278    * @param string $var
 279    * @param mixed $value
 280    *   (reference) value of variable.
 281    */
 282   public function assign_by_ref($var, &$value) {
 283     self::$_template->assign_by_ref($var, $value);
 284   }
 285
 286   /**
 287    * Appends values to template variables.
 288    *
 289    * @param array|string $tpl_var the template variable name(s)
 290    * @param mixed $value
 291    *   The value to append.
 292    * @param bool $merge
 293    */
 294   public function append($tpl_var, $value = NULL, $merge = FALSE) {
 295     self::$_template->append($tpl_var, $value, $merge);
 296   }
 297
 298   /**
 299    * Returns an array containing template variables.
 300    *
 301    * @param string $name
 302    *
 303    * @return array
 304    */
 305   public function get_template_vars($name = NULL) {
 306     return self::$_template->get_template_vars($name);
 307   }
 308
 309   /**
 310    * Destroy all the session state of this page.
 311    */
 312   public function reset() {
 313     self::$_session->resetScope($this->_name);
 314   }
 315
 316   /**
 317    * Use the form name to create the tpl file name.
 318    *
 319    * @return string
 320    */
 321   public function getTemplateFileName() {
 322     return strtr(
 323       CRM_Utils_System::getClassName($this),
 324       [
 325         '_' => DIRECTORY_SEPARATOR,
 326         '\\' => DIRECTORY_SEPARATOR,
 327       ]
 328     ) . '.tpl';
 329   }
 330
 331   /**
 332    * A wrapper for getTemplateFileName that includes calling the hook to
 333    * prevent us from having to copy & paste the logic of calling the hook
 334    */
 335   public function getHookedTemplateFileName() {
 336     $pageTemplateFile = $this->getTemplateFileName();
 337     CRM_Utils_Hook::alterTemplateFile(get_class($this), $this, 'page', $pageTemplateFile);
 338     return $pageTemplateFile;
 339   }
 340
 341   /**
 342    * Default extra tpl file basically just replaces .tpl with .extra.tpl
 343    * i.e. we dont override
 344    *
 345    * @return string
 346    */
 347   public function overrideExtraTemplateFileName() {
 348     return NULL;
 349   }
 350
 351   /**
 352    * Setter for embedded.
 353    *
 354    * @param bool $embedded
 355    */
 356   public function setEmbedded($embedded) {
 357     $this->_embedded = $embedded;
 358   }
 359
 360   /**
 361    * Getter for embedded.
 362    *
 363    * @return bool
 364    *   return the embedded value
 365    */
 366   public function getEmbedded() {
 367     return $this->_embedded;
 368   }
 369
 370   /**
 371    * Setter for print.
 372    *
 373    * @param bool $print
 374    */
 375   public function setPrint($print) {
 376     $this->_print = $print;
 377   }
 378
 379   /**
 380    * Getter for print.
 381    *
 382    * @return bool
 383    *   return the print value
 384    */
 385   public function getPrint() {
 386     return $this->_print;
 387   }
 388
 389   /**
 390    * @return CRM_Core_Smarty
 391    */
 392   public static function &getTemplate() {
 393     return self::$_template;
 394   }
 395
 396   /**
 397    * @param string $name
 398    *
 399    * @return null
 400    */
 401   public function getVar($name) {
 402     return isset($this->$name) ? $this->$name : NULL;
 403   }
 404
 405   /**
 406    * @param string $name
 407    * @param $value
 408    */
 409   public function setVar($name, $value) {
 410     $this->$name = $value;
 411   }
 412
 413   /**
 414    * Assign metadata about fields to the template.
 415    *
 416    * In order to allow the template to format fields we assign information about them to the template.
 417    *
 418    * At this stage only date field metadata is assigned as that is the only use-case in play and
 419    * we don't want to assign a lot of unneeded data.
 420    *
 421    * @param string $entity
 422    *   The entity being queried.
 423    *
 424    * @throws \CiviCRM_API3_Exception
 425    */
 426   protected function assignFieldMetadataToTemplate($entity) {
 427     $fields = civicrm_api3($entity, 'getfields', ['action' => 'get']);
 428     $dateFields = [];
 429     foreach ($fields['values'] as $fieldName => $fieldMetaData) {
 430       if (isset($fieldMetaData['html']) && CRM_Utils_Array::value('type', $fieldMetaData['html']) == 'Select Date') {
 431         $dateFields[$fieldName] = CRM_Utils_Date::addDateMetadataToField($fieldMetaData, $fieldMetaData);
 432       }
 433     }
 434     $this->assign('fields', $dateFields);
 435   }
 436
 437 }