CRM/Price/Form/Option.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.7                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2016                                |
   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-2016
  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       CRM_Financial_BAO_FinancialType::getAvailableFinancialTypes($financialTypes, CRM_Core_Action::UPDATE);
 119       if (!array_key_exists($finTypeId, $financialTypes)) {
 120         CRM_Core_Error::fatal(ts("You do not have permission to access this page"));
 121       }
 122     }
 123     if ($this->_action == CRM_Core_Action::DELETE) {
 124       $this->addButtons(array(
 125         array(
 126           'type' => 'next',
 127           'name' => ts('Delete'),
 128         ),
 129         array(
 130           'type' => 'cancel',
 131           'name' => ts('Cancel'),
 132         ),
 133       ));
 134       return NULL;
 135     }
 136     else {
 137       $attributes = CRM_Core_DAO::getAttribute('CRM_Price_DAO_PriceFieldValue');
 138       // lets trim all the whitespace
 139       $this->applyFilter('__ALL__', 'trim');
 140
 141       // hidden Option Id for validation use
 142       $this->add('hidden', 'optionId', $this->_oid);
 143
 144       // Needed for i18n dialog
 145       $this->assign('optionId', $this->_oid);
 146
 147       //hidden field ID for validation use
 148       $this->add('hidden', 'fieldId', $this->_fid);
 149
 150       // label
 151       $this->add('text', 'label', ts('Option Label'), NULL, TRUE);
 152       $memberComponentId = CRM_Core_Component::getComponentID('CiviMember');
 153       if ($this->_action == CRM_Core_Action::UPDATE) {
 154         $this->_sid = CRM_Utils_Request::retrieve('sid', 'Positive', $this);
 155       }
 156       elseif ($this->_action == CRM_Core_Action::ADD ||
 157         $this->_action == CRM_Core_Action::VIEW
 158       ) {
 159         $this->_sid = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceField', $this->_fid, 'price_set_id', 'id');
 160       }
 161       $this->isEvent = FALSE;
 162       $extendComponentId = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceSet', $this->_sid, 'extends', 'id');
 163       $this->assign('showMember', FALSE);
 164       if ($memberComponentId == $extendComponentId) {
 165         $this->assign('showMember', TRUE);
 166         $membershipTypes = CRM_Member_PseudoConstant::membershipType();
 167         $this->add('select', 'membership_type_id', ts('Membership Type'), array(
 168           '' => ' ',
 169         ) + $membershipTypes, FALSE,
 170         array('onClick' => "calculateRowValues( );"));
 171         $this->add('text', 'membership_num_terms', ts('Number of Terms'), $attributes['membership_num_terms']);
 172       }
 173       else {
 174         $allComponents = explode(CRM_Core_DAO::VALUE_SEPARATOR, $extendComponentId);
 175         $eventComponentId = CRM_Core_Component::getComponentID('CiviEvent');
 176         if (in_array($eventComponentId, $allComponents)) {
 177           $this->isEvent = TRUE;
 178           // count
 179           $this->add('text', 'count', ts('Participant Count'));
 180           $this->addRule('count', ts('Please enter a valid Max Participants.'), 'positiveInteger');
 181
 182           $this->add('text', 'max_value', ts('Max Participants'));
 183           $this->addRule('max_value', ts('Please enter a valid Max Participants.'), 'positiveInteger');
 184         }
 185
 186       }
 187       //Financial Type
 188       $financialType = CRM_Financial_BAO_FinancialType::getIncomeFinancialType();
 189
 190       if (count($financialType)) {
 191         $this->assign('financialType', $financialType);
 192       }
 193       $this->add(
 194         'select',
 195         'financial_type_id',
 196         ts('Financial Type'),
 197         array('' => ts('- select -')) + $financialType,
 198         TRUE
 199       );
 200
 201       //CRM_Core_DAO::getFieldValue( 'CRM_Price_DAO_PriceField', $this->_fid, 'weight', 'id' );
 202       // FIX ME: duplicate rule?
 203       /*
 204       $this->addRule( 'label',
 205       ts('Duplicate option label.'),
 206       'optionExists',
 207       array( 'CRM_Core_DAO_OptionValue', $this->_oid, $this->_ogId, 'label' ) );
 208        */
 209
 210       // value
 211       $this->add('text', 'amount', ts('Option Amount'), NULL, TRUE);
 212
 213       // the above value is used directly by QF, so the value has to be have a rule
 214       // please check with Lobo before u comment this
 215       $this->registerRule('amount', 'callback', 'money', 'CRM_Utils_Rule');
 216       $this->addRule('amount', ts('Please enter a monetary value for this field.'), 'money');
 217
 218       $this->add('textarea', 'description', ts('Description'));
 219       $this->add('textarea', 'help_pre', ts('Pre Option Help'));
 220       $this->add('textarea', 'help_post', ts('Post Option Help'));
 221
 222       // weight
 223       $this->add('text', 'weight', ts('Order'), NULL, TRUE);
 224       $this->addRule('weight', ts('is a numeric field'), 'numeric');
 225
 226       // is active ?
 227       $this->add('checkbox', 'is_active', ts('Active?'));
 228
 229       //is default
 230       $this->add('checkbox', 'is_default', ts('Default'));
 231
 232       if ($this->_fid) {
 233         //hide the default checkbox option for text field
 234         $htmlType = CRM_Core_DAO::getFieldValue('CRM_Price_BAO_PriceField', $this->_fid, 'html_type');
 235         $this->assign('hideDefaultOption', FALSE);
 236         if ($htmlType == 'Text') {
 237           $this->assign('hideDefaultOption', TRUE);
 238         }
 239       }
 240       // add buttons
 241       $this->addButtons(array(
 242         array(
 243           'type' => 'next',
 244           'name' => ts('Save'),
 245         ),
 246         array(
 247           'type' => 'cancel',
 248           'name' => ts('Cancel'),
 249         ),
 250       ));
 251
 252       // if view mode pls freeze it with the done button.
 253       if ($this->_action & CRM_Core_Action::VIEW) {
 254         $this->freeze();
 255         $this->addButtons(array(
 256           array(
 257             'type' => 'cancel',
 258             'name' => ts('Done'),
 259             'isDefault' => TRUE,
 260           ),
 261         ));
 262       }
 263     }
 264
 265     $this->addFormRule(array('CRM_Price_Form_Option', 'formRule'), $this);
 266   }
 267
 268   /**
 269    * Global validation rules for the form.
 270    *
 271    * @param array $fields
 272    *   Posted values of the form.
 273    *
 274    * @param $files
 275    * @param CRM_Core_Form $form
 276    *
 277    * @return array
 278    *   if errors then list of errors to be posted back to the form,
 279    *                  true otherwise
 280    */
 281   public static function formRule($fields, $files, $form) {
 282     $errors = array();
 283     if (!empty($fields['count']) && !empty($fields['max_value']) &&
 284       $fields['count'] > $fields['max_value']
 285     ) {
 286       $errors['count'] = ts('Participant count can not be greater than max participants.');
 287     }
 288     // CRM-16189
 289     try {
 290       CRM_Financial_BAO_FinancialAccount::validateFinancialType($fields['financial_type_id'], $form->_fid, 'PriceField');
 291     }
 292     catch (CRM_Core_Exception $e) {
 293       $errors['financial_type_id'] = $e->getMessage();
 294     }
 295     return empty($errors) ? TRUE : $errors;
 296   }
 297
 298   /**
 299    * Process the form.
 300    *
 301    * @return void
 302    */
 303   public function postProcess() {
 304     if ($this->_action == CRM_Core_Action::DELETE) {
 305       $fieldValues = array('price_field_id' => $this->_fid);
 306       $wt = CRM_Utils_Weight::delWeight('CRM_Price_DAO_PriceFieldValue', $this->_oid, $fieldValues);
 307       $label = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceFieldValue',
 308         $this->_oid,
 309         'label', 'id'
 310       );
 311
 312       if (CRM_Price_BAO_PriceFieldValue::del($this->_oid)) {
 313         CRM_Core_Session::setStatus(ts('%1 option has been deleted.', array(1 => $label)), ts('Record Deleted'), 'success');
 314       }
 315       return NULL;
 316     }
 317     else {
 318       $params = $ids = array();
 319       $params = $this->controller->exportValues('Option');
 320       $fieldLabel = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceField', $this->_fid, 'label');
 321
 322       $params['amount'] = CRM_Utils_Rule::cleanMoney(trim($params['amount']));
 323       $params['price_field_id'] = $this->_fid;
 324       $params['is_default'] = CRM_Utils_Array::value('is_default', $params, FALSE);
 325       $params['is_active'] = CRM_Utils_Array::value('is_active', $params, FALSE);
 326       $ids = array();
 327       if ($this->_oid) {
 328         $ids['id'] = $this->_oid;
 329       }
 330       $optionValue = CRM_Price_BAO_PriceFieldValue::create($params, $ids);
 331
 332       CRM_Core_Session::setStatus(ts("The option '%1' has been saved.", array(1 => $params['label'])), ts('Value Saved'), 'success');
 333     }
 334   }
 335
 336 }