2011-08-10 17:11:11 +00:00
|
|
|
<?php
|
2014-09-20 19:44:32 +00:00
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
2015-12-11 14:11:12 +00:00
|
|
|
exit;
|
2014-09-20 19:44:32 +00:00
|
|
|
}
|
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
|
2015-12-11 14:11:12 +00:00
|
|
|
* @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
|
|
|
*/
|
2012-12-31 18:25:09 +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 */
|
2015-12-11 14:11:12 +00:00
|
|
|
public $min_amount = 0;
|
2015-02-03 16:03:28 +00:00
|
|
|
|
|
|
|
/** @var string Requires option */
|
2015-12-11 14:11:12 +00:00
|
|
|
public $requires = '';
|
2015-02-03 16:03:28 +00:00
|
|
|
|
2013-08-12 21:09:04 +00:00
|
|
|
/**
|
2015-12-11 14:11:12 +00:00
|
|
|
* Constructor.
|
2013-08-12 21:09:04 +00:00
|
|
|
*/
|
2015-12-11 14:11:12 +00:00
|
|
|
public function __construct( $instance_id = 0 ) {
|
|
|
|
$this->id = 'free_shipping';
|
|
|
|
$this->instance_id = absint( $instance_id );
|
|
|
|
$this->method_title = __( 'Free Shipping', 'woocommerce' );
|
2015-12-11 16:41:38 +00:00
|
|
|
$this->method_description = __( 'Free Shipping is a special method which can be triggered with coupons and minimum spends.', 'woocommerce' );
|
2015-12-11 14:11:12 +00:00
|
|
|
$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',
|
2015-12-11 14:11:12 +00:00
|
|
|
);
|
|
|
|
$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
|
|
|
}
|
|
|
|
|
2013-08-12 21:09:04 +00:00
|
|
|
/**
|
2015-12-11 14:11:12 +00:00
|
|
|
* Get setting form fields for instances of this shipping method within zones.
|
|
|
|
* @return array
|
2013-08-12 21:09:04 +00:00
|
|
|
*/
|
2015-12-11 14:11:12 +00:00
|
|
|
public function get_instance_form_fields() {
|
|
|
|
return array(
|
2011-11-28 15:50:19 +00:00
|
|
|
'title' => array(
|
2015-12-11 14:11:12 +00:00
|
|
|
'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' ),
|
2015-12-11 14:11:12 +00:00
|
|
|
'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' ),
|
2016-02-08 11:44:08 +00:00
|
|
|
'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
|
|
|
|
)
|
|
|
|
);
|
2016-02-08 11:44:08 +00:00
|
|
|
|
|
|
|
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();
|
|
|
|
});
|
|
|
|
" );
|
2013-08-12 21:09:04 +00:00
|
|
|
}
|
2011-11-28 15:50:19 +00:00
|
|
|
|
2013-08-12 21:09:04 +00:00
|
|
|
/**
|
2015-12-11 14:11:12 +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
|
2013-08-12 21:09:04 +00:00
|
|
|
* @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-01-06 11:36:19 +00:00
|
|
|
|
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() ) {
|
2013-10-18 17:10:55 +00:00
|
|
|
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;
|
2015-12-11 14:11:12 +00:00
|
|
|
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
|
|
|
|
2014-09-20 19:44:32 +00:00
|
|
|
if ( in_array( $this->requires, array( 'min_amount', 'either', 'both' ) ) && isset( WC()->cart->cart_contents_total ) ) {
|
2016-04-18 10:39:00 +00:00
|
|
|
$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 ) {
|
2013-10-15 16:19:30 +00:00
|
|
|
$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' :
|
2015-12-11 14:11:12 +00:00
|
|
|
$is_available = $has_met_min_amount;
|
2012-11-28 19:54:04 +00:00
|
|
|
break;
|
|
|
|
case 'coupon' :
|
2015-12-11 14:11:12 +00:00
|
|
|
$is_available = $has_coupon;
|
2012-11-28 19:54:04 +00:00
|
|
|
break;
|
|
|
|
case 'both' :
|
2015-12-11 14:11:12 +00:00
|
|
|
$is_available = $has_met_min_amount && $has_coupon;
|
2012-11-28 19:54:04 +00:00
|
|
|
break;
|
|
|
|
case 'either' :
|
2015-12-11 14:11:12 +00:00
|
|
|
$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
|
|
|
|
2014-05-06 08:34:25 +00:00
|
|
|
return apply_filters( 'woocommerce_shipping_' . $this->id . '_is_available', $is_available, $package );
|
2013-08-12 21:09:04 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2015-12-11 14:11:12 +00:00
|
|
|
* Called to calculate shipping rates for this method. Rates can be added using the add_rate() method.
|
|
|
|
* @uses WC_Shipping_Method::add_rate()
|
2013-08-12 21:09:04 +00:00
|
|
|
*/
|
2015-12-18 17:10:58 +00:00
|
|
|
public function calculate_shipping( $package = array() ) {
|
2015-12-11 14:11:12 +00:00
|
|
|
$this->add_rate( array(
|
2015-12-15 15:00:45 +00:00
|
|
|
'id' => $this->id . $this->instance_id,
|
2015-12-11 14:11:12 +00:00
|
|
|
'label' => $this->title,
|
|
|
|
'cost' => 0,
|
|
|
|
'taxes' => false
|
|
|
|
) );
|
2013-08-12 21:09:04 +00:00
|
|
|
}
|
2014-09-20 19:44:32 +00:00
|
|
|
}
|