clover/clover.php at main · aghstrategies/clover · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<?php

require_once 'clover.civix.php';
use CRM_Clover_ExtensionUtil as E;

/**
 * Implements hook_civicrm_links().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_links
 */
function clover_civicrm_links($op, $objectName, $objectId, &$links, &$mask, &$values) {

  // Adds a refund link to each payment that is refundable or voidable
  if ($objectName == 'Payment' && $op == 'Payment.edit.action') {

    // First check the contribution status
    if (!empty($values['contribution_id'])) {
      $contributions = \Civi\Api4\Contribution::get(TRUE)
        ->addSelect('contribution_status_id:name')
        ->addWhere('id', '=', $values['contribution_id'])
        ->setLimit(1)
        ->execute();
      foreach ($contributions as $contribution) {
        if (in_array($contribution['contribution_status_id:name'], ['Completed', 'Partially Paid', 'Pending refund']) && !empty($values['id'])) {
          $financialTrxn = CRM_Core_Payment_Clover::getFinancialTrxn($values['id']);
          // Only allow refunding for transactions:
          //  - with status completed
          //  - from a clover processor
          //  - with a transaction id
          //  - with a total amount greater than 0
          if ($financialTrxn['status_id:name'] == 'Completed'
            && $financialTrxn['payment_processor_id.payment_processor_type_id:name'] == 'Clover'
            && !empty($financialTrxn['trxn_id'])
            && $financialTrxn['total_amount'] > 0
            && $financialTrxn['action']
          ) {
            $links[] = [
              'name' => ucfirst($financialTrxn['action']) . ' Payment',
              'icon' => 'fa-undo',
              'url' => 'civicrm/clover/refund',
              'class' => 'medium-popup',
              'qs' => 'reset=1&payment_id=%%id%%&contribution_id=%%contribution_id%%',
              'title' =>  ucfirst($financialTrxn['action']) . ' Payment',
              'bit' => 2,
            ];
          }
        }
      }
    }
  }
}

function clover_apiv3helper($entity, $action, $params) {
  try {
    $result = civicrm_api3($entity, $action, $params);
  }
  catch (CiviCRM_API3_Exception $e) {
    $error = $e->getMessage();
    CRM_Core_Error::debug_log_message(E::ts('clover API v3 Error %1', [
      'domain' => E::LONG_NAME,
      1 => $error,
    ]));
  }
  return $result;
}

/**
 * Implements hook_civicrm_config().
 *
 * @link https://docs.civicrm.org/dev/en/latest/hooks/hook_civicrm_config/
 */
function clover_civicrm_config(&$config): void {
  _clover_civix_civicrm_config($config);
}

/**
 * Implements hook_civicrm_install().
 *
 * @link https://docs.civicrm.org/dev/en/latest/hooks/hook_civicrm_install
 */
function clover_civicrm_install(): void {
  _clover_civix_civicrm_install();
}

/**
 * Implements hook_civicrm_enable().
 *
 * @link https://docs.civicrm.org/dev/en/latest/hooks/hook_civicrm_enable
 */
function clover_civicrm_enable(): void {
  _clover_civix_civicrm_enable();
}

// --- Functions below this ship commented out. Uncomment as required. ---

/**
 * Implements hook_civicrm_preProcess().
 *
 * @link https://docs.civicrm.org/dev/en/latest/hooks/hook_civicrm_preProcess
 */
//function clover_civicrm_preProcess($formName, &$form): void {
//
//}

/**
 * Implements hook_civicrm_navigationMenu().
 *
 * @link https://docs.civicrm.org/dev/en/latest/hooks/hook_civicrm_navigationMenu
 */
//function clover_civicrm_navigationMenu(&$menu): void {
//  _clover_civix_insert_navigation_menu($menu, 'Mailings', [
//    'label' => E::ts('New subliminal message'),
//    'name' => 'mailing_subliminal_message',
//    'url' => 'civicrm/mailing/subliminal',
//    'permission' => 'access CiviMail',
//    'operator' => 'OR',
//    'separator' => 0,
//  ]);
//  _clover_civix_navigationMenu($menu);
//}