class-settings-addon.php
6 years ago
class-settings-advanced.php
5 years ago
class-settings-display.php
5 years ago
class-settings-email.php
6 years ago
class-settings-gateways.php
5 years ago
class-settings-general.php
5 years ago
class-settings-license.php
6 years ago
class-settings-gateways.php
369 lines
| 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 |