CRM/Contribute/Form/SoftCredit.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.3                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2013                                |
   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-2013
  32  * $Id$
  33  *
  34  */
  35
  36 /**
  37  * This class build form elements for select exitsing or create new soft block
  38  */
  39 class CRM_Contribute_Form_SoftCredit {
  40
  41   /**
  42    * Function used to build form element for soft credit block
  43    *
  44    * @param object   $form form object
  45    * @access public
  46    *
  47    * @return void
  48    */
  49   static function buildQuickForm(&$form) {
  50     $prefix = 'soft_credit_';
  51     // by default generate 5 blocks
  52     $item_count = 6;
  53
  54     $showSoftCreditRow = 2;
  55     $showCreateNew = TRUE;
  56     if ($form->_action & CRM_Core_Action::UPDATE) {
  57       $form->_softCreditInfo = CRM_Contribute_BAO_ContributionSoft::getSoftContribution($form->_id, TRUE);
  58       if (!empty($form->_softCreditInfo['soft_credit'])) {
  59         $showSoftCreditRow = count($form->_softCreditInfo['soft_credit']);
  60         $showSoftCreditRow++;
  61         $showCreateNew = FALSE;
  62       }
  63     }
  64
  65     for ($rowNumber = 1; $rowNumber <= $item_count; $rowNumber++) {
  66       CRM_Contact_Form_NewContact::buildQuickForm($form, $rowNumber, NULL, FALSE, $prefix);
  67
  68       $form->addMoney("{$prefix}amount[{$rowNumber}]", ts('Amount'));
  69       if (!empty($form->_softCreditInfo['soft_credit'][$rowNumber]['soft_credit_id'])) {
  70         $form->add('hidden', "{$prefix}id[{$rowNumber}]",
  71           $form->_softCreditInfo['soft_credit'][$rowNumber]['soft_credit_id']);
  72       }
  73     }
  74
  75     $form->assign('showSoftCreditRow', $showSoftCreditRow);
  76     $form->assign('rowCount', $item_count);
  77     $form->assign('showCreateNew', $showCreateNew);
  78
  79     // Tell tpl to hide soft credit field if contribution is linked directly to a PCP Page
  80     if (CRM_Utils_Array::value('pcp_made_through_id', $form->_values)) {
  81       $form->assign('pcpLinked', 1);
  82     }
  83   }
  84
  85   /**
  86    * Function used to set defaults for soft credit block
  87    */
  88   static function setDefaultValues(&$defaults, &$form) {
  89     if (!empty($form->_softCreditInfo['soft_credit'])) {
  90       foreach ($form->_softCreditInfo['soft_credit'] as $key => $value) {
  91         $defaults["soft_credit_amount[$key]"] = $value['amount'];
  92         $defaults["soft_credit_contact_select_id[$key]"] = $value['contact_id'];
  93       }
  94     }
  95
  96     if (CRM_Utils_Array::value('pcp_id', $form->_softCreditInfo)) {
  97       $pcpInfo = $form->_softCreditInfo;
  98       $pcpId = CRM_Utils_Array::value('pcp_id', $pcpInfo);
  99       $pcpTitle = CRM_Core_DAO::getFieldValue('CRM_PCP_DAO_PCP', $pcpId, 'title');
 100       $contributionPageTitle = CRM_PCP_BAO_PCP::getPcpPageTitle($pcpId, 'contribute');
 101       $defaults['pcp_made_through'] = CRM_Utils_Array::value('sort_name', $pcpInfo) . " :: " . $pcpTitle . " :: " . $contributionPageTitle;
 102       $defaults['pcp_made_through_id'] = CRM_Utils_Array::value('pcp_id', $pcpInfo);
 103       $defaults['pcp_display_in_roll'] = CRM_Utils_Array::value('pcp_display_in_roll', $pcpInfo);
 104       $defaults['pcp_roll_nickname'] = CRM_Utils_Array::value('pcp_roll_nickname', $pcpInfo);
 105       $defaults['pcp_personal_note'] = CRM_Utils_Array::value('pcp_personal_note', $pcpInfo);
 106     }
 107   }
 108 }
 109