3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2017 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
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. |
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. |
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 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2017
35 * This class generates form components for Payment Processor.
37 class CRM_Admin_Form_PaymentProcessor
extends CRM_Admin_Form
{
38 protected $_id = NULL;
40 protected $_testID = NULL;
42 protected $_fields = NULL;
47 * Get the name of the base entity being edited.
51 public function getDefaultEntity() {
52 return 'PaymentProcessor';
55 public function preProcess() {
59 $this->_ppType
= CRM_Utils_Request
::retrieve('pp', 'String', $this, FALSE, NULL);
60 if (!$this->_ppType
) {
61 $this->_ppType
= CRM_Core_DAO
::getFieldValue('CRM_Financial_DAO_PaymentProcessor',
63 'payment_processor_type_id'
66 $this->set('pp', $this->_ppType
);
69 $this->_ppType
= CRM_Utils_Request
::retrieve('pp', 'String', $this, TRUE, NULL);
72 $this->assign('ppType', $this->_ppType
);
73 $ppTypeName = CRM_Core_DAO
::getFieldValue('CRM_Financial_DAO_PaymentProcessorType',
77 $this->assign('ppTypeName', $ppTypeName);
79 $this->_ppDAO
= new CRM_Financial_DAO_PaymentProcessorType();
80 $this->_ppDAO
->id
= $this->_ppType
;
82 $this->_ppDAO
->find(TRUE);
85 $refreshURL = CRM_Utils_System
::url('civicrm/admin/paymentProcessor',
86 "reset=1&action=update&id={$this->_id}",
91 $refreshURL = CRM_Utils_System
::url('civicrm/admin/paymentProcessor',
98 $destination = CRM_Utils_Request
::retrieve('civicrmDestination', 'String', $this);
100 $destination = urlencode($destination);
101 $refreshURL .= "&civicrmDestination=$destination";
104 $this->assign('refreshURL', $refreshURL);
106 $this->assign('is_recur', $this->_ppDAO
->is_recur
);
108 $this->_fields
= array(
110 'name' => 'user_name',
111 'label' => $this->_ppDAO
->user_name_label
,
114 'name' => 'password',
115 'label' => $this->_ppDAO
->password_label
,
118 'name' => 'signature',
119 'label' => $this->_ppDAO
->signature_label
,
123 'label' => $this->_ppDAO
->subject_label
,
126 'name' => 'url_site',
127 'label' => ts('Site URL'),
129 'msg' => ts('Enter a valid URL'),
133 if ($this->_ppDAO
->is_recur
) {
134 $this->_fields
[] = array(
135 'name' => 'url_recur',
136 'label' => ts('Recurring Payments URL'),
138 'msg' => ts('Enter a valid URL'),
142 if (!empty($this->_ppDAO
->url_button_default
)) {
143 $this->_fields
[] = array(
144 'name' => 'url_button',
145 'label' => ts('Button URL'),
147 'msg' => ts('Enter a valid URL'),
151 if (!empty($this->_ppDAO
->url_api_default
)) {
152 $this->_fields
[] = array(
154 'label' => ts('API URL'),
156 'msg' => ts('Enter a valid URL'),
162 * Build the form object.
166 public function buildQuickForm($check = FALSE) {
167 parent
::buildQuickForm();
169 if ($this->_action
& CRM_Core_Action
::DELETE
) {
173 $attributes = CRM_Core_DAO
::getAttribute('CRM_Financial_DAO_PaymentProcessor');
175 $this->add('text', 'name', ts('Name'),
176 $attributes['name'], TRUE
179 $this->addRule('name', ts('Name already exists in Database.'), 'objectExists', array(
180 'CRM_Financial_DAO_PaymentProcessor',
183 CRM_Core_Config
::domainID(),
186 $this->add('text', 'description', ts('Description'),
187 $attributes['description']
190 $types = CRM_Core_PseudoConstant
::paymentProcessorType();
191 $this->add('select', 'payment_processor_type_id', ts('Payment Processor Type'), $types, TRUE,
192 array('onchange' => "reload(true)")
195 // Financial Account of account type asset CRM-11515
196 $accountType = CRM_Core_PseudoConstant
::accountOptionValues('financial_account_type', NULL, " AND v.name = 'Asset' ");
197 $financialAccount = CRM_Contribute_PseudoConstant
::financialAccount(NULL, key($accountType));
198 if ($fcount = count($financialAccount)) {
199 $this->assign('financialAccount', $fcount);
201 $this->add('select', 'financial_account_id', ts('Financial Account'),
202 array('' => ts('- select -')) +
$financialAccount,
205 $this->addSelect('payment_instrument_id',
207 'entity' => 'contribution',
208 'label' => ts('Payment Method'),
209 'placeholder' => NULL,
213 // is this processor active ?
214 $this->add('checkbox', 'is_active', ts('Is this Payment Processor active?'));
215 $this->add('checkbox', 'is_default', ts('Is this Payment Processor the default?'));
216 $creditCardTypes = CRM_Contribute_PseudoConstant
::creditCard();
217 $this->addCheckBox('accept_credit_cards', ts('Accepted Credit Card Type(s)'),
218 $creditCardTypes, NULL, NULL, NULL, NULL, ' ');
219 foreach ($this->_fields
as $field) {
220 if (empty($field['label'])) {
224 $this->addField($field['name'], array('label' => $field['label']));
226 $fieldSpec = civicrm_api3($this->getDefaultEntity(), 'getfield', array(
227 'name' => $field['name'],
228 'action' => 'create',
230 $this->add($fieldSpec['values']['html']['type'], "test_{$field['name']}",
231 $field['label'], $attributes[$field['name']]
233 if (!empty($field['rule'])) {
234 $this->addRule($field['name'], $field['msg'], $field['rule']);
235 $this->addRule("test_{$field['name']}", $field['msg'], $field['rule']);
239 $this->addFormRule(array('CRM_Admin_Form_PaymentProcessor', 'formRule'));
247 public static function formRule($fields) {
249 // make sure that at least one of live or test is present
250 // and we have at least name and url_site
251 // would be good to make this processor specific
254 if (!(self
::checkSection($fields, $errors) ||
255 self
::checkSection($fields, $errors, 'test')
258 $errors['_qf_default'] = ts('You must have at least the test or live section filled');
261 if (!empty($errors)) {
265 return empty($errors) ?
TRUE : $errors;
271 * @param null $section
275 public static function checkSection(&$fields, &$errors, $section = NULL) {
276 $names = array('user_name');
280 foreach ($names as $name) {
282 $name = "{$section}_$name";
284 if (!empty($fields[$name])) {
294 $errors['_qf_default'] = ts('You must have at least the user_name specified');
303 public function setDefaultValues() {
307 $defaults['is_active'] = $defaults['is_default'] = 1;
308 $defaults['url_site'] = $this->_ppDAO
->url_site_default
;
309 $defaults['url_api'] = $this->_ppDAO
->url_api_default
;
310 $defaults['url_recur'] = $this->_ppDAO
->url_recur_default
;
311 $defaults['url_button'] = $this->_ppDAO
->url_button_default
;
312 $defaults['test_url_site'] = $this->_ppDAO
->url_site_test_default
;
313 $defaults['test_url_api'] = $this->_ppDAO
->url_api_test_default
;
314 $defaults['test_url_recur'] = $this->_ppDAO
->url_recur_test_default
;
315 $defaults['test_url_button'] = $this->_ppDAO
->url_button_test_default
;
316 $defaults['payment_instrument_id'] = $this->_ppDAO
->payment_instrument_id
;
317 // When user changes payment processor type, it is passed in via $this->_ppType so update defaults array.
318 if ($this->_ppType
) {
319 $defaults['payment_processor_type_id'] = $this->_ppType
;
323 $domainID = CRM_Core_Config
::domainID();
325 $dao = new CRM_Financial_DAO_PaymentProcessor();
326 $dao->id
= $this->_id
;
327 $dao->domain_id
= $domainID;
328 if (!$dao->find(TRUE)) {
332 CRM_Core_DAO
::storeValues($dao, $defaults);
333 // When user changes payment processor type, it is passed in via $this->_ppType so update defaults array.
334 if ($this->_ppType
) {
335 $defaults['payment_processor_type_id'] = $this->_ppType
;
337 $cards = json_decode(CRM_Core_DAO
::getFieldValue('CRM_Financial_DAO_PaymentProcessor',
339 'accepted_credit_cards'
341 $acceptedCards = array();
342 if (!empty($cards)) {
343 foreach ($cards as $card => $val) {
344 $acceptedCards[$card] = 1;
347 $defaults['accept_credit_cards'] = $acceptedCards;
348 unset($defaults['accepted_credit_cards']);
350 $testDAO = new CRM_Financial_DAO_PaymentProcessor();
351 $testDAO->name
= $dao->name
;
352 $testDAO->is_test
= 1;
353 $testDAO->domain_id
= $domainID;
354 if ($testDAO->find(TRUE)) {
355 $this->_testID
= $testDAO->id
;
357 foreach ($this->_fields
as $field) {
358 $testName = "test_{$field['name']}";
359 $defaults[$testName] = $testDAO->{$field['name']};
362 $defaults['financial_account_id'] = CRM_Contribute_PseudoConstant
::getRelationalFinancialAccount($dao->id
, NULL, 'civicrm_payment_processor');
368 * Process the form submission.
370 public function postProcess() {
372 if ($this->_action
& CRM_Core_Action
::DELETE
) {
373 CRM_Financial_BAO_PaymentProcessor
::del($this->_id
);
374 CRM_Core_Session
::setStatus("", ts('Payment Processor Deleted.'), "success");
378 $values = $this->controller
->exportValues($this->_name
);
379 $domainID = CRM_Core_Config
::domainID();
381 if (!empty($values['is_default'])) {
382 $query = "UPDATE civicrm_payment_processor SET is_default = 0 WHERE domain_id = $domainID";
383 CRM_Core_DAO
::executeQuery($query);
386 $this->updatePaymentProcessor($values, $domainID, FALSE);
387 $this->updatePaymentProcessor($values, $domainID, TRUE);
388 CRM_Core_Session
::setStatus(ts('Payment processor %1 has been saved.', array(1 => "<em>{$values['name']}</em>")), ts('Saved'), 'success');
392 * Save a payment processor.
394 * @param array $values
395 * @param int $domainID
398 public function updatePaymentProcessor(&$values, $domainID, $test) {
400 foreach (array('user_name', 'password', 'signature', 'url_site', 'url_recur', 'url_api', 'url_button', 'subject') as $field) {
401 $values[$field] = empty($values["test_{$field}"]) ? CRM_Utils_Array
::value($field, $values) : $values["test_{$field}"];
404 if (!empty($values['accept_credit_cards'])) {
405 $creditCards = array();
406 $accptedCards = array_keys($values['accept_credit_cards']);
407 $creditCardTypes = CRM_Contribute_PseudoConstant
::creditCard();
408 foreach ($creditCardTypes as $type => $val) {
409 if (in_array($type, $accptedCards)) {
410 $creditCards[$type] = $creditCardTypes[$type];
413 $creditCards = json_encode($creditCards);
416 $creditCards = "NULL";
418 $params = array_merge(array(
419 'id' => $test ?
$this->_testID
: $this->_id
,
420 'domain_id' => $domainID,
424 'is_recur' => $this->_ppDAO
->is_recur
,
425 'billing_mode' => $this->_ppDAO
->billing_mode
,
426 'class_name' => $this->_ppDAO
->class_name
,
427 'payment_type' => $this->_ppDAO
->payment_type
,
428 'payment_instrument_id' => $this->_ppDAO
->payment_instrument_id
,
429 'financial_account_id' => $values['financial_account_id'],
430 'accepted_credit_cards' => $creditCards,
433 civicrm_api3('PaymentProcessor', 'create', $params);