CRM/Admin/Form/MessageTemplates.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 5                                                  |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2018                                |
   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-2018
  32  */
  33
  34 /**
  35  * This class generates form components for Message templates
  36  * used by membership, contributions, event registrations, etc.
  37  */
  38 class CRM_Admin_Form_MessageTemplates extends CRM_Admin_Form {
  39   // which (and whether) mailing workflow this template belongs to
  40   protected $_workflow_id = NULL;
  41
  42   // Is document file is already loaded as default value?
  43   protected $_is_document = FALSE;
  44
  45   public function preProcess() {
  46     $this->_id = CRM_Utils_Request::retrieve('id', 'Positive', $this);
  47     $this->_action = CRM_Utils_Request::retrieve('action', 'String',
  48       $this, FALSE, 'add'
  49     );
  50     $this->assign('action', $this->_action);
  51
  52     $this->_BAOName = 'CRM_Core_BAO_MessageTemplate';
  53     $this->set('BAOName', $this->_BAOName);
  54     parent::preProcess();
  55   }
  56
  57   /**
  58    * Set default values for the form.
  59    *
  60    * The default values are retrieved from the database.
  61    */
  62   public function setDefaultValues() {
  63     $defaults = $this->_values;
  64
  65     if (empty($defaults['pdf_format_id'])) {
  66       $defaults['pdf_format_id'] = 'null';
  67     }
  68     if (empty($defaults['file_type'])) {
  69       $defaults['file_type'] = 0;
  70     }
  71
  72     if ($this->_action & CRM_Core_Action::ADD) {
  73       $defaults['is_active'] = 1;
  74     }
  75
  76     if ($this->_action & CRM_Core_Action::UPDATE) {
  77       $documentInfo = CRM_Core_BAO_File::getEntityFile('civicrm_msg_template', $this->_id, TRUE);
  78       if (!empty($documentInfo)) {
  79         $defaults['file_type'] = 1;
  80         $this->_is_document = TRUE;
  81         $this->assign('attachment', $documentInfo);
  82       }
  83     }
  84
  85     return $defaults;
  86   }
  87
  88   /**
  89    * Build the form object.
  90    */
  91   public function buildQuickForm() {
  92     // For VIEW we only want Done button
  93     if ($this->_action & CRM_Core_Action::VIEW) {
  94       // currently, the above action is used solely for previewing default workflow templates
  95       $cancelURL = CRM_Utils_System::url('civicrm/admin/messageTemplates', 'selectedChild=workflow&reset=1');
  96       $cancelURL = str_replace('&amp;', '&', $cancelURL);
  97       $this->addButtons(array(
  98           array(
  99             'type' => 'cancel',
 100             'name' => ts('Done'),
 101             'js' => array('onclick' => "location.href='{$cancelURL}'; return false;"),
 102             'isDefault' => TRUE,
 103           ),
 104         )
 105       );
 106     }
 107     else {
 108       $this->_workflow_id = CRM_Utils_Array::value('workflow_id', $this->_values);
 109       $this->assign('workflow_id', $this->_workflow_id);
 110
 111       if ($this->_workflow_id) {
 112         $selectedChild = 'workflow';
 113       }
 114       else {
 115         $selectedChild = 'user';
 116       }
 117
 118       $cancelURL = CRM_Utils_System::url('civicrm/admin/messageTemplates', "selectedChild={$selectedChild}&reset=1");
 119       $cancelURL = str_replace('&amp;', '&', $cancelURL);
 120       $buttons[] = array(
 121         'type' => 'upload',
 122         'name' => $this->_action & CRM_Core_Action::DELETE ? ts('Delete') : ts('Save'),
 123         'isDefault' => TRUE,
 124       );
 125       if (!($this->_action & CRM_Core_Action::DELETE)) {
 126         $buttons[] = array(
 127           'type' => 'submit',
 128           'name' => ts('Save and Done'),
 129           'subName' => 'done',
 130         );
 131       }
 132       $buttons[] = array(
 133         'type' => 'cancel',
 134         'name' => ts('Cancel'),
 135         'js' => array('onclick' => "location.href='{$cancelURL}'; return false;"),
 136       );
 137       $this->addButtons($buttons);
 138     }
 139
 140     if ($this->_action & CRM_Core_Action::DELETE) {
 141       return;
 142     }
 143
 144     $breadCrumb = array(
 145       array(
 146         'title' => ts('Message Templates'),
 147         'url' => CRM_Utils_System::url('civicrm/admin/messageTemplates',
 148           'action=browse&reset=1'
 149         ),
 150       ),
 151     );
 152     CRM_Utils_System::appendBreadCrumb($breadCrumb);
 153
 154     $this->applyFilter('__ALL__', 'trim');
 155     $this->add('text', 'msg_title', ts('Message Title'), CRM_Core_DAO::getAttribute('CRM_Core_DAO_MessageTemplate', 'msg_title'), TRUE);
 156
 157     $options = array(ts('Compose On-screen'), ts('Upload Document'));
 158     $element = $this->addRadio('file_type', ts('Source'), $options);
 159     if ($this->_id) {
 160       $element->freeze();
 161     }
 162
 163     $this->addElement('file', "file_id", ts('Upload Document'), 'size=30 maxlength=255');
 164     $this->addUploadElement("file_id");
 165
 166     $this->add('text', 'msg_subject',
 167       ts('Message Subject'),
 168       CRM_Core_DAO::getAttribute('CRM_Core_DAO_MessageTemplate', 'msg_subject')
 169     );
 170
 171     //get the tokens.
 172     $tokens = CRM_Core_SelectValues::contactTokens();
 173
 174     $this->assign('tokens', CRM_Utils_Token::formatTokensForDisplay($tokens));
 175
 176     // if not a system message use a wysiwyg editor, CRM-5971
 177     if ($this->_id &&
 178       CRM_Core_DAO::getFieldValue('CRM_Core_DAO_MessageTemplate',
 179         $this->_id,
 180         'workflow_id'
 181       )
 182     ) {
 183       $this->add('textarea', 'msg_html', ts('HTML Message'),
 184         "cols=50 rows=6"
 185       );
 186     }
 187     else {
 188       $this->add('wysiwyg', 'msg_html', ts('HTML Message'),
 189         array(
 190           'cols' => '80',
 191           'rows' => '8',
 192           'onkeyup' => "return verify(this)",
 193           'preset' => 'civimail',
 194         )
 195       );
 196     }
 197
 198     $this->add('textarea', 'msg_text', ts('Text Message'),
 199       "cols=50 rows=6"
 200     );
 201
 202     $this->add('select', 'pdf_format_id', ts('PDF Page Format'),
 203       array(
 204         'null' => ts('- default -'),
 205       ) + CRM_Core_BAO_PdfFormat::getList(TRUE), FALSE
 206     );
 207
 208     $this->add('checkbox', 'is_active', ts('Enabled?'));
 209     $this->addFormRule(array(__CLASS__, 'formRule'), $this);
 210
 211     if ($this->_action & CRM_Core_Action::VIEW) {
 212       $this->freeze();
 213       CRM_Utils_System::setTitle(ts('View System Default Message Template'));
 214     }
 215   }
 216
 217   /**
 218    * Global form rule.
 219    *
 220    * @param array $params
 221    *   The input form values.
 222    * @param array $files
 223    *   The uploaded files if any.
 224    * @param array $self
 225    *
 226    * @return array
 227    *   array of errors
 228    */
 229   public static function formRule($params, $files, $self) {
 230     // If user uploads non-document file other than odt/docx
 231     if (!empty($files['file_id']['tmp_name']) &&
 232       array_search($files['file_id']['type'], CRM_Core_SelectValues::documentApplicationType()) == NULL
 233     ) {
 234       $errors['file_id'] = ts('Invalid document file format');
 235     }
 236     // If default is not set and no document file is uploaded
 237     elseif (empty($files['file_id']['tmp_name']) && !empty($params['file_type']) && !$self->_is_document) {
 238       //On edit page of docx/odt message template if user changes file type but forgot to upload document
 239       $errors['file_id'] = ts('Please upload document');
 240     }
 241
 242     return empty($errors) ? TRUE : $errors;
 243   }
 244
 245   /**
 246    * Process the form submission.
 247    */
 248   public function postProcess() {
 249     if ($this->_action & CRM_Core_Action::DELETE) {
 250       CRM_Core_BAO_MessageTemplate::del($this->_id);
 251     }
 252     elseif ($this->_action & CRM_Core_Action::VIEW) {
 253       // currently, the above action is used solely for previewing default workflow templates
 254       CRM_Utils_System::redirect(CRM_Utils_System::url('civicrm/admin/messageTemplates', 'selectedChild=workflow&reset=1'));
 255     }
 256     else {
 257       // store the submitted values in an array
 258       $params = $this->controller->exportValues();
 259
 260       if ($this->_action & CRM_Core_Action::UPDATE) {
 261         $params['id'] = $this->_id;
 262       }
 263
 264       if (!empty($params['file_type'])) {
 265         unset($params['msg_html']);
 266         unset($params['msg_text']);
 267         CRM_Utils_File::formatFile($params, 'file_id');
 268       }
 269       // delete related file references if html/text/pdf template are chosen over document
 270       elseif (!empty($this->_id)) {
 271         $entityFileDAO = new CRM_Core_DAO_EntityFile();
 272         $entityFileDAO->entity_id = $this->_id;
 273         $entityFileDAO->entity_table = 'civicrm_msg_template';
 274         if ($entityFileDAO->find(TRUE)) {
 275           $fileDAO = new CRM_Core_DAO_File();
 276           $fileDAO->id = $entityFileDAO->file_id;
 277           $fileDAO->find(TRUE);
 278           $entityFileDAO->delete();
 279           $fileDAO->delete();
 280         }
 281       }
 282
 283       $this->_workflow_id = CRM_Utils_Array::value('workflow_id', $this->_values);
 284       if ($this->_workflow_id) {
 285         $params['workflow_id'] = $this->_workflow_id;
 286         $params['is_active'] = TRUE;
 287       }
 288
 289       $messageTemplate = CRM_Core_BAO_MessageTemplate::add($params);
 290       CRM_Core_Session::setStatus(ts('The Message Template \'%1\' has been saved.', array(1 => $messageTemplate->msg_title)), ts('Saved'), 'success');
 291
 292       if (isset($this->_submitValues['_qf_MessageTemplates_upload'])) {
 293         // Save button was pressed
 294         CRM_Utils_System::redirect(CRM_Utils_System::url('civicrm/admin/messageTemplates/add', "action=update&id={$messageTemplate->id}&reset=1"));
 295       }
 296       // Save and done button was pressed
 297       if ($this->_workflow_id) {
 298         CRM_Utils_System::redirect(CRM_Utils_System::url('civicrm/admin/messageTemplates', 'selectedChild=workflow&reset=1'));
 299       }
 300       CRM_Utils_System::redirect(CRM_Utils_System::url('civicrm/admin/messageTemplates', 'selectedChild=user&reset=1'));
 301     }
 302   }
 303
 304 }