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