CRM/Price/Form/Option.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.7                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2017                                |
   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-2017
  32  * $Id$
  33  *
  34  */
  35
  36 /**
  37  * form to process actions on the field aspect of Custom
  38  */
  39 class CRM_Price_Form_Option extends CRM_Core_Form {
  40
  41   /**
  42    * The price field id saved to the session for an update.
  43    *
  44    * @var int
  45    */
  46   protected $_fid;
  47
  48   /**
  49    * Option value  id, used when editing the Option
  50    *
  51    * @var int
  52    */
  53   protected $_oid;
  54
  55   /**
  56    * Set variables up before form is built.
  57    *
  58    * @return void
  59    */
  60   public function preProcess() {
  61     $this->setPageTitle(ts('Price Option'));
  62     $this->_fid = CRM_Utils_Request::retrieve('fid', 'Positive',
  63       $this
  64     );
  65     $this->_oid = CRM_Utils_Request::retrieve('oid', 'Positive',
  66       $this
  67     );
  68   }
  69
  70   /**
  71    * Set default values for the form. Note that in edit/view mode
  72    * the default values are retrieved from the database
  73    *
  74    * @return array|void  array of default values
  75    */
  76   public function setDefaultValues() {
  77     if ($this->_action == CRM_Core_Action::DELETE) {
  78       return NULL;
  79     }
  80     $defaults = array();
  81
  82     if (isset($this->_oid)) {
  83       $params = array('id' => $this->_oid);
  84
  85       CRM_Price_BAO_PriceFieldValue::retrieve($params, $defaults);
  86
  87       // fix the display of the monetary value, CRM-4038
  88       $defaults['value'] = CRM_Utils_Money::format(CRM_Utils_Array::value('value', $defaults), NULL, '%a');
  89     }
  90
  91     $memberComponentId = CRM_Core_Component::getComponentID('CiviMember');
  92     $extendComponentId = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceSet', $this->_sid, 'extends', 'id');
  93
  94     if (!isset($defaults['membership_num_terms']) && $memberComponentId == $extendComponentId) {
  95       $defaults['membership_num_terms'] = 1;
  96     }
  97     // set financial type used for price set to set default for new option
  98     if (!$this->_oid) {
  99       $defaults['financial_type_id'] = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceSet', $this->_sid, 'financial_type_id', 'id');;
 100     }
 101     if (!isset($defaults['weight']) || !$defaults['weight']) {
 102       $fieldValues = array('price_field_id' => $this->_fid);
 103       $defaults['weight'] = CRM_Utils_Weight::getDefaultWeight('CRM_Price_DAO_PriceFieldValue', $fieldValues);
 104       $defaults['is_active'] = 1;
 105     }
 106
 107     return $defaults;
 108   }
 109
 110   /**
 111    * Build the form object.
 112    *
 113    * @return void
 114    */
 115   public function buildQuickForm() {
 116     if ($this->_action == CRM_Core_Action::UPDATE) {
 117       $finTypeId = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceFieldValue', $this->_oid, 'financial_type_id');
 118       if (!CRM_Financial_BAO_FinancialType::checkPermissionToEditFinancialType($finTypeId)) {
 119         CRM_Core_Error::fatal(ts("You do not have permission to access this page"));
 120       }
 121     }
 122     if ($this->_action == CRM_Core_Action::DELETE) {
 123       $this->addButtons(array(
 124         array(
 125           'type' => 'next',
 126           'name' => ts('Delete'),
 127         ),
 128         array(
 129           'type' => 'cancel',
 130           'name' => ts('Cancel'),
 131         ),
 132       ));
 133       return NULL;
 134     }
 135     else {
 136       $attributes = CRM_Core_DAO::getAttribute('CRM_Price_DAO_PriceFieldValue');
 137       // lets trim all the whitespace
 138       $this->applyFilter('__ALL__', 'trim');
 139
 140       // hidden Option Id for validation use
 141       $this->add('hidden', 'optionId', $this->_oid);
 142
 143       // Needed for i18n dialog
 144       $this->assign('optionId', $this->_oid);
 145
 146       //hidden field ID for validation use
 147       $this->add('hidden', 'fieldId', $this->_fid);
 148
 149       // label
 150       $this->add('text', 'label', ts('Option Label'), NULL, TRUE);
 151       $memberComponentId = CRM_Core_Component::getComponentID('CiviMember');
 152       if ($this->_action == CRM_Core_Action::UPDATE) {
 153         $this->_sid = CRM_Utils_Request::retrieve('sid', 'Positive', $this);
 154       }
 155       elseif ($this->_action == CRM_Core_Action::ADD ||
 156         $this->_action == CRM_Core_Action::VIEW
 157       ) {
 158         $this->_sid = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceField', $this->_fid, 'price_set_id', 'id');
 159       }
 160       $this->isEvent = FALSE;
 161       $extendComponentId = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceSet', $this->_sid, 'extends', 'id');
 162       $this->assign('showMember', FALSE);
 163       if ($memberComponentId == $extendComponentId) {
 164         $this->assign('showMember', TRUE);
 165         $membershipTypes = CRM_Member_PseudoConstant::membershipType();
 166         $this->add('select', 'membership_type_id', ts('Membership Type'), array(
 167           '' => ' ',
 168         ) + $membershipTypes, FALSE,
 169         array('onClick' => "calculateRowValues( );"));
 170         $this->add('text', 'membership_num_terms', ts('Number of Terms'), $attributes['membership_num_terms']);
 171       }
 172       else {
 173         $allComponents = explode(CRM_Core_DAO::VALUE_SEPARATOR, $extendComponentId);
 174         $eventComponentId = CRM_Core_Component::getComponentID('CiviEvent');
 175         if (in_array($eventComponentId, $allComponents)) {
 176           $this->isEvent = TRUE;
 177           // count
 178           $this->add('text', 'count', ts('Participant Count'));
 179           $this->addRule('count', ts('Please enter a valid Max Participants.'), 'positiveInteger');
 180
 181           $this->add('text', 'max_value', ts('Max Participants'));
 182           $this->addRule('max_value', ts('Please enter a valid Max Participants.'), 'positiveInteger');
 183         }
 184
 185       }
 186       //Financial Type
 187       $financialType = CRM_Financial_BAO_FinancialType::getIncomeFinancialType();
 188
 189       if (count($financialType)) {
 190         $this->assign('financialType', $financialType);
 191       }
 192       $this->add(
 193         'select',
 194         'financial_type_id',
 195         ts('Financial Type'),
 196         array('' => ts('- select -')) + $financialType,
 197         TRUE
 198       );
 199
 200       //CRM_Core_DAO::getFieldValue( 'CRM_Price_DAO_PriceField', $this->_fid, 'weight', 'id' );
 201       // FIX ME: duplicate rule?
 202       /*
 203       $this->addRule( 'label',
 204       ts('Duplicate option label.'),
 205       'optionExists',
 206       array( 'CRM_Core_DAO_OptionValue', $this->_oid, $this->_ogId, 'label' ) );
 207        */
 208
 209       // value
 210       $this->add('text', 'amount', ts('Option Amount'), NULL, TRUE);
 211
 212       // the above value is used directly by QF, so the value has to be have a rule
 213       // please check with Lobo before u comment this
 214       $this->registerRule('amount', 'callback', 'money', 'CRM_Utils_Rule');
 215       $this->addRule('amount', ts('Please enter a monetary value for this field.'), 'money');
 216
 217       $this->add('text', 'non_deductible_amount', ts('Non-deductible Amount'), NULL);
 218       $this->registerRule('non_deductible_amount', 'callback', 'money', 'CRM_Utils_Rule');
 219       $this->addRule('non_deductible_amount', ts('Please enter a monetary value for this field.'), 'money');
 220
 221       $this->add('textarea', 'description', ts('Description'));
 222       $this->add('textarea', 'help_pre', ts('Pre Option Help'));
 223       $this->add('textarea', 'help_post', ts('Post Option Help'));
 224
 225       // weight
 226       $this->add('text', 'weight', ts('Order'), NULL, TRUE);
 227       $this->addRule('weight', ts('is a numeric field'), 'numeric');
 228
 229       // is active ?
 230       $this->add('checkbox', 'is_active', ts('Active?'));
 231
 232       //is default
 233       $this->add('checkbox', 'is_default', ts('Default'));
 234
 235       if ($this->_fid) {
 236         //hide the default checkbox option for text field
 237         $htmlType = CRM_Core_DAO::getFieldValue('CRM_Price_BAO_PriceField', $this->_fid, 'html_type');
 238         $this->assign('hideDefaultOption', FALSE);
 239         if ($htmlType == 'Text') {
 240           $this->assign('hideDefaultOption', TRUE);
 241         }
 242       }
 243       // add buttons
 244       $this->addButtons(array(
 245         array(
 246           'type' => 'next',
 247           'name' => ts('Save'),
 248         ),
 249         array(
 250           'type' => 'cancel',
 251           'name' => ts('Cancel'),
 252         ),
 253       ));
 254
 255       // if view mode pls freeze it with the done button.
 256       if ($this->_action & CRM_Core_Action::VIEW) {
 257         $this->freeze();
 258         $this->addButtons(array(
 259           array(
 260             'type' => 'cancel',
 261             'name' => ts('Done'),
 262             'isDefault' => TRUE,
 263           ),
 264         ));
 265       }
 266     }
 267
 268     $this->addFormRule(array('CRM_Price_Form_Option', 'formRule'), $this);
 269   }
 270
 271   /**
 272    * Global validation rules for the form.
 273    *
 274    * @param array $fields
 275    *   Posted values of the form.
 276    *
 277    * @param $files
 278    * @param CRM_Core_Form $form
 279    *
 280    * @return array
 281    *   if errors then list of errors to be posted back to the form,
 282    *                  true otherwise
 283    */
 284   public static function formRule($fields, $files, $form) {
 285     $errors = array();
 286     if (!empty($fields['count']) && !empty($fields['max_value']) &&
 287       $fields['count'] > $fields['max_value']
 288     ) {
 289       $errors['count'] = ts('Participant count can not be greater than max participants.');
 290     }
 291     // CRM-16189
 292     try {
 293       CRM_Financial_BAO_FinancialAccount::validateFinancialType($fields['financial_type_id'], $form->_fid, 'PriceField');
 294     }
 295     catch (CRM_Core_Exception $e) {
 296       $errors['financial_type_id'] = $e->getMessage();
 297     }
 298     return empty($errors) ? TRUE : $errors;
 299   }
 300
 301   /**
 302    * Process the form.
 303    *
 304    * @return void
 305    */
 306   public function postProcess() {
 307     if ($this->_action == CRM_Core_Action::DELETE) {
 308       $fieldValues = array('price_field_id' => $this->_fid);
 309       $wt = CRM_Utils_Weight::delWeight('CRM_Price_DAO_PriceFieldValue', $this->_oid, $fieldValues);
 310       $label = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceFieldValue',
 311         $this->_oid,
 312         'label', 'id'
 313       );
 314
 315       if (CRM_Price_BAO_PriceFieldValue::del($this->_oid)) {
 316         CRM_Core_Session::setStatus(ts('%1 option has been deleted.', array(1 => $label)), ts('Record Deleted'), 'success');
 317       }
 318       return NULL;
 319     }
 320     else {
 321       $params = $ids = array();
 322       $params = $this->controller->exportValues('Option');
 323       $fieldLabel = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceField', $this->_fid, 'label');
 324
 325       $params['amount'] = CRM_Utils_Rule::cleanMoney(trim($params['amount']));
 326       $params['price_field_id'] = $this->_fid;
 327       $params['is_default'] = CRM_Utils_Array::value('is_default', $params, FALSE);
 328       $params['is_active'] = CRM_Utils_Array::value('is_active', $params, FALSE);
 329       $ids = array();
 330       if ($this->_oid) {
 331         $ids['id'] = $this->_oid;
 332       }
 333       $optionValue = CRM_Price_BAO_PriceFieldValue::create($params, $ids);
 334
 335       CRM_Core_Session::setStatus(ts("The option '%1' has been saved.", array(1 => $params['label'])), ts('Value Saved'), 'success');
 336     }
 337   }
 338
 339 }