| 1 |
<?php |
| 2 |
/** |
| 3 |
* Give Settings Page/Tab |
| 4 |
* |
| 5 |
* @package Give |
| 6 |
* @since 1.8 |
| 7 |
* @copyright Copyright (c) 2016, GiveWP |
| 8 |
* @license http://opensource.org/licenses/gpl-2.0.php GNU Public License |
| 9 |
* @subpackage Classes/Give_Settings_Gateways |
| 10 |
*/ |
| 11 |
|
| 12 |
if ( ! defined( 'ABSPATH' ) ) { |
| 13 |
exit; // Exit if accessed directly |
| 14 |
} |
| 15 |
|
| 16 |
if ( ! class_exists( 'Give_Settings_Gateways' ) ) : |
| 17 |
|
| 18 |
/** |
| 19 |
* Give_Settings_Gateways. |
| 20 |
* |
| 21 |
* @sine 1.8 |
| 22 |
*/ |
| 23 |
class Give_Settings_Gateways extends Give_Settings_Page { |
| 24 |
|
| 25 |
/** |
| 26 |
* Constructor. |
| 27 |
*/ |
| 28 |
public function __construct() { |
| 29 |
$this->id = 'gateways'; |
| 30 |
$this->label = esc_html__( 'Payment Gateways', 'give' ); |
| 31 |
|
| 32 |
$this->default_tab = 'gateways-settings'; |
| 33 |
|
| 34 |
parent::__construct(); |
| 35 |
|
| 36 |
// Do not use main form for this tab. |
| 37 |
if ( give_get_current_setting_tab() === $this->id ) { |
| 38 |
add_action( 'give_admin_field_gateway_notice', [ $this, 'render_gateway_notice' ], 10, 2 ); |
| 39 |
add_action( 'give_admin_field_enabled_gateways', [ $this, 'render_enabled_gateways' ], 10, 2 ); |
| 40 |
} |
| 41 |
} |
| 42 |
|
| 43 |
/** |
| 44 |
* Get settings array. |
| 45 |
* |
| 46 |
* @since 1.8 |
| 47 |
* @return array |
| 48 |
*/ |
| 49 |
public function get_settings() { |
| 50 |
$settings = []; |
| 51 |
$current_section = give_get_current_setting_section(); |
| 52 |
|
| 53 |
switch ( $current_section ) { |
| 54 |
case 'offline-donations': |
| 55 |
$settings = [ |
| 56 |
// Section 3: Offline gateway. |
| 57 |
[ |
| 58 |
'type' => 'title', |
| 59 |
'id' => 'give_title_gateway_settings_3', |
| 60 |
], |
| 61 |
[ |
| 62 |
'name' => __( 'Collect Billing Details', 'give' ), |
| 63 |
'desc' => __( 'If enabled, required billing address fields are added to Offline Donation forms. These fields are not required to process the transaction, but you may have a need to collect the data. Billing address details are added to both the donation and donor record in GiveWP. ', 'give' ), |
| 64 |
'id' => 'give_offline_donation_enable_billing_fields', |
| 65 |
'type' => 'radio_inline', |
| 66 |
'default' => 'disabled', |
| 67 |
'options' => [ |
| 68 |
'enabled' => __( 'Enabled', 'give' ), |
| 69 |
'disabled' => __( 'Disabled', 'give' ), |
| 70 |
], |
| 71 |
], |
| 72 |
[ |
| 73 |
'name' => __( 'Offline Donation Instructions', 'give' ), |
| 74 |
'desc' => __( 'The Offline Donation Instructions are a chance for you to educate the donor on how to best submit offline donations. These instructions appear directly on the form, and after submission of the form. Note: You may also customize the instructions on individual forms as needed.', 'give' ), |
| 75 |
'id' => 'global_offline_donation_content', |
| 76 |
'default' => give_get_default_offline_donation_content(), |
| 77 |
'type' => 'wysiwyg', |
| 78 |
'options' => [ |
| 79 |
'textarea_rows' => 6, |
| 80 |
], |
| 81 |
], |
| 82 |
[ |
| 83 |
'name' => esc_html__( 'Offline Donations Settings Docs Link', 'give' ), |
| 84 |
'id' => 'offline_gateway_settings_docs_link', |
| 85 |
'url' => esc_url( 'http://docs.givewp.com/offlinegateway' ), |
| 86 |
'title' => __( 'Offline Gateway Settings', 'give' ), |
| 87 |
'type' => 'give_docs_link', |
| 88 |
], |
| 89 |
[ |
| 90 |
'type' => 'sectionend', |
| 91 |
'id' => 'give_title_gateway_settings_3', |
| 92 |
], |
| 93 |
]; |
| 94 |
break; |
| 95 |
|
| 96 |
case 'gateways-settings': |
| 97 |
$settings = [ |
| 98 |
// Section 1: Gateways. |
| 99 |
[ |
| 100 |
'id' => 'give_title_gateway_settings_1', |
| 101 |
'type' => 'title', |
| 102 |
], |
| 103 |
[ |
| 104 |
'id' => 'gateway_notice', |
| 105 |
'type' => 'gateway_notice', |
| 106 |
], |
| 107 |
[ |
| 108 |
'name' => __( 'Test Mode', 'give' ), |
| 109 |
'desc' => __( 'If enabled, donations are processed through the sandbox/test accounts configured in each gateway\'s settings. This prevents having to use real money for tests. See the payment gateway documentation for instructions on configuring sandbox accounts.', 'give' ), |
| 110 |
'id' => 'test_mode', |
| 111 |
'type' => 'radio_inline', |
| 112 |
'default' => 'disabled', |
| 113 |
'options' => [ |
| 114 |
'enabled' => __( 'Enabled', 'give' ), |
| 115 |
'disabled' => __( 'Disabled', 'give' ), |
| 116 |
], |
| 117 |
], |
| 118 |
[ |
| 119 |
'name' => __( 'Enabled Gateways', 'give' ), |
| 120 |
'desc' => __( 'Enable your payment gateway. Can be ordered by dragging.', 'give' ), |
| 121 |
'id' => 'gateways', |
| 122 |
'type' => 'enabled_gateways', |
| 123 |
], |
| 124 |
|
| 125 |
/** |
| 126 |
* "Enabled Gateways" setting field contains gateways label setting but when you save gateway settings then label will not save |
| 127 |
* because this is not registered setting API and code will not recognize them. |
| 128 |
* |
| 129 |
* This setting will not render on admin setting screen but help internal code to recognize "gateways_label" setting and add them to give setting when save. |
| 130 |
*/ |
| 131 |
[ |
| 132 |
'name' => __( 'Gateways Label', 'give' ), |
| 133 |
'desc' => '', |
| 134 |
'id' => 'gateways_label', |
| 135 |
'type' => 'gateways_label_hidden', |
| 136 |
], |
| 137 |
|
| 138 |
/** |
| 139 |
* "Enabled Gateways" setting field contains default gateway setting but when you save gateway settings then this setting will not save |
| 140 |
* because this is not registered setting API and code will not recognize them. |
| 141 |
* |
| 142 |
* This setting will not render on admin setting screen but help internal code to recognize "default_gateway" setting and add them to give setting when save. |
| 143 |
*/ |
| 144 |
[ |
| 145 |
'name' => __( 'Default Gateway', 'give' ), |
| 146 |
'desc' => __( 'The gateway that will be selected by default.', 'give' ), |
| 147 |
'id' => 'default_gateway', |
| 148 |
'type' => 'default_gateway_hidden', |
| 149 |
], |
| 150 |
|
| 151 |
[ |
| 152 |
'name' => __( 'Gateways Docs Link', 'give' ), |
| 153 |
'id' => 'gateway_settings_docs_link', |
| 154 |
'url' => esc_url( 'http://docs.givewp.com/settings-gateways' ), |
| 155 |
'title' => __( 'Gateway Settings', 'give' ), |
| 156 |
'type' => 'give_docs_link', |
| 157 |
], |
| 158 |
[ |
| 159 |
'id' => 'give_title_gateway_settings_1', |
| 160 |
'type' => 'sectionend', |
| 161 |
], |
| 162 |
]; |
| 163 |
break; |
| 164 |
} |
| 165 |
|
| 166 |
/** |
| 167 |
* Filter the payment gateways settings. |
| 168 |
* Backward compatibility: Please do not use this filter. This filter is deprecated in 1.8 |
| 169 |
*/ |
| 170 |
$settings = apply_filters( 'give_settings_gateways', $settings ); |
| 171 |
|
| 172 |
/** |
| 173 |
* Filter the settings. |
| 174 |
* |
| 175 |
* @since 1.8 |
| 176 |
* |
| 177 |
* @param array $settings |
| 178 |
*/ |
| 179 |
$settings = apply_filters( 'give_get_settings_' . $this->id, $settings ); |
| 180 |
|
| 181 |
// Output. |
| 182 |
return $settings; |
| 183 |
} |
| 184 |
|
| 185 |
/** |
| 186 |
* Get sections. |
| 187 |
* |
| 188 |
* @since 2.9.0 move offline-donations to end of gateway list |
| 189 |
* @since 1.8 |
| 190 |
* |
| 191 |
* @return array |
| 192 |
*/ |
| 193 |
public function get_sections() { |
| 194 |
$sections = apply_filters( |
| 195 |
'give_get_sections_' . $this->id, |
| 196 |
[ |
| 197 |
'gateways-settings' => __( 'Gateways', 'give' ), |
| 198 |
] |
| 199 |
); |
| 200 |
|
| 201 |
$sections['offline-donations'] = __( 'Offline Donations', 'give' ); |
| 202 |
|
| 203 |
return $sections; |
| 204 |
} |
| 205 |
|
| 206 |
|
| 207 |
/** |
| 208 |
* Render Gateway Notice |
| 209 |
* |
| 210 |
* @since 2.3.0 |
| 211 |
* @access public |
| 212 |
* |
| 213 |
* @param $field |
| 214 |
* @param $settings |
| 215 |
*/ |
| 216 |
public function render_gateway_notice( $field, $settings ) { |
| 217 |
$gateways = give_get_payment_gateways(); |
| 218 |
|
| 219 |
// Only display notice if no active gateways are installed. Filter provided for developers to configure display. |
| 220 |
if ( |
| 221 |
apply_filters( 'give_gateway_upsell_notice_conditions', count( $gateways ) <= 4 ) && |
| 222 |
! Give\Helpers\Gateways\Stripe::isAccountConfigured() |
| 223 |
) { |
| 224 |
?> |
| 225 |
<div class="give-gateways-notice"> |
| 226 |
<div class="give-gateways-cc-icon"> |
| 227 |
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="35" |
| 228 |
height="29" viewBox="0 0 35 29"> |
| 229 |
<defs> |
| 230 |
<path id="credit-card-a" |
| 231 |
d="M32.0772569,3.88888889 L2.92274306,3.88888889 C1.30642361,3.88888889 0,5.1953125 0,6.80555556 L0,28.1944444 C0,29.8046875 1.30642361,31.1111111 2.92274306,31.1111111 L32.0772569,31.1111111 C33.6935764,31.1111111 35,29.8046875 35,28.1944444 L35,6.80555556 C35,5.1953125 33.6935764,3.88888889 32.0772569,3.88888889 Z M3.28732639,6.80555556 L31.7126736,6.80555556 C31.9131944,6.80555556 32.0772569,6.96961806 32.0772569,7.17013889 L32.0772569,9.72222222 L2.92274306,9.72222222 L2.92274306,7.17013889 C2.92274306,6.96961806 3.08680556,6.80555556 3.28732639,6.80555556 Z M31.7126736,28.1944444 L3.28732639,28.1944444 C3.08680556,28.1944444 2.92274306,28.0303819 2.92274306,27.8298611 L2.92274306,17.5 L32.0772569,17.5 L32.0772569,27.8298611 C32.0772569,28.0303819 31.9131944,28.1944444 31.7126736,28.1944444 Z M11.6666667,22.1180556 L11.6666667,24.5486111 C11.6666667,24.9496528 11.3385417,25.2777778 10.9375,25.2777778 L6.5625,25.2777778 C6.16145833,25.2777778 5.83333333,24.9496528 5.83333333,24.5486111 L5.83333333,22.1180556 C5.83333333,21.7170139 6.16145833,21.3888889 6.5625,21.3888889 L10.9375,21.3888889 C11.3385417,21.3888889 11.6666667,21.7170139 11.6666667,22.1180556 Z M23.3333333,22.1180556 L23.3333333,24.5486111 C23.3333333,24.9496528 23.0052083,25.2777778 22.6041667,25.2777778 L14.3402778,25.2777778 C13.9392361,25.2777778 13.6111111,24.9496528 13.6111111,24.5486111 L13.6111111,22.1180556 C13.6111111,21.7170139 13.9392361,21.3888889 14.3402778,21.3888889 L22.6041667,21.3888889 C23.0052083,21.3888889 23.3333333,21.7170139 23.3333333,22.1180556 Z"/> |
| 232 |
</defs> |
| 233 |
<g fill="none" fill-rule="evenodd" opacity=".341" transform="translate(0 -3)"> |
| 234 |
<mask id="credit-card-b" fill="#fff"> |
| 235 |
<use xlink:href="#credit-card-a"/> |
| 236 |
</mask> |
| 237 |
<g fill="#242A42" mask="url(#credit-card-b)"> |
| 238 |
<rect width="35" height="35"/> |
| 239 |
</g> |
| 240 |
</g> |
| 241 |
</svg> |
| 242 |
</div> |
| 243 |
|
| 244 |
<p class="give-gateways-notice-title"> |
| 245 |
<strong> |
| 246 |
<?php esc_html_e( 'Want to accept credit card donations directly on your website?', 'give' ); ?> |
| 247 |
</strong> |
| 248 |
</p> |
| 249 |
|
| 250 |
<p class="give-gateways-notice-message"> |
| 251 |
<?php |
| 252 |
printf( |
| 253 |
__( 'Activate the free Stripe payment gateway %1$s or a premium gateway like <a href="%2$s" target="_blank">PayPal Pro</a>, <a href="%3$s" target="_blank">Authorize.net</a>, or <a href="%4$s" target="_blank">Stripe Premium</a> for no added fees and priority support.', 'give' ), |
| 254 |
Give()->tooltips->render_help( __( 'The free version of Stripe includes an additional 2% processing fee in addition to Stripe\'s normal fees for one-time donations. This ensures we can fully support the plugin for the future. Upgrade to the premium Stripe add-on for no added fees.', 'give' ) ), |
| 255 |
'https://givewp.com/addons/paypal-pro-gateway/?utm_source=WP%20Admin%20%3E%20Donations%20%3E%20Settings%20%3E%20Gateways&utm_medium=banner', |
| 256 |
'https://givewp.com/addons/authorize-net-gateway/?utm_source=WP%20Admin%20%3E%20Donations%20%3E%20Settings%20%3E%20Gateways&utm_medium=banner', |
| 257 |
'https://givewp.com/addons/stripe-gateway/?utm_source=WP%20Admin%20%3E%20Donations%20%3E%20Settings%20%3E%20Gateways&utm_medium=banner' |
| 258 |
); |
| 259 |
?> |
| 260 |
</p> |
| 261 |
|
| 262 |
<div class="give-gateways-notice-button"> |
| 263 |
<?php echo give_stripe_connect_button(); ?> |
| 264 |
<a href="https://givewp.com/addons/category/payment-gateways/?utm_source=WP%20Admin%20%3E%20Donations%20%3E%20Settings%20%3E%20Gateways&utm_medium=banner" |
| 265 |
target="_blank" class="give-view-gateways-btn button"> |
| 266 |
<?php esc_html_e( 'View Premium Gateways', 'give' ); ?> |
| 267 |
</a> |
| 268 |
</div> |
| 269 |
</div> |
| 270 |
<?php |
| 271 |
} |
| 272 |
} |
| 273 |
|
| 274 |
/** |
| 275 |
* Render enabled gateways |
| 276 |
* |
| 277 |
* @since 2.0.5 |
| 278 |
* @access public |
| 279 |
* |
| 280 |
* @param $field |
| 281 |
* @param $settings |
| 282 |
*/ |
| 283 |
public function render_enabled_gateways( $field, $settings ) { |
| 284 |
$id = $field['id']; |
| 285 |
$gateways = give_get_ordered_payment_gateways( give_get_payment_gateways() ); |
| 286 |
$gateways_label = give_get_option( 'gateways_label', [] ); |
| 287 |
$default_gateway = give_get_option( 'default_gateway', current( array_keys( $gateways ) ) ); |
| 288 |
|
| 289 |
ob_start(); |
| 290 |
|
| 291 |
echo '<div class="gateway-enabled-wrap">'; |
| 292 |
|
| 293 |
echo '<div class="gateway-enabled-settings-title">'; |
| 294 |
printf( |
| 295 |
' |
| 296 |
<span></span> |
| 297 |
<span>%1$s</span> |
| 298 |
<span>%2$s</span> |
| 299 |
<span>%3$s</span> |
| 300 |
<span>%4$s</span> |
| 301 |
', |
| 302 |
__( 'Gateway', 'give' ), |
| 303 |
__( 'Label', 'give' ), |
| 304 |
__( 'Default', 'give' ), |
| 305 |
__( 'Enabled', 'give' ) |
| 306 |
); |
| 307 |
echo '</div>'; |
| 308 |
|
| 309 |
echo '<ul class="give-checklist-fields give-payment-gatways-list">'; |
| 310 |
foreach ( $gateways as $key => $option ) : |
| 311 |
$enabled = null; |
| 312 |
if ( is_array( $settings ) && array_key_exists( $key, $settings ) ) { |
| 313 |
$enabled = '1'; |
| 314 |
} |
| 315 |
|
| 316 |
echo '<li>'; |
| 317 |
printf( '<span class="give-drag-handle"><span class="dashicons dashicons-menu"></span></span>' ); |
| 318 |
printf( |
| 319 |
'<span class="admin-label">%1$s %2$s</span>', |
| 320 |
esc_html( $option['admin_label'] ), |
| 321 |
! empty( $option['admin_tooltip'] ) ? Give()->tooltips->render_help( esc_attr( $option['admin_tooltip'] ) ) : '' |
| 322 |
); |
| 323 |
|
| 324 |
$label = ''; |
| 325 |
if ( ! empty( $gateways_label[ $key ] ) ) { |
| 326 |
$label = $gateways_label[ $key ]; |
| 327 |
} |
| 328 |
|
| 329 |
printf( |
| 330 |
'<input class="checkout-label" type="text" id="%1$s[%2$s]" name="%1$s[%2$s]" value="%3$s" placeholder="%4$s"/>', |
| 331 |
'gateways_label', |
| 332 |
esc_attr( $key ), |
| 333 |
esc_html( $label ), |
| 334 |
esc_html( $option['checkout_label'] ) |
| 335 |
); |
| 336 |
|
| 337 |
printf( |
| 338 |
'<input class="gateways-radio" type="radio" name="%1$s" value="%2$s" %3$s %4$s>', |
| 339 |
'default_gateway', |
| 340 |
$key, |
| 341 |
checked( $key, $default_gateway, false ), |
| 342 |
disabled( null, $enabled, false ) |
| 343 |
); |
| 344 |
|
| 345 |
printf( |
| 346 |
'<input class="gateways-checkbox" name="%1$s[%2$s]" id="%1$s[%2$s]" type="checkbox" value="1" %3$s data-payment-gateway="%4$s"/>', |
| 347 |
esc_attr( $id ), |
| 348 |
esc_attr( $key ), |
| 349 |
checked( '1', $enabled, false ), |
| 350 |
esc_html( $option['admin_label'] ) |
| 351 |
); |
| 352 |
echo '</li>'; |
| 353 |
endforeach; |
| 354 |
echo '</ul>'; |
| 355 |
|
| 356 |
echo '</div>'; // end gateway-enabled-wrap. |
| 357 |
|
| 358 |
printf( |
| 359 |
'<tr><th>%1$s</th><td>%2$s</td></tr>', |
| 360 |
$field['title'], |
| 361 |
ob_get_clean() |
| 362 |
); |
| 363 |
} |
| 364 |
} |
| 365 |
|
| 366 |
endif; |
| 367 |
|
| 368 |
return new Give_Settings_Gateways(); |
| 369 |
|
