Ian province abbreviation patch - issue 724
[civicrm-core.git] / CRM / Admin / Form / PaymentProcessor.php
... / ...
CommitLineData
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
34/**
35 * This class generates form components for Payment Processor.
36 */
37class CRM_Admin_Form_PaymentProcessor extends CRM_Admin_Form {
38 protected $_id = NULL;
39
40 protected $_testID = NULL;
41
42 protected $_fields = NULL;
43
44 protected $_ppDAO;
45
46 public function preProcess() {
47 if (!CRM_Core_Permission::check('administer payment processors')) {
48 CRM_Core_Error::statusBounce('The \'administer payment processors\' permission is required to add or edit a payment processor.');
49 }
50 parent::preProcess();
51
52 CRM_Utils_System::setTitle(ts('Settings - Payment Processor'));
53
54 // get the payment processor meta information
55
56 if ($this->_id) {
57 $this->_ppType = CRM_Utils_Request::retrieve('pp', 'String', $this, FALSE, NULL);
58 if (!$this->_ppType) {
59 $this->_ppType = CRM_Core_DAO::getFieldValue('CRM_Financial_DAO_PaymentProcessor',
60 $this->_id,
61 'payment_processor_type_id'
62 );
63 }
64 $this->set('pp', $this->_ppType);
65 }
66 else {
67 $this->_ppType = CRM_Utils_Request::retrieve('pp', 'String', $this, TRUE, NULL);
68 }
69
70 $this->assign('ppType', $this->_ppType);
71 $ppTypeName = CRM_Core_DAO::getFieldValue('CRM_Financial_DAO_PaymentProcessorType',
72 $this->_ppType,
73 'name'
74 );
75 $this->assign('ppTypeName', $ppTypeName);
76
77 $this->_ppDAO = new CRM_Financial_DAO_PaymentProcessorType();
78 $this->_ppDAO->id = $this->_ppType;
79
80 if (!$this->_ppDAO->find(TRUE)) {
81 CRM_Core_Error::fatal(ts('Could not find payment processor meta information'));
82 }
83
84 if ($this->_id) {
85 $refreshURL = CRM_Utils_System::url('civicrm/admin/paymentProcessor',
86 "reset=1&action=update&id={$this->_id}",
87 FALSE, NULL, FALSE
88 );
89 }
90 else {
91 $refreshURL = CRM_Utils_System::url('civicrm/admin/paymentProcessor',
92 "reset=1&action=add",
93 FALSE, NULL, FALSE
94 );
95 }
96
97 //CRM-4129
98 $destination = CRM_Utils_Request::retrieve('civicrmDestination', 'String', $this);
99 if ($destination) {
100 $destination = urlencode($destination);
101 $refreshURL .= "&civicrmDestination=$destination";
102 }
103
104 $this->assign('refreshURL', $refreshURL);
105
106 $this->assign('is_recur', $this->_ppDAO->is_recur);
107
108 $this->_fields = array(
109 array(
110 'name' => 'user_name',
111 'label' => $this->_ppDAO->user_name_label,
112 ),
113 array(
114 'name' => 'password',
115 'label' => $this->_ppDAO->password_label,
116 ),
117 array(
118 'name' => 'signature',
119 'label' => $this->_ppDAO->signature_label,
120 ),
121 array(
122 'name' => 'subject',
123 'label' => $this->_ppDAO->subject_label,
124 ),
125 array(
126 'name' => 'url_site',
127 'label' => ts('Site URL'),
128 'rule' => 'url',
129 'msg' => ts('Enter a valid URL'),
130 ),
131 );
132
133 if ($this->_ppDAO->is_recur) {
134 $this->_fields[] = array(
135 'name' => 'url_recur',
136 'label' => ts('Recurring Payments URL'),
137 'rule' => 'url',
138 'msg' => ts('Enter a valid URL'),
139 );
140 }
141
142 if (!empty($this->_ppDAO->url_button_default)) {
143 $this->_fields[] = array(
144 'name' => 'url_button',
145 'label' => ts('Button URL'),
146 'rule' => 'url',
147 'msg' => ts('Enter a valid URL'),
148 );
149 }
150
151 if (!empty($this->_ppDAO->url_api_default)) {
152 $this->_fields[] = array(
153 'name' => 'url_api',
154 'label' => ts('API URL'),
155 'rule' => 'url',
156 'msg' => ts('Enter a valid URL'),
157 );
158 }
159 }
160
161 /**
162 * Build the form object.
163 *
164 * @param bool $check
165 */
166 public function buildQuickForm($check = FALSE) {
167 parent::buildQuickForm();
168
169 if ($this->_action & CRM_Core_Action::DELETE) {
170 return;
171 }
172
173 $attributes = CRM_Core_DAO::getAttribute('CRM_Financial_DAO_PaymentProcessor');
174
175 $this->add('text', 'name', ts('Name'),
176 $attributes['name'], TRUE
177 );
178
179 $this->addRule('name', ts('Name already exists in Database.'), 'objectExists', array(
180 'CRM_Financial_DAO_PaymentProcessor',
181 $this->_id,
182 ));
183
184 $this->add('text', 'description', ts('Description'),
185 $attributes['description']
186 );
187
188 $types = CRM_Core_PseudoConstant::paymentProcessorType();
189 $this->add('select', 'payment_processor_type_id', ts('Payment Processor Type'), $types, TRUE,
190 array('onchange' => "reload(true)")
191 );
192
193 // Financial Account of account type asset CRM-11515
194 $accountType = CRM_Core_PseudoConstant::accountOptionValues('financial_account_type', NULL, " AND v.name = 'Asset' ");
195 $financialAccount = CRM_Contribute_PseudoConstant::financialAccount(NULL, key($accountType));
196 if ($fcount = count($financialAccount)) {
197 $this->assign('financialAccount', $fcount);
198 }
199 $this->add('select', 'financial_account_id', ts('Financial Account'),
200 array('' => ts('- select -')) + $financialAccount,
201 TRUE
202 );
203 // is this processor active ?
204 $this->add('checkbox', 'is_active', ts('Is this Payment Processor active?'));
205 $this->add('checkbox', 'is_default', ts('Is this Payment Processor the default?'));
206
207 foreach ($this->_fields as $field) {
208 if (empty($field['label'])) {
209 continue;
210 }
211
212 $this->add('text', $field['name'],
213 $field['label'], $attributes[$field['name']]
214 );
215 $this->add('text', "test_{$field['name']}",
216 $field['label'], $attributes[$field['name']]
217 );
218 if (!empty($field['rule'])) {
219 $this->addRule($field['name'], $field['msg'], $field['rule']);
220 $this->addRule("test_{$field['name']}", $field['msg'], $field['rule']);
221 }
222 }
223
224 $this->addFormRule(array('CRM_Admin_Form_PaymentProcessor', 'formRule'));
225 }
226
227 /**
228 * @param $fields
229 *
230 * @return array|bool
231 */
232 public static function formRule($fields) {
233
234 // make sure that at least one of live or test is present
235 // and we have at least name and url_site
236 // would be good to make this processor specific
237 $errors = array();
238
239 if (!(self::checkSection($fields, $errors) ||
240 self::checkSection($fields, $errors, 'test')
241 )
242 ) {
243 $errors['_qf_default'] = ts('You must have at least the test or live section filled');
244 }
245
246 if (!empty($errors)) {
247 return $errors;
248 }
249
250 return empty($errors) ? TRUE : $errors;
251 }
252
253 /**
254 * @param $fields
255 * @param $errors
256 * @param null $section
257 *
258 * @return bool
259 */
260 public static function checkSection(&$fields, &$errors, $section = NULL) {
261 $names = array('user_name');
262
263 $present = FALSE;
264 $allPresent = TRUE;
265 foreach ($names as $name) {
266 if ($section) {
267 $name = "{$section}_$name";
268 }
269 if (!empty($fields[$name])) {
270 $present = TRUE;
271 }
272 else {
273 $allPresent = FALSE;
274 }
275 }
276
277 if ($present) {
278 if (!$allPresent) {
279 $errors['_qf_default'] = ts('You must have at least the user_name specified');
280 }
281 }
282 return $present;
283 }
284
285 /**
286 * @return array
287 */
288 public function setDefaultValues() {
289 $defaults = array();
290 if ($this->_ppType) {
291 $defaults['payment_processor_type_id'] = $this->_ppType;
292 }
293 if (!$this->_id) {
294 $defaults['is_active'] = $defaults['is_default'] = 1;
295 $defaults['url_site'] = $this->_ppDAO->url_site_default;
296 $defaults['url_api'] = $this->_ppDAO->url_api_default;
297 $defaults['url_recur'] = $this->_ppDAO->url_recur_default;
298 $defaults['url_button'] = $this->_ppDAO->url_button_default;
299 $defaults['test_url_site'] = $this->_ppDAO->url_site_test_default;
300 $defaults['test_url_api'] = $this->_ppDAO->url_api_test_default;
301 $defaults['test_url_recur'] = $this->_ppDAO->url_recur_test_default;
302 $defaults['test_url_button'] = $this->_ppDAO->url_button_test_default;
303 return $defaults;
304 }
305 $domainID = CRM_Core_Config::domainID();
306
307 $dao = new CRM_Financial_DAO_PaymentProcessor();
308 $dao->id = $this->_id;
309 $dao->domain_id = $domainID;
310 if (!$dao->find(TRUE)) {
311 return $defaults;
312 }
313
314 CRM_Core_DAO::storeValues($dao, $defaults);
315
316 // now get testID
317 $testDAO = new CRM_Financial_DAO_PaymentProcessor();
318 $testDAO->name = $dao->name;
319 $testDAO->is_test = 1;
320 $testDAO->domain_id = $domainID;
321 if ($testDAO->find(TRUE)) {
322 $this->_testID = $testDAO->id;
323
324 foreach ($this->_fields as $field) {
325 $testName = "test_{$field['name']}";
326 $defaults[$testName] = $testDAO->{$field['name']};
327 }
328 }
329 $defaults['financial_account_id'] = CRM_Financial_BAO_FinancialTypeAccount::getFinancialAccount($dao->id, 'civicrm_payment_processor', 'financial_account_id');
330
331 return $defaults;
332 }
333
334 /**
335 * Process the form submission.
336 */
337 public function postProcess() {
338 CRM_Utils_System::flushCache('CRM_Financial_DAO_PaymentProcessor');
339
340 if ($this->_action & CRM_Core_Action::DELETE) {
341 CRM_Financial_BAO_PaymentProcessor::del($this->_id);
342 CRM_Core_Session::setStatus("", ts('Payment Processor Deleted.'), "success");
343 return NULL;
344 }
345
346 $values = $this->controller->exportValues($this->_name);
347 $domainID = CRM_Core_Config::domainID();
348
349 if (!empty($values['is_default'])) {
350 $query = "UPDATE civicrm_payment_processor SET is_default = 0 WHERE domain_id = $domainID";
351 CRM_Core_DAO::executeQuery($query, CRM_Core_DAO::$_nullArray);
352 }
353
354 $this->updatePaymentProcessor($values, $domainID, FALSE);
355 $this->updatePaymentProcessor($values, $domainID, TRUE);
356 CRM_Core_Session::setStatus(ts('Payment processor %1 has been saved.', array(1 => "<em>{$values['name']}</em>")), ts('Saved'), 'success');
357 }
358
359 /**
360 * Save a payment processor.
361 *
362 * @param array $values
363 * @param int $domainID
364 * @param bool $test
365 */
366 public function updatePaymentProcessor(&$values, $domainID, $test) {
367 $dao = new CRM_Financial_DAO_PaymentProcessor();
368
369 $dao->id = $test ? $this->_testID : $this->_id;
370 $dao->domain_id = $domainID;
371 $dao->is_test = $test;
372 $dao->is_default = CRM_Utils_Array::value('is_default', $values, 0);
373
374 $dao->is_active = CRM_Utils_Array::value('is_active', $values, 0);
375
376 $dao->name = $values['name'];
377 $dao->description = $values['description'];
378 $dao->payment_processor_type_id = $values['payment_processor_type_id'];
379
380 foreach ($this->_fields as $field) {
381 $fieldName = $test ? "test_{$field['name']}" : $field['name'];
382 $dao->{$field['name']} = trim(CRM_Utils_Array::value($fieldName, $values));
383 if (empty($dao->{$field['name']})) {
384 $dao->{$field['name']} = 'null';
385 }
386 }
387
388 // also copy meta fields from the info DAO
389 $dao->is_recur = $this->_ppDAO->is_recur;
390 $dao->billing_mode = $this->_ppDAO->billing_mode;
391 $dao->class_name = $this->_ppDAO->class_name;
392 $dao->payment_type = $this->_ppDAO->payment_type;
393
394 $dao->save();
395
396 //CRM-11515
397
398 $relationTypeId = key(CRM_Core_PseudoConstant::accountOptionValues('account_relationship', NULL, " AND v.name LIKE 'Asset Account is' "));
399 $params = array(
400 'entity_table' => 'civicrm_payment_processor',
401 'entity_id' => $dao->id,
402 'account_relationship' => $relationTypeId,
403 'financial_account_id' => $values['financial_account_id'],
404 );
405 CRM_Financial_BAO_FinancialTypeAccount::add($params);
406 }
407
408}