woocommerce/includes/shipping/free-shipping/class-wc-shipping-free-ship...

156 lines
4.6 KiB
PHP
Raw Normal View History

2011-08-10 17:11:11 +00:00
<?php
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
2013-02-20 17:14:46 +00:00
2011-08-10 17:11:11 +00:00
/**
2015-11-03 13:31:20 +00:00
* Free Shipping Method.
2012-08-14 22:43:48 +00:00
*
2015-11-03 13:31:20 +00:00
* A simple shipping method for free shipping.
2011-08-10 17:11:11 +00:00
*
2014-11-20 00:43:09 +00:00
* @class WC_Shipping_Free_Shipping
* @version 2.6.0
2014-11-20 00:43:09 +00:00
* @package WooCommerce/Classes/Shipping
* @author WooThemes
2012-08-14 22:43:48 +00:00
*/
class WC_Shipping_Free_Shipping extends WC_Shipping_Method {
2012-08-14 22:43:48 +00:00
2015-02-03 16:03:28 +00:00
/** @var float Min amount to be valid */
public $min_amount = 0;
2015-02-03 16:03:28 +00:00
/** @var string Requires option */
public $requires = '';
2015-02-03 16:03:28 +00:00
/**
* Constructor.
*/
public function __construct( $instance_id = 0 ) {
$this->id = 'free_shipping';
$this->instance_id = absint( $instance_id );
$this->method_title = __( 'Free Shipping', 'woocommerce' );
$this->method_description = __( 'Free Shipping is a special method which can be triggered with coupons and minimum spends.', 'woocommerce' );
$this->supports = array(
2015-12-14 16:56:39 +00:00
'shipping-zones',
2016-03-24 18:31:39 +00:00
'instance-settings',
'instance-settings-modal',
);
$this->title = $this->get_option( 'title' );
$this->min_amount = $this->get_option( 'min_amount', 0 );
$this->requires = $this->get_option( 'requires' );
2015-12-14 16:56:39 +00:00
2015-12-16 13:52:46 +00:00
add_action( 'woocommerce_update_options_shipping_' . $this->id, array( $this, 'process_admin_options' ) );
2015-12-14 16:56:39 +00:00
}
/**
* Get setting form fields for instances of this shipping method within zones.
* @return array
*/
public function get_instance_form_fields() {
return array(
2011-11-28 15:50:19 +00:00
'title' => array(
'title' => __( 'Title', 'woocommerce' ),
2014-11-20 00:43:09 +00:00
'type' => 'text',
'description' => __( 'This controls the title which the user sees during checkout.', 'woocommerce' ),
'default' => $this->method_title,
2014-11-20 00:43:09 +00:00
'desc_tip' => true,
),
2012-11-28 19:54:04 +00:00
'requires' => array(
2014-11-20 00:43:09 +00:00
'title' => __( 'Free Shipping Requires...', 'woocommerce' ),
'type' => 'select',
2015-01-12 17:45:47 +00:00
'class' => 'wc-enhanced-select',
2014-11-20 00:43:09 +00:00
'default' => '',
'options' => array(
'' => __( 'N/A', 'woocommerce' ),
'coupon' => __( 'A valid free shipping coupon', 'woocommerce' ),
'min_amount' => __( 'A minimum order amount', 'woocommerce' ),
2014-11-20 00:43:09 +00:00
'either' => __( 'A minimum order amount OR a coupon', 'woocommerce' ),
'both' => __( 'A minimum order amount AND a coupon', 'woocommerce' ),
)
),
2012-11-28 19:54:04 +00:00
'min_amount' => array(
2014-11-20 00:43:09 +00:00
'title' => __( 'Minimum Order Amount', 'woocommerce' ),
'type' => 'price',
'placeholder' => wc_format_localized_price( 0 ),
'description' => __( 'Users will need to spend this amount to get free shipping (if enabled above).', 'woocommerce' ),
'default' => '0',
'desc_tip' => true
)
);
wc_enqueue_js( "
jQuery( function( $ ) {
$('#woocommerce_free_shipping_requires').change(function(){
if ( $(this).val() === 'coupon' || $(this).val() === '' ) {
$('#woocommerce_free_shipping_min_amount').closest('tr').hide();
} else {
$('#woocommerce_free_shipping_min_amount').closest('tr').show();
}
}).change();
});
" );
}
2011-11-28 15:50:19 +00:00
/**
* See if free shipping is available based on the package and cart.
2015-05-15 13:16:44 +00:00
* @param array $package
* @return bool
*/
2015-05-15 13:16:44 +00:00
public function is_available( $package ) {
2014-11-20 00:43:09 +00:00
$is_available = false;
$has_coupon = false;
2012-11-28 19:54:04 +00:00
$has_met_min_amount = false;
2012-11-28 19:54:04 +00:00
if ( in_array( $this->requires, array( 'coupon', 'either', 'both' ) ) ) {
2013-11-25 14:01:32 +00:00
if ( $coupons = WC()->cart->get_coupons() ) {
foreach ( $coupons as $code => $coupon ) {
2014-11-20 00:43:09 +00:00
if ( $coupon->is_valid() && $coupon->enable_free_shipping() ) {
2012-11-28 19:54:04 +00:00
$has_coupon = true;
break;
2014-11-20 00:43:09 +00:00
}
2012-05-03 13:00:45 +00:00
}
}
2012-11-28 19:54:04 +00:00
}
2012-08-14 22:43:48 +00:00
if ( in_array( $this->requires, array( 'min_amount', 'either', 'both' ) ) && isset( WC()->cart->cart_contents_total ) ) {
$total = WC()->cart->get_displayed_subtotal();
2012-08-14 22:43:48 +00:00
2014-11-20 00:43:09 +00:00
if ( $total >= $this->min_amount ) {
$has_met_min_amount = true;
2014-11-20 00:43:09 +00:00
}
2012-11-28 19:54:04 +00:00
}
2012-08-14 22:43:48 +00:00
2012-11-28 19:54:04 +00:00
switch ( $this->requires ) {
case 'min_amount' :
$is_available = $has_met_min_amount;
2012-11-28 19:54:04 +00:00
break;
case 'coupon' :
$is_available = $has_coupon;
2012-11-28 19:54:04 +00:00
break;
case 'both' :
$is_available = $has_met_min_amount && $has_coupon;
2012-11-28 19:54:04 +00:00
break;
case 'either' :
$is_available = $has_met_min_amount || $has_coupon;
2012-11-28 19:54:04 +00:00
break;
default :
2012-05-03 13:00:45 +00:00
$is_available = true;
2012-11-28 19:54:04 +00:00
break;
2012-05-03 13:00:45 +00:00
}
2012-08-14 22:43:48 +00:00
return apply_filters( 'woocommerce_shipping_' . $this->id . '_is_available', $is_available, $package );
}
/**
* Called to calculate shipping rates for this method. Rates can be added using the add_rate() method.
* @uses WC_Shipping_Method::add_rate()
*/
2015-12-18 17:10:58 +00:00
public function calculate_shipping( $package = array() ) {
$this->add_rate( array(
2015-12-15 15:00:45 +00:00
'id' => $this->id . $this->instance_id,
'label' => $this->title,
'cost' => 0,
'taxes' => false
) );
}
}