CRM/PCP/Form/Contribute.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | Copyright CiviCRM LLC. All rights reserved.                        |
   5  |                                                                    |
   6  | This work is published under the GNU AGPLv3 license with some      |
   7  | permitted exceptions and without any warranty. For full license    |
   8  | and copyright information, see https://civicrm.org/licensing       |
   9  +--------------------------------------------------------------------+
  10  */
  11
  12 /**
  13  *
  14  * @package CRM
  15  * @copyright CiviCRM LLC https://civicrm.org/licensing
  16  * $Id$
  17  *
  18  */
  19
  20 /**
  21  * This class generates form components for Tell A Friend
  22  *
  23  */
  24 class CRM_PCP_Form_Contribute extends CRM_Contribute_Form_ContributionPage {
  25
  26   /**
  27    * The type of pcp component.
  28    *
  29    * @var int
  30    */
  31   public $_component = 'contribute';
  32
  33   public function preProcess() {
  34     parent::preProcess();
  35     $this->setSelectedChild('pcp');
  36   }
  37
  38   /**
  39    * Set default values for the form. Note that in edit/view mode
  40    * the default values are retrieved from the database
  41    *
  42    *
  43    * @return void
  44    */
  45   public function setDefaultValues() {
  46     $defaults = [];
  47
  48     if (isset($this->_id)) {
  49       $params = ['entity_id' => $this->_id, 'entity_table' => 'civicrm_contribution_page'];
  50       CRM_Core_DAO::commonRetrieve('CRM_PCP_DAO_PCPBlock', $params, $defaults);
  51       $defaults['pcp_active'] = $defaults['is_active'] ?? NULL;
  52       // Assign contribution page ID to pageId for referencing in PCP.hlp - since $id is overwritten there. dgg
  53       $this->assign('pageId', $this->_id);
  54     }
  55
  56     if (empty($defaults['id'])) {
  57       $defaults['target_entity_type'] = 'contribute';
  58       $defaults['is_approval_needed'] = 1;
  59       $defaults['is_tellfriend_enabled'] = 1;
  60       $defaults['tellfriend_limit'] = 5;
  61       $defaults['link_text'] = ts('Create your own fundraising page');
  62       $defaults['owner_notify_id'] = CRM_Core_OptionGroup::getDefaultValue('pcp_owner_notify');
  63
  64       if ($ccReceipt = CRM_Core_DAO::getFieldValue('CRM_Contribute_DAO_ContributionPage', $this->_id, 'cc_receipt')) {
  65         $defaults['notify_email'] = $ccReceipt;
  66       }
  67     }
  68     return $defaults;
  69   }
  70
  71   /**
  72    * Build the form object.
  73    *
  74    * @return void
  75    */
  76   public function buildQuickForm() {
  77     $this->_last = TRUE;
  78     CRM_PCP_BAO_PCP::buildPCPForm($this);
  79
  80     $this->addElement('checkbox', 'pcp_active', ts('Enable Personal Campaign Pages? (for this contribution page)'), NULL, ['onclick' => "return showHideByValue('pcp_active',true,'pcpFields','table-row','radio',false);"]);
  81
  82     parent::buildQuickForm();
  83     $this->addFormRule(['CRM_PCP_Form_Contribute', 'formRule'], $this);
  84   }
  85
  86   /**
  87    * Validation.
  88    *
  89    * @param array $params
  90    *   (ref.) an assoc array of name/value pairs.
  91    *
  92    * @param $files
  93    * @param $self
  94    *
  95    * @return bool|array
  96    *   mixed true or array of errors
  97    */
  98   public static function formRule($params, $files, $self) {
  99     $errors = [];
 100     if (!empty($params['is_active'])) {
 101
 102       if (!empty($params['is_tellfriend_enabled']) &&
 103         (CRM_Utils_Array::value('tellfriend_limit', $params) <= 0)
 104       ) {
 105         $errors['tellfriend_limit'] = ts('if Tell Friend is enabled, Maximum recipients limit should be greater than zero.');
 106       }
 107       if (empty($params['supporter_profile_id'])) {
 108         $errors['supporter_profile_id'] = ts('Supporter profile is a required field.');
 109       }
 110       else {
 111         if (CRM_PCP_BAO_PCP::checkEmailProfile($params['supporter_profile_id'])) {
 112           $errors['supporter_profile_id'] = ts('Profile is not configured with Email address.');
 113         }
 114       }
 115
 116       if ($emails = CRM_Utils_Array::value('notify_email', $params)) {
 117         $emailArray = explode(',', $emails);
 118         foreach ($emailArray as $email) {
 119           if ($email && !CRM_Utils_Rule::email(trim($email))) {
 120             $errors['notify_email'] = ts('A valid Notify Email address must be specified');
 121           }
 122         }
 123       }
 124     }
 125     return empty($errors) ? TRUE : $errors;
 126   }
 127
 128   /**
 129    * Process the form submission.
 130    *
 131    *
 132    * @return void
 133    */
 134   public function postProcess() {
 135     // get the submitted form values.
 136     $params = $this->controller->exportValues($this->_name);
 137
 138     // Source
 139     $params['entity_table'] = 'civicrm_contribution_page';
 140     $params['entity_id'] = $this->_id;
 141
 142     // Target
 143     $params['target_entity_type'] = CRM_Utils_Array::value('target_entity_type', $params, 'contribute');
 144     $params['target_entity_id'] = $this->_id;
 145
 146     $dao = new CRM_PCP_DAO_PCPBlock();
 147     $dao->entity_table = $params['entity_table'];
 148     $dao->entity_id = $this->_id;
 149     $dao->find(TRUE);
 150     $params['id'] = $dao->id;
 151     $params['is_active'] = CRM_Utils_Array::value('pcp_active', $params, FALSE);
 152     $params['is_approval_needed'] = CRM_Utils_Array::value('is_approval_needed', $params, FALSE);
 153     $params['is_tellfriend_enabled'] = CRM_Utils_Array::value('is_tellfriend_enabled', $params, FALSE);
 154
 155     CRM_PCP_BAO_PCPBlock::create($params);
 156
 157     parent::endPostProcess();
 158   }
 159
 160   /**
 161    * Return a descriptive name for the page, used in wizard header
 162    *
 163    * @return string
 164    */
 165   public function getTitle() {
 166     return ts('Enable Personal Campaign Pages');
 167   }
 168
 169 }