CRM/Pledge/BAO/PledgeBlock.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.7                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2015                                |
   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-2015
  32  */
  33 class CRM_Pledge_BAO_PledgeBlock extends CRM_Pledge_DAO_PledgeBlock {
  34
  35   /**
  36    * Class constructor.
  37    */
  38   public function __construct() {
  39     parent::__construct();
  40   }
  41
  42   /**
  43    * Retrieve DB object based on input parameters.
  44    *
  45    * It also stores all the retrieved values in the default array.
  46    *
  47    * @param array $params
  48    *   (reference ) an assoc array of name/value pairs.
  49    * @param array $defaults
  50    *   (reference ) an assoc array to hold the flattened values.
  51    *
  52    * @return CRM_Pledge_BAO_PledgeBlock
  53    */
  54   public static function retrieve(&$params, &$defaults) {
  55     $pledgeBlock = new CRM_Pledge_DAO_PledgeBlock();
  56     $pledgeBlock->copyValues($params);
  57     if ($pledgeBlock->find(TRUE)) {
  58       CRM_Core_DAO::storeValues($pledgeBlock, $defaults);
  59       return $pledgeBlock;
  60     }
  61     return NULL;
  62   }
  63
  64   /**
  65    * Takes an associative array and creates a pledgeBlock object.
  66    *
  67    * @param array $params
  68    *   (reference ) an assoc array of name/value pairs.
  69    *
  70    * @return CRM_Pledge_BAO_PledgeBlock
  71    */
  72   public static function &create(&$params) {
  73     $transaction = new CRM_Core_Transaction();
  74     $pledgeBlock = self::add($params);
  75
  76     if (is_a($pledgeBlock, 'CRM_Core_Error')) {
  77       $pledgeBlock->rollback();
  78       return $pledgeBlock;
  79     }
  80
  81     $params['id'] = $pledgeBlock->id;
  82
  83     $transaction->commit();
  84
  85     return $pledgeBlock;
  86   }
  87
  88   /**
  89    * Add pledgeBlock.
  90    *
  91    * @param array $params
  92    *   Reference array contains the values submitted by the form.
  93    *
  94    *
  95    * @return object
  96    */
  97   public static function add(&$params) {
  98
  99     if (!empty($params['id'])) {
 100       CRM_Utils_Hook::pre('edit', 'PledgeBlock', $params['id'], $params);
 101     }
 102     else {
 103       CRM_Utils_Hook::pre('create', 'PledgeBlock', NULL, $params);
 104     }
 105
 106     $pledgeBlock = new CRM_Pledge_DAO_PledgeBlock();
 107
 108     // fix for pledge_frequency_unit
 109     $freqUnits = CRM_Utils_Array::value('pledge_frequency_unit', $params);
 110
 111     if ($freqUnits && is_array($freqUnits)) {
 112       unset($params['pledge_frequency_unit']);
 113       $newFreqUnits = array();
 114       foreach ($freqUnits as $k => $v) {
 115         if ($v) {
 116           $newFreqUnits[$k] = $v;
 117         }
 118       }
 119
 120       $freqUnits = $newFreqUnits;
 121       if (is_array($freqUnits) && !empty($freqUnits)) {
 122         $freqUnits = implode(CRM_Core_DAO::VALUE_SEPARATOR, array_keys($freqUnits));
 123         $pledgeBlock->pledge_frequency_unit = $freqUnits;
 124       }
 125       else {
 126         $pledgeBlock->pledge_frequency_unit = '';
 127       }
 128     }
 129
 130     $pledgeBlock->copyValues($params);
 131     $result = $pledgeBlock->save();
 132
 133     if (!empty($params['id'])) {
 134       CRM_Utils_Hook::post('edit', 'PledgeBlock', $pledgeBlock->id, $pledgeBlock);
 135     }
 136     else {
 137       CRM_Utils_Hook::post('create', 'Pledge', $pledgeBlock->id, $pledgeBlock);
 138     }
 139
 140     return $result;
 141   }
 142
 143   /**
 144    * Delete the pledgeBlock.
 145    *
 146    * @param int $id
 147    *   PledgeBlock id.
 148    *
 149    * @return mixed|null
 150    */
 151   public static function deletePledgeBlock($id) {
 152     CRM_Utils_Hook::pre('delete', 'PledgeBlock', $id, CRM_Core_DAO::$_nullArray);
 153
 154     $transaction = new CRM_Core_Transaction();
 155
 156     $results = NULL;
 157
 158     $dao = new CRM_Pledge_DAO_PledgeBlock();
 159     $dao->id = $id;
 160     $results = $dao->delete();
 161
 162     $transaction->commit();
 163
 164     CRM_Utils_Hook::post('delete', 'PledgeBlock', $dao->id, $dao);
 165
 166     return $results;
 167   }
 168
 169   /**
 170    * Return Pledge  Block info in Contribution Pages.
 171    *
 172    * @param int $pageID
 173    *   Contribution page id.
 174    *
 175    * @return array
 176    */
 177   public static function getPledgeBlock($pageID) {
 178     $pledgeBlock = array();
 179
 180     $dao = new CRM_Pledge_DAO_PledgeBlock();
 181     $dao->entity_table = 'civicrm_contribution_page';
 182     $dao->entity_id = $pageID;
 183     if ($dao->find(TRUE)) {
 184       CRM_Core_DAO::storeValues($dao, $pledgeBlock);
 185     }
 186
 187     return $pledgeBlock;
 188   }
 189
 190   /**
 191    * Build Pledge Block in Contribution Pages.
 192    *
 193    * @param CRM_Core_Form $form
 194    */
 195   public static function buildPledgeBlock($form) {
 196     //build pledge payment fields.
 197     if (!empty($form->_values['pledge_id'])) {
 198       //get all payments required details.
 199       $allPayments = array();
 200       $returnProperties = array(
 201         'status_id',
 202         'scheduled_date',
 203         'scheduled_amount',
 204         'currency',
 205       );
 206       CRM_Core_DAO::commonRetrieveAll('CRM_Pledge_DAO_PledgePayment', 'pledge_id',
 207         $form->_values['pledge_id'], $allPayments, $returnProperties
 208       );
 209       // get all status
 210       $allStatus = CRM_Contribute_PseudoConstant::contributionStatus(NULL, 'name');
 211
 212       $nextPayment = array();
 213       $isNextPayment = FALSE;
 214       $overduePayments = array();
 215       $now = date('Ymd');
 216       foreach ($allPayments as $payID => $value) {
 217         if ($allStatus[$value['status_id']] == 'Overdue') {
 218           $overduePayments[$payID] = array(
 219             'id' => $payID,
 220             'scheduled_amount' => CRM_Utils_Rule::cleanMoney($value['scheduled_amount']),
 221             'scheduled_amount_currency' => $value['currency'],
 222             'scheduled_date' => CRM_Utils_Date::customFormat($value['scheduled_date'],
 223               '%B %d'
 224             ),
 225           );
 226         }
 227         elseif (!$isNextPayment &&
 228           $allStatus[$value['status_id']] == 'Pending'
 229         ) {
 230           // get the next payment.
 231           $nextPayment = array(
 232             'id' => $payID,
 233             'scheduled_amount' => CRM_Utils_Rule::cleanMoney($value['scheduled_amount']),
 234             'scheduled_amount_currency' => $value['currency'],
 235             'scheduled_date' => CRM_Utils_Date::customFormat($value['scheduled_date'],
 236               '%B %d'
 237             ),
 238           );
 239           $isNextPayment = TRUE;
 240         }
 241       }
 242
 243       // build check box array for payments.
 244       $payments = array();
 245       if (!empty($overduePayments)) {
 246         foreach ($overduePayments as $id => $payment) {
 247           $key = ts("%1 - due on %2 (overdue)", array(
 248             1 => CRM_Utils_Money::format(CRM_Utils_Array::value('scheduled_amount', $payment), CRM_Utils_Array::value('scheduled_amount_currency', $payment)),
 249             2 => CRM_Utils_Array::value('scheduled_date', $payment),
 250           ));
 251           $payments[$key] = CRM_Utils_Array::value('id', $payment);
 252         }
 253       }
 254
 255       if (!empty($nextPayment)) {
 256         $key = ts("%1 - due on %2", array(
 257           1 => CRM_Utils_Money::format(CRM_Utils_Array::value('scheduled_amount', $nextPayment), CRM_Utils_Array::value('scheduled_amount_currency', $nextPayment)),
 258           2 => CRM_Utils_Array::value('scheduled_date', $nextPayment),
 259         ));
 260         $payments[$key] = CRM_Utils_Array::value('id', $nextPayment);
 261       }
 262       // give error if empty or build form for payment.
 263       if (empty($payments)) {
 264         CRM_Core_Error::fatal(ts("Oops. It looks like there is no valid payment status for online payment."));
 265       }
 266       else {
 267         $form->assign('is_pledge_payment', TRUE);
 268         $form->addCheckBox('pledge_amount', ts('Make Pledge Payment(s):'), $payments);
 269       }
 270     }
 271     else {
 272
 273       $pledgeBlock = self::getPledgeBlock($form->_id);
 274
 275       // build form for pledge creation.
 276       $pledgeOptions = array(
 277         '0' => ts('I want to make a one-time contribution'),
 278         '1' => ts('I pledge to contribute this amount every'),
 279       );
 280       $form->addRadio('is_pledge', ts('Pledge Frequency Interval'), $pledgeOptions,
 281         NULL, array('<br/>')
 282       );
 283       $form->addElement('text', 'pledge_installments', ts('Installments'), array('size' => 3));
 284
 285       if (!empty($pledgeBlock['is_pledge_interval'])) {
 286         $form->assign('is_pledge_interval', CRM_Utils_Array::value('is_pledge_interval', $pledgeBlock));
 287         $form->addElement('text', 'pledge_frequency_interval', NULL, array('size' => 3));
 288       }
 289       else {
 290         $form->add('hidden', 'pledge_frequency_interval', 1);
 291       }
 292       // Frequency unit drop-down label suffixes switch from *ly to *(s)
 293       $freqUnitVals = explode(CRM_Core_DAO::VALUE_SEPARATOR, $pledgeBlock['pledge_frequency_unit']);
 294       $freqUnits = array();
 295       $frequencyUnits = CRM_Core_OptionGroup::values('recur_frequency_units');
 296       foreach ($freqUnitVals as $key => $val) {
 297         if (array_key_exists($val, $frequencyUnits)) {
 298           $freqUnits[$val] = !empty($pledgeBlock['is_pledge_interval']) ? "{$frequencyUnits[$val]}(s)" : $frequencyUnits[$val];
 299         }
 300       }
 301       $form->addElement('select', 'pledge_frequency_unit', NULL, $freqUnits);
 302     }
 303   }
 304
 305 }