Automattic\WooCommerce\Internal\Admin\Settings\PaymentsProviders

WCCore{} │ WC 1.0└─ PaymentGateway

WooCommerce core payment gateways provider class.

This class handles all the custom logic for the payment gateways built into the WC core.

Хуков нет.

Использование

$WCCore = new WCCore();
// use class methods

Методы

1. public get_icon( WC_Payment_Gateway $payment_gateway )
2. public get_plugin_details( WC_Payment_Gateway $payment_gateway )
3. public is_account_connected( WC_Payment_Gateway $payment_gateway )
4. public is_in_test_mode_onboarding( WC_Payment_Gateway $payment_gateway )

Код WCCore{} WCCore{} ^{WC 10.4.0}

class WCCore extends PaymentGateway {

	/**
	 * Get the provider icon URL of the payment gateway.
	 *
	 * @param WC_Payment_Gateway $payment_gateway The payment gateway object.
	 *
	 * @return string The provider icon URL of the payment gateway.
	 */
	public function get_icon( WC_Payment_Gateway $payment_gateway ): string {
		// Provide custom icons for core payment gateways.
		switch ( $payment_gateway->id ) {
			case WC_Gateway_BACS::ID:
				return plugins_url( 'assets/images/payment_methods/bacs.svg', WC_PLUGIN_FILE );
			case WC_Gateway_Cheque::ID:
				return plugins_url( 'assets/images/payment_methods/cheque.svg', WC_PLUGIN_FILE );
			case WC_Gateway_COD::ID:
				return plugins_url( 'assets/images/payment_methods/cod.svg', WC_PLUGIN_FILE );
			case WC_Gateway_Paypal::ID:
				return plugins_url( 'assets/images/payment_methods/72x72/paypal.png', WC_PLUGIN_FILE );
		}

		return parent::get_icon( $payment_gateway );
	}

	/**
	 * Check if the payment gateway has a payments processor account connected.
	 *
	 * @param WC_Payment_Gateway $payment_gateway The payment gateway object.
	 *
	 * @return bool True if the payment gateway account is connected, false otherwise.
	 *              If the payment gateway does not provide the information, it will return true.
	 */
	public function is_account_connected( WC_Payment_Gateway $payment_gateway ): bool {
		// Provide custom account connected logic for core payment gateways.
		switch ( $payment_gateway->id ) {
			case WC_Gateway_BACS::ID:
				// BACS requires bank account details to be set up.
				return property_exists( $payment_gateway, 'account_details' ) && ! empty( $payment_gateway->account_details );
			case WC_Gateway_Cheque::ID:
			case WC_Gateway_COD::ID:
				// There is no account setup for these gateways, so we return true.
				return true;
			case WC_Gateway_Paypal::ID:
				// PayPal requires just an account email address to be set up.
				return property_exists( $payment_gateway, 'email' ) && is_email( $payment_gateway->email );
		}

		return parent::is_account_connected( $payment_gateway );
	}

	/**
	 * Try to determine if the payment gateway is in test mode onboarding (aka sandbox or test-drive).
	 *
	 * This is a best-effort attempt, as there is no standard way to determine this.
	 * Trust the true value, but don't consider a false value as definitive.
	 *
	 * @param WC_Payment_Gateway $payment_gateway The payment gateway object.
	 *
	 * @return bool True if the payment gateway is in test mode onboarding, false otherwise.
	 */
	public function is_in_test_mode_onboarding( WC_Payment_Gateway $payment_gateway ): bool {
		// Provide custom test mode onboarding logic for core payment gateways.
		switch ( $payment_gateway->id ) {
			case WC_Gateway_BACS::ID:
			case WC_Gateway_Cheque::ID:
			case WC_Gateway_COD::ID:
				return false; // These gateways do not have a test mode onboarding.
			case WC_Gateway_Paypal::ID:
				// Test mode is actually sandbox mode for PayPal, affecting the API keys used.
				return $this->is_in_test_mode( $payment_gateway );
		}

		return parent::is_in_test_mode_onboarding( $payment_gateway );
	}

	/**
	 * Get the plugin details for a WC core-provided payment gateway.
	 *
	 * @param WC_Payment_Gateway $payment_gateway The payment gateway object.
	 *
	 * @return array The plugin details for the payment gateway.
	 */
	public function get_plugin_details( WC_Payment_Gateway $payment_gateway ): array {
		$plugin_details = parent::get_plugin_details( $payment_gateway );

		// Since these are core-provided gateways, we need to make sure that the provider (WC) can't be deactivated.
		// The way to do this is to NOT provide a plugin file path.
		$plugin_details['file'] = '';

		return $plugin_details;
	}
}