woocommerce/includes/class-wc-payment-gateways.php

220 lines
5.1 KiB
PHP
Raw Normal View History

2011-08-09 15:16:18 +00:00
<?php
/**
* WooCommerce Payment Gateways
2012-08-15 18:15:06 +00:00
*
2011-08-10 17:11:11 +00:00
* Loads payment gateways via hooks for use in the store.
*
* @version 2.2.0
* @package WooCommerce/Classes/Payment
*/
defined( 'ABSPATH' ) || exit;
/**
* Payment gateways class.
2011-08-10 17:11:11 +00:00
*/
2012-01-27 16:38:39 +00:00
class WC_Payment_Gateways {
2012-08-15 18:15:06 +00:00
/**
* Payment gateway classes.
*
* @var array
*/
public $payment_gateways = array();
2012-08-15 18:15:06 +00:00
/**
* The single instance of the class.
*
* @var WC_Payment_Gateways
* @since 2.1.0
*/
protected static $_instance = null;
/**
2015-11-03 13:31:20 +00:00
* Main WC_Payment_Gateways Instance.
*
2014-06-19 19:43:05 +00:00
* Ensures only one instance of WC_Payment_Gateways is loaded or can be loaded.
*
* @since 2.1
2014-06-19 19:43:05 +00:00
* @return WC_Payment_Gateways Main instance
*/
public static function instance() {
if ( is_null( self::$_instance ) ) {
self::$_instance = new self();
}
return self::$_instance;
}
/**
* Cloning is forbidden.
*
* @since 2.1
*/
public function __clone() {
wc_doing_it_wrong( __FUNCTION__, __( 'Cloning is forbidden.', 'woocommerce' ), '2.1' );
}
/**
* Unserializing instances of this class is forbidden.
*
* @since 2.1
*/
public function __wakeup() {
wc_doing_it_wrong( __FUNCTION__, __( 'Unserializing instances of this class is forbidden.', 'woocommerce' ), '2.1' );
}
/**
2015-07-16 19:55:48 +00:00
* Initialize payment gateways.
*/
public function __construct() {
$this->init();
}
2014-09-02 14:11:21 +00:00
/**
* Load gateways and hook in functions.
*/
public function init() {
$load_gateways = array(
'WC_Gateway_BACS',
'WC_Gateway_Cheque',
'WC_Gateway_COD',
'WC_Gateway_Paypal',
2014-09-02 14:11:21 +00:00
);
// Filter.
2014-09-02 14:11:21 +00:00
$load_gateways = apply_filters( 'woocommerce_payment_gateways', $load_gateways );
// Get sort order option.
$ordering = (array) get_option( 'woocommerce_gateway_order' );
$order_end = 999;
2012-08-15 18:15:06 +00:00
// Load gateways in order.
foreach ( $load_gateways as $gateway ) {
if ( is_string( $gateway ) && class_exists( $gateway ) ) {
$gateway = new $gateway();
}
// Gateways need to be valid and extend WC_Payment_Gateway.
if ( ! is_a( $gateway, 'WC_Payment_Gateway' ) ) {
continue;
}
2012-08-15 18:15:06 +00:00
if ( isset( $ordering[ $gateway->id ] ) && is_numeric( $ordering[ $gateway->id ] ) ) {
2018-03-22 15:06:36 +00:00
// Add in position.
$this->payment_gateways[ $ordering[ $gateway->id ] ] = $gateway;
} else {
// Add to end of the array.
$this->payment_gateways[ $order_end ] = $gateway;
2011-12-06 16:45:08 +00:00
$order_end++;
}
}
2012-08-15 18:15:06 +00:00
ksort( $this->payment_gateways );
2014-09-02 14:11:21 +00:00
}
/**
* Get gateways.
*
2014-09-02 14:11:21 +00:00
* @return array
*/
public function payment_gateways() {
2011-08-09 15:16:18 +00:00
$_available_gateways = array();
2012-08-15 18:15:06 +00:00
if ( count( $this->payment_gateways ) > 0 ) {
foreach ( $this->payment_gateways as $gateway ) {
$_available_gateways[ $gateway->id ] = $gateway;
}
}
2011-08-09 15:16:18 +00:00
return $_available_gateways;
}
2012-08-15 18:15:06 +00:00
2016-05-26 14:46:14 +00:00
/**
* Get array of registered gateway ids
*
2016-05-26 14:46:14 +00:00
* @since 2.6.0
* @return array of strings
*/
public function get_payment_gateway_ids() {
return wp_list_pluck( $this->payment_gateways, 'id' );
}
2012-08-15 18:15:06 +00:00
/**
* Get available gateways.
*
* @return array
*/
public function get_available_payment_gateways() {
2011-08-09 15:16:18 +00:00
$_available_gateways = array();
2012-08-15 18:15:06 +00:00
foreach ( $this->payment_gateways as $gateway ) {
if ( $gateway->is_available() ) {
if ( ! is_add_payment_method_page() ) {
$_available_gateways[ $gateway->id ] = $gateway;
2017-08-07 11:39:16 +00:00
} elseif ( $gateway->supports( 'add_payment_method' ) || $gateway->supports( 'tokenization' ) ) {
$_available_gateways[ $gateway->id ] = $gateway;
}
}
}
2011-08-09 15:16:18 +00:00
return array_filter( (array) apply_filters( 'woocommerce_available_payment_gateways', $_available_gateways ), array( $this, 'filter_valid_gateway_class' ) );
}
/**
* Callback for array filter. Returns true if gateway is of correct type.
*
* @since 3.6.0
* @param object $gateway Gateway to check.
* @return bool
*/
protected function filter_valid_gateway_class( $gateway ) {
return $gateway && is_a( $gateway, 'WC_Payment_Gateway' );
2011-08-09 15:16:18 +00:00
}
2012-08-15 18:15:06 +00:00
/**
2015-11-03 13:31:20 +00:00
* Set the current, active gateway.
*
* @param array $gateways Available payment gateways.
*/
public function set_current_gateway( $gateways ) {
// Be on the defensive.
if ( ! is_array( $gateways ) || empty( $gateways ) ) {
return;
}
$current_gateway = false;
$current = WC()->session->get( 'chosen_payment_method' );
if ( $current && isset( $gateways[ $current ] ) ) {
$current_gateway = $gateways[ $current ];
}
if ( ! $current_gateway ) {
$current_gateway = current( $gateways );
}
// Ensure we can make a call to set_current() without triggering an error.
if ( $current_gateway && is_callable( array( $current_gateway, 'set_current' ) ) ) {
$current_gateway->set_current();
}
}
2012-08-15 18:15:06 +00:00
/**
* Save options in admin.
*/
public function process_admin_options() {
$gateway_order = isset( $_POST['gateway_order'] ) ? wc_clean( wp_unslash( $_POST['gateway_order'] ) ) : ''; // WPCS: input var ok, CSRF ok.
$order = array();
2012-08-15 18:15:06 +00:00
if ( is_array( $gateway_order ) && count( $gateway_order ) > 0 ) {
2011-12-06 16:45:08 +00:00
$loop = 0;
2012-10-17 12:46:35 +00:00
foreach ( $gateway_order as $gateway_id ) {
$order[ esc_attr( $gateway_id ) ] = $loop;
2011-12-06 16:45:08 +00:00
$loop++;
2012-10-17 12:46:35 +00:00
}
}
2012-08-15 18:15:06 +00:00
2011-12-06 16:45:08 +00:00
update_option( 'woocommerce_gateway_order', $order );
}
}