mirror of
https://github.com/woocommerce/woocommerce-paypal-payments.git
synced 2025-08-31 06:52:50 +08:00
564 lines
26 KiB
PHP
564 lines
26 KiB
PHP
<?php
|
||
/**
|
||
* The services of the Gateway module.
|
||
*
|
||
* @package WooCommerce\PayPalCommerce\WcGateway
|
||
*/
|
||
|
||
// phpcs:disable WordPress.Security.NonceVerification.Recommended
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace WooCommerce\PayPalCommerce\WcGateway\Settings;
|
||
|
||
use WooCommerce\PayPalCommerce\ApiClient\Helper\PurchaseUnitSanitizer;
|
||
use WooCommerce\PayPalCommerce\Vendor\Psr\Container\ContainerInterface;
|
||
use WooCommerce\PayPalCommerce\ApiClient\Helper\DccApplies;
|
||
use WooCommerce\PayPalCommerce\Onboarding\Environment;
|
||
use WooCommerce\PayPalCommerce\Onboarding\Render\OnboardingOptionsRenderer;
|
||
use WooCommerce\PayPalCommerce\Onboarding\State;
|
||
use WooCommerce\PayPalCommerce\WcGateway\Helper\DisplayManager;
|
||
|
||
return function ( ContainerInterface $container, array $fields ): array {
|
||
|
||
$current_page_id = $container->get( 'wcgateway.current-ppcp-settings-page-id' );
|
||
|
||
if ( $current_page_id !== Settings::CONNECTION_TAB_ID ) {
|
||
return $fields;
|
||
}
|
||
|
||
$state = $container->get( 'onboarding.state' );
|
||
assert( $state instanceof State );
|
||
|
||
$dcc_applies = $container->get( 'api.helpers.dccapplies' );
|
||
assert( $dcc_applies instanceof DccApplies );
|
||
|
||
$is_shop_supports_dcc = $dcc_applies->for_country_currency() || $dcc_applies->for_wc_payments();
|
||
|
||
$onboarding_options_renderer = $container->get( 'onboarding.render-options' );
|
||
assert( $onboarding_options_renderer instanceof OnboardingOptionsRenderer );
|
||
|
||
$module_url = $container->get( 'wcgateway.url' );
|
||
|
||
$display_manager = $container->get( 'wcgateway.display-manager' );
|
||
assert( $display_manager instanceof DisplayManager );
|
||
|
||
$connection_fields = array(
|
||
'ppcp_onboarading_header' => array(
|
||
'type' => 'ppcp-text',
|
||
'classes' => array( 'ppcp-onboarding-element' ),
|
||
'text' => '
|
||
<div class="ppcp-onboarding-header">
|
||
<div class="ppcp-onboarding-header-left">
|
||
<img alt="PayPal" src="' . esc_url( $module_url ) . 'assets/images/paypal.png"/>
|
||
<h2>The all-in-one checkout solution</h2>
|
||
</div>
|
||
<div class="ppcp-onboarding-header-right">
|
||
<div class="ppcp-onboarding-header-paypal-logos">
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#standard-paypal-payments" target="_blank"><img alt="PayPal" src="' . esc_url( $module_url ) . 'assets/images/paypal-button.svg"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#pay-with-venmo" target="_blank"><img alt="Venmo" src="' . esc_url( $module_url ) . 'assets/images/venmo.svg"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#pay-later" target="_blank"><img alt="Pay Later" src="' . esc_url( $module_url ) . 'assets/images/paylater.svg"/></a>
|
||
</div>
|
||
<div class="ppcp-onboarding-header-cards">
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#paypal-card-processing-acdc" target="_blank"><img alt="Visa" src="' . esc_url( $module_url ) . 'assets/images/visa-dark.svg"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#paypal-card-processing-acdc" target="_blank"><img alt="Mastercard" src="' . esc_url( $module_url ) . 'assets/images/mastercard-dark.svg"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#paypal-card-processing-acdc" target="_blank"><img alt="American Express" src="' . esc_url( $module_url ) . 'assets/images/amex.svg"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#paypal-card-processing-acdc" target="_blank"><img alt="Discover" src="' . esc_url( $module_url ) . 'assets/images/discover.svg"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#alternative-payment-methods" target="_blank"><img alt="iDEAL" src="' . esc_url( $module_url ) . 'assets/images/ideal-dark.svg"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#alternative-payment-methods" target="_blank"><img alt="Sofort" src="' . esc_url( $module_url ) . 'assets/images/sofort.svg"/></a>
|
||
</div>
|
||
<div class="ppcp-onboarding-header-apm-logos">
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#apple-pay" target="_blank"><img alt="Apple Pay" src="' . esc_url( $module_url ) . 'assets/images/button-Apple-Pay.png"/></a>
|
||
<a href="https://woo.com/document/woocommerce-paypal-payments/#google-pay" target="_blank"><img alt="Google Pay" src="' . esc_url( $module_url ) . 'assets/images/button-Google-Pay.png"/></a>
|
||
</div>
|
||
</div>
|
||
</div>',
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'credentials_production_heading' => array(
|
||
'heading' => __( 'API Credentials', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-heading',
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'state_from' => Environment::PRODUCTION,
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'credentials_sandbox_heading' => array(
|
||
'heading' => __( 'Sandbox API Credentials', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-heading',
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'state_from' => Environment::SANDBOX,
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'description' => __( 'Your account is connected to sandbox, no real charging takes place. To accept live payments, turn off sandbox mode and connect your live PayPal account.', 'woocommerce-paypal-payments' ),
|
||
),
|
||
|
||
'ppcp_onboarading_options' => array(
|
||
'type' => 'ppcp-text',
|
||
'classes' => array( 'ppcp-onboarding-element' ),
|
||
'text' => $onboarding_options_renderer->render( $is_shop_supports_dcc ),
|
||
'raw' => true,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
|
||
// We need to have a button for each option (ppcp, express)
|
||
// because currently the only documented way to use the PayPal onboarding JS library
|
||
// is to have the buttons before loading the script.
|
||
'ppcp_onboarding_production_ppcp' => array(
|
||
'type' => 'ppcp_onboarding',
|
||
'classes' => array( 'ppcp-onboarding-element' ),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
),
|
||
'state_from' => Environment::PRODUCTION,
|
||
'env' => Environment::PRODUCTION,
|
||
'products' => array( 'PPCP' ),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'ppcp_onboarding_production_express' => array(
|
||
'type' => 'ppcp_onboarding',
|
||
'classes' => array( 'ppcp-onboarding-element' ),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
),
|
||
'state_from' => Environment::PRODUCTION,
|
||
'env' => Environment::PRODUCTION,
|
||
'products' => array( 'EXPRESS_CHECKOUT' ),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'ppcp_onboarding_sandbox_ppcp' => array(
|
||
'type' => 'ppcp_onboarding',
|
||
'classes' => array( 'ppcp-onboarding-element' ),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
),
|
||
'state_from' => Environment::SANDBOX,
|
||
'env' => Environment::SANDBOX,
|
||
'products' => array( 'PPCP' ),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'description' => __( 'Prior to accepting live payments, you can test payments on your WooCommerce platform in a safe PayPal sandbox environment.', 'woocommerce-paypal-payments' ),
|
||
),
|
||
'ppcp_onboarding_sandbox_express' => array(
|
||
'type' => 'ppcp_onboarding',
|
||
'classes' => array( 'ppcp-onboarding-element' ),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
),
|
||
'state_from' => Environment::SANDBOX,
|
||
'env' => Environment::SANDBOX,
|
||
'products' => array( 'EXPRESS_CHECKOUT' ),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'description' => __( 'Prior to accepting live payments, you can test payments on your WooCommerce platform in a safe PayPal sandbox environment.', 'woocommerce-paypal-payments' ),
|
||
),
|
||
|
||
'ppcp_disconnect_production' => array(
|
||
'title' => __( 'Disconnect from PayPal', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-text',
|
||
'text' => sprintf(
|
||
'<p>%1$s <span class="dashicons dashicons-yes"></span></p><p><button type="button" class="button ppcp-disconnect production">%2$s</button></p>',
|
||
esc_html__( 'Status: Connected', 'woocommerce-paypal-payments' ),
|
||
esc_html__( 'Disconnect Account', 'woocommerce-paypal-payments' )
|
||
),
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'state_from' => Environment::PRODUCTION,
|
||
'env' => Environment::PRODUCTION,
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'description' => __( 'Click to reset current credentials and use another account.', 'woocommerce-paypal-payments' ),
|
||
),
|
||
'ppcp_disconnect_sandbox' => array(
|
||
'title' => __( 'Disconnect from PayPal Sandbox', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-text',
|
||
'text' => sprintf(
|
||
'<p>%1$s <span class="dashicons dashicons-yes"></span></p><p><button type="button" class="button ppcp-disconnect sandbox">%2$s</button></p>',
|
||
esc_html__( 'Status: Connected', 'woocommerce-paypal-payments' ),
|
||
esc_html__( 'Disconnect Account', 'woocommerce-paypal-payments' )
|
||
),
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'state_from' => Environment::SANDBOX,
|
||
'env' => Environment::SANDBOX,
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'description' => __( 'Click to reset current credentials and use another account.', 'woocommerce-paypal-payments' ),
|
||
),
|
||
'toggle_manual_input' => array(
|
||
'type' => 'ppcp-text',
|
||
'text' => '<button type="button" id="ppcp[toggle_manual_input]">' . __( 'Toggle to manual credential input', 'woocommerce-paypal-payments' ) . '</button>',
|
||
'description' => sprintf(
|
||
'%1$s <a href="https://woocommerce.com/document/woocommerce-paypal-payments/#manual-credential-input" target="_blank">%2$s</a>',
|
||
esc_html__( 'Further information on manual credential input:', 'woocommerce-paypal-payments' ),
|
||
esc_html__( 'documentation', 'woocommerce-paypal-payments' )
|
||
),
|
||
'classes' => array( 'ppcp-onboarding-element' ),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'error_label' => array(
|
||
'type' => 'ppcp-text',
|
||
'text' => '<label class="error" id="ppcp-form-errors-label"></label>',
|
||
'classes' => array( 'hide', 'ppcp-always-shown-element' ),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'sandbox_on' => array(
|
||
'title' => __( 'Sandbox', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( 'ppcp-onboarding-element', 'ppcp-always-shown-element' ),
|
||
'type' => 'checkbox',
|
||
'label' => __( 'To test your WooCommerce installation, you can use the sandbox mode.', 'woocommerce-paypal-payments' ),
|
||
'default' => 0,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'merchant_email_production' => array(
|
||
'title' => __( 'Live Email address', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->production_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'email',
|
||
'required' => true,
|
||
'desc_tip' => true,
|
||
'description' => __( 'The email address of your PayPal account.', 'woocommerce-paypal-payments' ),
|
||
'default' => '',
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'merchant_id_production' => array(
|
||
'title' => __( 'Live Merchant Id', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->production_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'text',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The merchant id of your account. Should be exactly 13 alphanumeric uppercase letters.', 'woocommerce-paypal-payments' ),
|
||
'maxlength' => 13,
|
||
'custom_attributes' => array(
|
||
'pattern' => '[A-Z0-9]{13}',
|
||
'autocomplete' => 'off',
|
||
),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'client_id_production' => array(
|
||
'title' => __( 'Live Client Id', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->production_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'text',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The client id of your api ', 'woocommerce-paypal-payments' ),
|
||
'custom_attributes' => array(
|
||
'autocomplete' => 'off',
|
||
),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'client_secret_production' => array(
|
||
'title' => __( 'Live Secret Key', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->production_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'ppcp-password',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The secret key of your api', 'woocommerce-paypal-payments' ),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
|
||
'merchant_email_sandbox' => array(
|
||
'title' => __( 'Sandbox Email address', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->sandbox_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'email',
|
||
'required' => true,
|
||
'desc_tip' => true,
|
||
'description' => __( 'The email address of your PayPal account.', 'woocommerce-paypal-payments' ),
|
||
'default' => '',
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'merchant_id_sandbox' => array(
|
||
'title' => __( 'Sandbox Merchant Id', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->sandbox_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'text',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The merchant id of your account. Should be exactly 13 alphanumeric uppercase letters.', 'woocommerce-paypal-payments' ),
|
||
'maxlength' => 13,
|
||
'custom_attributes' => array(
|
||
'pattern' => '[A-Z0-9]{13}',
|
||
'autocomplete' => 'off',
|
||
),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'client_id_sandbox' => array(
|
||
'title' => __( 'Sandbox Client Id', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->sandbox_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'text',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The client id of your api ', 'woocommerce-paypal-payments' ),
|
||
'custom_attributes' => array(
|
||
'autocomplete' => 'off',
|
||
),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'client_secret_sandbox' => array(
|
||
'title' => __( 'Sandbox Secret Key', 'woocommerce-paypal-payments' ),
|
||
'classes' => array( State::STATE_ONBOARDED === $state->sandbox_state() ? 'onboarded' : '', 'ppcp-always-shown-element' ),
|
||
'type' => 'ppcp-password',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The secret key of your api', 'woocommerce-paypal-payments' ),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
|
||
'credentials_feature_onboarding_heading' => array(
|
||
'heading' => __( 'Advanced feature availability & sign-up', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-heading',
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'description' => sprintf(
|
||
// translators: %1$s and %2$s are the opening and closing of HTML <a> tag.
|
||
__( 'Displays whether available advanced features are enabled for the connected PayPal account. More information about advanced features is available in the %1$sFeature sign-up documentation%2$s.', 'woocommerce-paypal-payments' ),
|
||
'<a href="https://woocommerce.com/document/woocommerce-paypal-payments/#feature-signup" target="_blank">',
|
||
'</a>'
|
||
),
|
||
),
|
||
'refresh_feature_status' => array(
|
||
'title' => __( 'Refresh feature availability status', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-text',
|
||
'text' => '<button type="button" class="button ppcp-refresh-feature-status">' . esc_html__( 'Check available features', 'woocommerce-paypal-payments' ) . '</button><div class="ppcp-status-text"></div>',
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'ppcp_dcc_status' => array(
|
||
'title' => __( 'Advanced Credit and Debit Card Payments', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-text',
|
||
'text' => $container->get( 'wcgateway.settings.connection.dcc-status-text' ),
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array( 'dcc' ),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'ppcp_reference_transactions_status' => array(
|
||
'title' => __( 'Advanced PayPal Wallet', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-text',
|
||
'text' => $container->get( 'wcgateway.settings.connection.reference-transactions-status-text' ),
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array( 'dcc' ),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'ppcp_pui_status' => array(
|
||
'title' => __( 'Pay upon Invoice', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-text',
|
||
'text' => $container->get( 'wcgateway.settings.connection.pui-status-text' ),
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array( 'pui_ready' ),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'fraudnet_enabled' => array(
|
||
'title' => __( 'FraudNet', 'woocommerce-paypal-payments' ),
|
||
'type' => 'checkbox',
|
||
'desc_tip' => true,
|
||
'label' => $container->get( 'wcgateway.settings.fraudnet-label' ),
|
||
'description' => __( 'FraudNet is a JavaScript library developed by PayPal and embedded into a merchant’s web page to collect browser-based data to help reduce fraud.', 'woocommerce-paypal-payments' ),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'input_class' => $container->get( 'wcgateway.settings.should-disable-fraudnet-checkbox' ) ? array( 'ppcp-disabled-checkbox' ) : array(),
|
||
),
|
||
'credentials_integration_configuration_heading' => array(
|
||
'heading' => __( 'General integration configuration', 'woocommerce-paypal-payments' ),
|
||
'type' => 'ppcp-heading',
|
||
'screens' => array(
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'description' => sprintf(
|
||
// translators: %1$s and %2$s are the opening and closing of HTML <a> tag.
|
||
__( 'Configure integration specific settings such as a unique invoice prefix, or logging for potential %1$stroubleshooting%2$s.', 'woocommerce-paypal-payments' ),
|
||
'<a href="https://woocommerce.com/document/woocommerce-paypal-payments/#troubleshooting" target="_blank">',
|
||
'</a>'
|
||
),
|
||
),
|
||
'soft_descriptor' => array(
|
||
'title' => __( 'Soft Descriptor', 'woocommerce-paypal-payments' ),
|
||
'type' => 'text',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The soft descriptor is the dynamic text used to construct the statement descriptor that appears on a payer\'s card statement. Text field, max value of 22 characters.', 'woocommerce-paypal-payments' ),
|
||
'maxlength' => 22,
|
||
'default' => '',
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'prefix' => array(
|
||
'title' => __( 'Invoice prefix', 'woocommerce-paypal-payments' ),
|
||
'type' => 'text',
|
||
'desc_tip' => true,
|
||
'description' => __( 'If you use your PayPal account with more than one installation, please use a distinct prefix to separate those installations. Please use only English letters and "-", "_" characters.', 'woocommerce-paypal-payments' ),
|
||
'maxlength' => 15,
|
||
'custom_attributes' => array(
|
||
'pattern' => '[a-zA-Z_\\-]+',
|
||
),
|
||
'default' => ( static function (): string {
|
||
$site_url = get_site_url( get_current_blog_id() );
|
||
$hash = md5( $site_url );
|
||
$letters = preg_replace( '~\d~', '', $hash ) ?? '';
|
||
$prefix = substr( $letters, 0, 6 );
|
||
return $prefix ? $prefix . '-' : '';
|
||
} )(),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'logging_enabled' => array(
|
||
'title' => __( 'Logging', 'woocommerce-paypal-payments' ),
|
||
'type' => 'checkbox',
|
||
'desc_tip' => true,
|
||
'label' => __( 'Enable logging. ', 'woocommerce-paypal-payments' ) .
|
||
' <a href="' . admin_url( 'admin.php?page=wc-status&tab=logs' ) . '">' . __( 'View logs', 'woocommerce-paypal-payments' ) . '</a>',
|
||
'description' => __( 'Enable logging of unexpected behavior. This can also log private data and should only be enabled in a development or stage environment.', 'woocommerce-paypal-payments' ),
|
||
'default' => false,
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
'subtotal_mismatch_behavior' => array(
|
||
'title' => __( 'Subtotal mismatch behavior', 'woocommerce-paypal-payments' ),
|
||
'type' => 'select',
|
||
'input_class' => array( 'wc-enhanced-select' ),
|
||
'default' => 'vertical',
|
||
'desc_tip' => true,
|
||
'description' => __(
|
||
'Differences between WooCommerce and PayPal roundings may cause mismatch in order items subtotal calculations. If not handled, these mismatches will cause the PayPal transaction to fail.',
|
||
'woocommerce-paypal-payments'
|
||
),
|
||
'options' => array(
|
||
PurchaseUnitSanitizer::MODE_DITCH => __( 'Do not send line items to PayPal', 'woocommerce-paypal-payments' ),
|
||
PurchaseUnitSanitizer::MODE_EXTRA_LINE => __( 'Add another line item', 'woocommerce-paypal-payments' ),
|
||
),
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
'custom_attributes' => array(
|
||
'data-ppcp-display' => wp_json_encode(
|
||
array(
|
||
$display_manager
|
||
->rule()
|
||
->condition_element( 'subtotal_mismatch_behavior', PurchaseUnitSanitizer::MODE_EXTRA_LINE )
|
||
->action_visible( 'subtotal_mismatch_line_name' )
|
||
->to_array(),
|
||
)
|
||
),
|
||
),
|
||
),
|
||
'subtotal_mismatch_line_name' => array(
|
||
'title' => __( 'Subtotal mismatch line name', 'woocommerce-paypal-payments' ),
|
||
'type' => 'text',
|
||
'desc_tip' => true,
|
||
'description' => __( 'The name of the extra line that will be sent to PayPal to correct the subtotal mismatch.', 'woocommerce-paypal-payments' ),
|
||
'maxlength' => 22,
|
||
'default' => '',
|
||
'screens' => array(
|
||
State::STATE_START,
|
||
State::STATE_ONBOARDED,
|
||
),
|
||
'requirements' => array(),
|
||
'placeholder' => PurchaseUnitSanitizer::EXTRA_LINE_NAME,
|
||
'gateway' => Settings::CONNECTION_TAB_ID,
|
||
),
|
||
);
|
||
|
||
return array_merge( $fields, $connection_fields );
|
||
};
|
