CRM/Core/QuickForm/Action/Display.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.5                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2014                                |
   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  * Redefine the display action.
  30  *
  31  * @package CRM
  32  * @copyright CiviCRM LLC (c) 2004-2014
  33  * $Id$
  34  *
  35  */
  36 class CRM_Core_QuickForm_Action_Display extends CRM_Core_QuickForm_Action {
  37
  38   /**
  39    * the template to display the required "red" asterick
  40    * @var string
  41    */
  42   static $_requiredTemplate = NULL;
  43
  44   /**
  45    * the template to display error messages inline with the form element
  46    * @var string
  47    */
  48   static $_errorTemplate = NULL;
  49
  50   /**
  51    * class constructor
  52    *
  53    * @param object $stateMachine reference to state machine object
  54    *
  55    * @return \CRM_Core_QuickForm_Action_Display
  56   @access public
  57    */
  58   function __construct(&$stateMachine) {
  59     parent::__construct($stateMachine);
  60   }
  61
  62   /**
  63    * Processes the request.
  64    *
  65    * @param  object    $page       CRM_Core_Form the current form-page
  66    * @param  string    $actionName Current action name, as one Action object can serve multiple actions
  67    *
  68    * @return void
  69    * @access public
  70    */
  71   function perform(&$page, $actionName) {
  72     $pageName = $page->getAttribute('id');
  73
  74     // If the original action was 'display' and we have values in container then we load them
  75     // BTW, if the page was invalid, we should later call validate() to get the errors
  76     list(, $oldName) = $page->controller->getActionName();
  77     if ('display' == $oldName) {
  78       // If the controller is "modal" we should not allow direct access to a page
  79       // unless all previous pages are valid (see also bug #2323)
  80       if ($page->controller->isModal() && !$page->controller->isValid($page->getAttribute('id'))) {
  81         $target = &$page->controller->getPage($page->controller->findInvalid());
  82         return $target->handle('jump');
  83       }
  84       $data = &$page->controller->container();
  85       if (!empty($data['values'][$pageName])) {
  86         $page->loadValues($data['values'][$pageName]);
  87         $validate = FALSE === $data['valid'][$pageName];
  88       }
  89     }
  90
  91     // set "common" defaults and constants
  92     $page->controller->applyDefaults($pageName);
  93     $page->isFormBuilt() or $page->buildForm();
  94     // if we had errors we should show them again
  95     if (isset($validate) && $validate) {
  96       $page->validate();
  97     }
  98     //will this work generally as TRUE (i.e., return output)
  99     //was default, i.e., FALSE
 100     return $this->renderForm($page);
 101   }
 102
 103   /**
 104    * render the page using a custom templating
 105    * system
 106    *
 107    * @param object $page the CRM_Core_Form page
 108    *
 109    * @internal param bool $ret should we echo or return output
 110    *
 111    * @return void
 112    * @access public
 113    */
 114   function renderForm(&$page) {
 115     $this->_setRenderTemplates($page);
 116     $template = CRM_Core_Smarty::singleton();
 117     $form = $page->toSmarty();
 118
 119     // Deprecated - use snippet=6 instead of json=1
 120     $json = CRM_Utils_Request::retrieve('json', 'Boolean', CRM_Core_DAO::$_nullObject);
 121     if ($json) {
 122       echo json_encode($form);
 123       CRM_Utils_System::civiExit();
 124     }
 125
 126     $template->assign('form', $form);
 127     $template->assign('isForm', 1);
 128
 129     $controller = &$page->controller;
 130     // Stop here if we are in embedded mode. Exception: displaying form errors via ajax
 131     if ($controller->getEmbedded() && !(!empty($form['errors']) && $controller->_QFResponseType == 'json')) {
 132       return;
 133     }
 134
 135     $template->assign('action', $page->getAction());
 136
 137     $pageTemplateFile = $page->getHookedTemplateFileName();
 138     $template->assign('tplFile', $pageTemplateFile);
 139
 140     $content = $template->fetch($controller->getTemplateFile());
 141
 142     if (!defined('CIVICRM_UF_HEAD') && $region = CRM_Core_Region::instance('html-header', FALSE)) {
 143       CRM_Utils_System::addHTMLHead($region->render(''));
 144     }
 145     CRM_Utils_System::appendTPLFile($pageTemplateFile,
 146       $content,
 147       $page->overrideExtraTemplateFileName()
 148     );
 149
 150     //its time to call the hook.
 151     CRM_Utils_Hook::alterContent($content, 'form', $pageTemplateFile, $page);
 152
 153     $print = $controller->getPrint();
 154     if ($print) {
 155       $html = &$content;
 156     }
 157     else {
 158       $html = CRM_Utils_System::theme($content, $print);
 159     }
 160
 161     if ($controller->_QFResponseType == 'json') {
 162       $response = array('content' => $html);
 163       if (!empty($page->ajaxResponse)) {
 164         $response += $page->ajaxResponse;
 165       }
 166       if (!empty($form['errors'])) {
 167         $response['status'] = 'form_error';
 168         $response['errors'] = $form['errors'];
 169       }
 170       CRM_Core_Page_AJAX::returnJsonResponse($response);
 171     }
 172
 173     if ($print) {
 174       if ($print == CRM_Core_Smarty::PRINT_PDF) {
 175         CRM_Utils_PDF_Utils::html2pdf(
 176           $content,
 177           "{$page->_name}.pdf",
 178           FALSE,
 179           array('paper_size' => 'a3', 'orientation' => 'landscape')
 180         );
 181       }
 182       else {
 183         echo $html;
 184       }
 185       CRM_Utils_System::civiExit();
 186     }
 187
 188     print $html;
 189   }
 190
 191   /**
 192    * set the various rendering templates
 193    *
 194    * @param object  $page the CRM_Core_Form page
 195    *
 196    * @return void
 197    * @access public
 198    */
 199   function _setRenderTemplates(&$page) {
 200     if (self::$_requiredTemplate === NULL) {
 201       $this->initializeTemplates();
 202     }
 203
 204     $renderer = &$page->getRenderer();
 205
 206     $renderer->setRequiredTemplate(self::$_requiredTemplate);
 207     $renderer->setErrorTemplate(self::$_errorTemplate);
 208   }
 209
 210   /**
 211    * initialize the various templates
 212    *
 213    * @param object  $page the CRM_Core_Form page
 214    *
 215    * @return void
 216    * @access public
 217    */
 218   function initializeTemplates() {
 219     if (self::$_requiredTemplate !== NULL) {
 220       return;
 221     }
 222
 223     $config = CRM_Core_Config::singleton();
 224
 225     $templateDir = $config->templateDir;
 226     if (is_array($templateDir)) {
 227       $templateDir = array_pop($templateDir);
 228     }
 229
 230     self::$_requiredTemplate = file_get_contents($templateDir . '/CRM/Form/label.tpl');
 231     self::$_errorTemplate = file_get_contents($templateDir . '/CRM/Form/error.tpl');
 232   }
 233 }
 234