CRM/Core/Payment/ProcessorForm.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 5                                                  |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2019                                |
   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 use Civi\Payment\System;
  29
  30 /**
  31  *
  32  * @package CRM
  33  * @copyright CiviCRM LLC (c) 2004-2019
  34  */
  35
  36
  37 /**
  38  * Base class for building payment block for online contribution / event pages.
  39  */
  40 class CRM_Core_Payment_ProcessorForm {
  41
  42   /**
  43    * @param CRM_Contribute_Form_Contribution_Main|CRM_Event_Form_Registration_Register|CRM_Financial_Form_Payment $form
  44    * @param null $type
  45    * @param null $mode
  46    *
  47    * @throws Exception
  48    */
  49   public static function preProcess(&$form, $type = NULL, $mode = NULL) {
  50     if ($type) {
  51       $form->_type = $type;
  52     }
  53     else {
  54       $form->_type = CRM_Utils_Request::retrieve('type', 'String', $form);
  55     }
  56
  57     if ($form->_type) {
  58       // @todo not sure when this would be true. Never passed in.
  59       $form->_paymentProcessor = CRM_Financial_BAO_PaymentProcessor::getPayment($form->_type, $form->_mode);
  60     }
  61
  62     if (empty($form->_paymentProcessor)) {
  63       // This would happen when hitting the back-button on a multi-page form with a $0 selection in play.
  64       return;
  65     }
  66     $form->set('paymentProcessor', $form->_paymentProcessor);
  67     $form->_paymentObject = System::singleton()->getByProcessor($form->_paymentProcessor);
  68     if ($form->paymentInstrumentID) {
  69       $form->_paymentObject->setPaymentInstrumentID($form->paymentInstrumentID);
  70     }
  71     $form->_paymentObject->setBackOffice($form->isBackOffice);
  72     $form->assign('isBackOffice', $form->isBackOffice);
  73
  74     $form->assign('suppressSubmitButton', $form->_paymentObject->isSuppressSubmitButtons());
  75
  76     $form->assign('currency', $form->getCurrency());
  77
  78     // also set cancel subscription url
  79     if (!empty($form->_paymentProcessor['is_recur']) && !empty($form->_values['is_recur'])) {
  80       $form->_values['cancelSubscriptionUrl'] = $form->_paymentObject->subscriptionURL(NULL, NULL, 'cancel');
  81     }
  82
  83     if (!empty($form->_values['custom_pre_id'])) {
  84       $profileAddressFields = [];
  85       $fields = CRM_Core_BAO_UFGroup::getFields($form->_values['custom_pre_id'], FALSE, CRM_Core_Action::ADD, NULL, NULL, FALSE,
  86         NULL, FALSE, NULL, CRM_Core_Permission::CREATE, NULL);
  87
  88       foreach ((array) $fields as $key => $value) {
  89         CRM_Core_BAO_UFField::assignAddressField($key, $profileAddressFields, ['uf_group_id' => $form->_values['custom_pre_id']]);
  90       }
  91       if (count($profileAddressFields)) {
  92         $form->set('profileAddressFields', $profileAddressFields);
  93       }
  94     }
  95
  96     //checks after setting $form->_paymentProcessor
  97     // we do this outside of the above conditional to avoid
  98     // saving the country/state list in the session (which could be huge)
  99     CRM_Core_Payment_Form::setPaymentFieldsByProcessor(
 100       $form,
 101       $form->_paymentProcessor,
 102       CRM_Utils_Request::retrieve('billing_profile_id', 'String'),
 103       $form->isBackOffice,
 104       $form->paymentInstrumentID
 105     );
 106
 107     $form->assign_by_ref('paymentProcessor', $form->_paymentProcessor);
 108
 109     // check if this is a paypal auto return and redirect accordingly
 110     //@todo - determine if this is legacy and remove
 111     if (CRM_Core_Payment::paypalRedirect($form->_paymentProcessor)) {
 112       $url = CRM_Utils_System::url('civicrm/contribute/transact',
 113         "_qf_ThankYou_display=1&qfKey={$form->controller->_key}"
 114       );
 115       CRM_Utils_System::redirect($url);
 116     }
 117
 118     // make sure we have a valid payment class, else abort
 119     if (!empty($form->_values['is_monetary']) &&
 120       !$form->_paymentProcessor['class_name'] && empty($form->_values['is_pay_later'])
 121     ) {
 122       CRM_Core_Error::fatal(ts('Payment processor is not set for this page'));
 123     }
 124
 125     if (!empty($form->_membershipBlock) && !empty($form->_membershipBlock['is_separate_payment']) &&
 126       (!empty($form->_paymentProcessor['class_name']) &&
 127         !$form->_paymentObject->supports('MultipleConcurrentPayments')
 128       )
 129     ) {
 130
 131       CRM_Core_Error::fatal(ts('This contribution page is configured to support separate contribution and membership payments. This %1 plugin does not currently support multiple simultaneous payments, or the option to "Execute real-time monetary transactions" is disabled. Please contact the site administrator and notify them of this error',
 132           [1 => $form->_paymentProcessor['payment_processor_type']]
 133         )
 134       );
 135     }
 136   }
 137
 138   /**
 139    * Build the payment processor form.
 140    *
 141    * @param CRM_Core_Form $form
 142    */
 143   public static function buildQuickForm(&$form) {
 144     //@todo document why this addHidden is here
 145     //CRM-15743 - we should not set/create hidden element for pay later
 146     // because payment processor is not selected
 147     $processorId = $form->getVar('_paymentProcessorID');
 148     $billing_profile_id = CRM_Utils_Request::retrieve('billing_profile_id', 'String');
 149     if (!empty($form->_values) && !empty($form->_values['is_billing_required'])) {
 150       $billing_profile_id = 'billing';
 151     }
 152     if (!empty($processorId)) {
 153       $form->addElement('hidden', 'hidden_processor', 1);
 154     }
 155     CRM_Core_Payment_Form::buildPaymentForm($form, $form->_paymentProcessor, $billing_profile_id, $form->isBackOffice, $form->paymentInstrumentID);
 156   }
 157
 158 }