| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221 |
- <?php
- /**
- * Class WC_Shipping_Free_Shipping file.
- *
- * @package WooCommerce\Shipping
- */
- if ( ! defined( 'ABSPATH' ) ) {
- exit;
- }
- /**
- * Free Shipping Method.
- *
- * A simple shipping method for free shipping.
- *
- * @class WC_Shipping_Free_Shipping
- * @version 2.6.0
- * @package WooCommerce/Classes/Shipping
- */
- class WC_Shipping_Free_Shipping extends WC_Shipping_Method {
- /**
- * Min amount to be valid.
- *
- * @var integer
- */
- public $min_amount = 0;
- /**
- * Requires option.
- *
- * @var string
- */
- public $requires = '';
- /**
- * Constructor.
- *
- * @param int $instance_id Shipping method instance.
- */
- 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(
- 'shipping-zones',
- 'instance-settings',
- 'instance-settings-modal',
- );
- $this->init();
- }
- /**
- * Initialize free shipping.
- */
- public function init() {
- // Load the settings.
- $this->init_form_fields();
- $this->init_settings();
- // Define user set variables.
- $this->title = $this->get_option( 'title' );
- $this->min_amount = $this->get_option( 'min_amount', 0 );
- $this->requires = $this->get_option( 'requires' );
- // Actions.
- add_action( 'woocommerce_update_options_shipping_' . $this->id, array( $this, 'process_admin_options' ) );
- }
- /**
- * Init form fields.
- */
- public function init_form_fields() {
- $this->instance_form_fields = array(
- 'title' => array(
- 'title' => __( 'Title', 'woocommerce' ),
- 'type' => 'text',
- 'description' => __( 'This controls the title which the user sees during checkout.', 'woocommerce' ),
- 'default' => $this->method_title,
- 'desc_tip' => true,
- ),
- 'requires' => array(
- 'title' => __( 'Free shipping requires...', 'woocommerce' ),
- 'type' => 'select',
- 'class' => 'wc-enhanced-select',
- 'default' => '',
- 'options' => array(
- '' => __( 'N/A', 'woocommerce' ),
- 'coupon' => __( 'A valid free shipping coupon', 'woocommerce' ),
- 'min_amount' => __( 'A minimum order amount', 'woocommerce' ),
- 'either' => __( 'A minimum order amount OR a coupon', 'woocommerce' ),
- 'both' => __( 'A minimum order amount AND a coupon', 'woocommerce' ),
- ),
- ),
- 'min_amount' => array(
- '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,
- ),
- );
- }
- /**
- * Get setting form fields for instances of this shipping method within zones.
- *
- * @return array
- */
- public function get_instance_form_fields() {
- if ( is_admin() ) {
- wc_enqueue_js(
- "jQuery( function( $ ) {
- function wcFreeShippingShowHideMinAmountField( el ) {
- var form = $( el ).closest( 'form' );
- var minAmountField = $( '#woocommerce_free_shipping_min_amount', form ).closest( 'tr' );
- if ( 'coupon' === $( el ).val() || '' === $( el ).val() ) {
- minAmountField.hide();
- } else {
- minAmountField.show();
- }
- }
- $( document.body ).on( 'change', '#woocommerce_free_shipping_requires', function() {
- wcFreeShippingShowHideMinAmountField( this );
- });
- // Change while load.
- $( '#woocommerce_free_shipping_requires' ).change();
- $( document.body ).on( 'wc_backbone_modal_loaded', function( evt, target ) {
- if ( 'wc-modal-shipping-method-settings' === target ) {
- wcFreeShippingShowHideMinAmountField( $( '#wc-backbone-modal-dialog #woocommerce_free_shipping_requires', evt.currentTarget ) );
- }
- } );
- });"
- );
- }
- return parent::get_instance_form_fields();
- }
- /**
- * See if free shipping is available based on the package and cart.
- *
- * @param array $package Shipping package.
- * @return bool
- */
- public function is_available( $package ) {
- $has_coupon = false;
- $has_met_min_amount = false;
- if ( in_array( $this->requires, array( 'coupon', 'either', 'both' ), true ) ) {
- $coupons = WC()->cart->get_coupons();
- if ( $coupons ) {
- foreach ( $coupons as $code => $coupon ) {
- if ( $coupon->is_valid() && $coupon->get_free_shipping() ) {
- $has_coupon = true;
- break;
- }
- }
- }
- }
- if ( in_array( $this->requires, array( 'min_amount', 'either', 'both' ), true ) ) {
- $total = WC()->cart->get_displayed_subtotal();
- if ( WC()->cart->display_prices_including_tax() ) {
- $total = round( $total - ( WC()->cart->get_discount_total() + WC()->cart->get_discount_tax() ), wc_get_price_decimals() );
- } else {
- $total = round( $total - WC()->cart->get_discount_total(), wc_get_price_decimals() );
- }
- if ( $total >= $this->min_amount ) {
- $has_met_min_amount = true;
- }
- }
- switch ( $this->requires ) {
- case 'min_amount':
- $is_available = $has_met_min_amount;
- break;
- case 'coupon':
- $is_available = $has_coupon;
- break;
- case 'both':
- $is_available = $has_met_min_amount && $has_coupon;
- break;
- case 'either':
- $is_available = $has_met_min_amount || $has_coupon;
- break;
- default:
- $is_available = true;
- break;
- }
- return apply_filters( 'woocommerce_shipping_' . $this->id . '_is_available', $is_available, $package, $this );
- }
- /**
- * Called to calculate shipping rates for this method. Rates can be added using the add_rate() method.
- *
- * @uses WC_Shipping_Method::add_rate()
- *
- * @param array $package Shipping package.
- */
- public function calculate_shipping( $package = array() ) {
- $this->add_rate(
- array(
- 'label' => $this->title,
- 'cost' => 0,
- 'taxes' => false,
- 'package' => $package,
- )
- );
- }
- }
|