woocommerce/includes/class-wc-tax.php

865 lines
24 KiB
PHP
Raw Normal View History

2011-08-09 15:16:18 +00:00
<?php
/**
* Performs tax calculations and loads tax rates.
2011-08-09 15:16:18 +00:00
*
2012-01-27 16:38:39 +00:00
* @class WC_Tax
* @version 2.2.0
2012-08-14 22:43:48 +00:00
* @package WooCommerce/Classes
2013-02-20 17:14:46 +00:00
* @category Class
2012-08-14 20:19:41 +00:00
* @author WooThemes
2011-08-09 15:16:18 +00:00
*/
2012-01-27 16:38:39 +00:00
class WC_Tax {
2012-08-08 10:42:42 +00:00
public static $precision;
public static $round_at_subtotal;
2014-09-20 19:02:51 +00:00
2012-12-13 01:23:35 +00:00
/**
* Load options
2012-12-13 01:23:35 +00:00
*
* @access public
*/
public static function init() {
self::$precision = WC_ROUNDING_PRECISION;
self::$round_at_subtotal = 'yes' === get_option( 'woocommerce_tax_round_at_subtotal' );
2012-12-13 01:23:35 +00:00
}
/**
2013-10-24 15:16:39 +00:00
* Calculate tax for a line
* @param float $price Price to calc tax on
* @param array $rates Rates to apply
* @param boolean $price_includes_tax Whether the passed price has taxes included
* @param boolean $suppress_rounding Whether to suppress any rounding from taking place
2013-10-24 15:16:39 +00:00
* @return array Array of rates + prices after tax
*/
public static function calc_tax( $price, $rates, $price_includes_tax = false, $suppress_rounding = false ) {
// Work in pence to X precision
2014-06-13 14:53:59 +00:00
$price = self::precision( $price );
2014-11-29 11:33:36 +00:00
if ( $price_includes_tax ) {
$taxes = self::calc_inclusive_tax( $price, $rates );
2014-11-29 11:33:36 +00:00
} else {
$taxes = self::calc_exclusive_tax( $price, $rates );
2014-11-29 11:33:36 +00:00
}
2013-10-24 13:53:01 +00:00
// Round to precision
if ( ! self::$round_at_subtotal && ! $suppress_rounding ) {
$taxes = array_map( 'round', $taxes ); // Round to precision
}
// Remove precision
$price = self::remove_precision( $price );
2014-06-13 14:53:59 +00:00
$taxes = array_map( array( __CLASS__, 'remove_precision' ), $taxes );
2013-10-24 15:16:39 +00:00
return apply_filters( 'woocommerce_calc_tax', $taxes, $price, $rates, $price_includes_tax, $suppress_rounding );
}
2013-10-24 15:16:39 +00:00
/**
* Calculate the shipping tax using a passed array of rates.
*
* @param float Price
* @param array Taxation Rate
* @return array
*/
public static function calc_shipping_tax( $price, $rates ) {
return self::calc_exclusive_tax( $price, $rates );
}
2013-10-24 15:16:39 +00:00
/**
* Multiply cost by pow precision
* @param float $price
* @return float
*/
private static function precision( $price ) {
return $price * ( pow( 10, self::$precision ) );
}
2013-10-24 15:16:39 +00:00
/**
* Divide cost by pow precision
* @param float $price
* @return float
*/
private static function remove_precision( $price ) {
return $price / ( pow( 10, self::$precision ) );
}
/**
* Round to precision.
*
* Filter example: to return rounding to .5 cents you'd use:
*
* public function euro_5cent_rounding( $in ) {
* return round( $in / 5, 2 ) * 5;
* }
* add_filter( 'woocommerce_tax_round', 'euro_5cent_rounding' );
*/
public static function round( $in ) {
return apply_filters( 'woocommerce_tax_round', round( $in, self::$precision ), $in );
}
2013-10-24 15:16:39 +00:00
/**
* Calc tax from inclusive price
*
* @param float $price
* @param array $rates
* @return array
*/
private static function calc_inclusive_tax( $price, $rates ) {
$taxes = array();
$regular_tax_rates = $compound_tax_rates = 0;
foreach ( $rates as $key => $rate )
if ( $rate['compound'] == 'yes' )
$compound_tax_rates = $compound_tax_rates + $rate['rate'];
else
$regular_tax_rates = $regular_tax_rates + $rate['rate'];
$regular_tax_rate = 1 + ( $regular_tax_rates / 100 );
$compound_tax_rate = 1 + ( $compound_tax_rates / 100 );
$non_compound_price = $price / $compound_tax_rate;
foreach ( $rates as $key => $rate ) {
if ( ! isset( $taxes[ $key ] ) )
$taxes[ $key ] = 0;
$the_rate = $rate['rate'] / 100;
if ( $rate['compound'] == 'yes' ) {
$the_price = $price;
$the_rate = $the_rate / $compound_tax_rate;
} else {
$the_price = $non_compound_price;
$the_rate = $the_rate / $regular_tax_rate;
}
$net_price = $price - ( $the_rate * $the_price );
$tax_amount = $price - $net_price;
$taxes[ $key ] += apply_filters( 'woocommerce_price_inc_tax_amount', $tax_amount, $key, $rate, $price );
}
return $taxes;
}
2013-10-24 15:16:39 +00:00
/**
* Calc tax from exclusive price
*
* @param float $price
* @param array $rates
* @return array
*/
private static function calc_exclusive_tax( $price, $rates ) {
$taxes = array();
2014-12-09 09:14:25 +00:00
if ( $rates ) {
// Multiple taxes
foreach ( $rates as $key => $rate ) {
2014-12-09 09:14:25 +00:00
if ( $rate['compound'] == 'yes' )
continue;
2014-12-09 09:14:25 +00:00
$tax_amount = $price * ( $rate['rate'] / 100 );
2014-12-09 09:14:25 +00:00
// ADVANCED: Allow third parties to modify this rate
$tax_amount = apply_filters( 'woocommerce_price_ex_tax_amount', $tax_amount, $key, $rate, $price );
2014-12-09 09:14:25 +00:00
// Add rate
if ( ! isset( $taxes[ $key ] ) )
$taxes[ $key ] = $tax_amount;
else
$taxes[ $key ] += $tax_amount;
}
2014-12-09 09:14:25 +00:00
$pre_compound_total = array_sum( $taxes );
2014-12-09 09:14:25 +00:00
// Compound taxes
foreach ( $rates as $key => $rate ) {
if ( $rate['compound'] == 'no' )
continue;
$the_price_inc_tax = $price + ( $pre_compound_total );
$tax_amount = $the_price_inc_tax * ( $rate['rate'] / 100 );
// ADVANCED: Allow third parties to modify this rate
$tax_amount = apply_filters( 'woocommerce_price_ex_tax_amount', $tax_amount, $key, $rate, $price, $the_price_inc_tax, $pre_compound_total );
// Add rate
if ( ! isset( $taxes[ $key ] ) )
$taxes[ $key ] = $tax_amount;
else
$taxes[ $key ] += $tax_amount;
}
}
return $taxes;
}
2011-08-09 15:16:18 +00:00
/**
2012-08-14 20:19:41 +00:00
* Searches for all matching country/state/postcode tax rates.
2012-11-27 16:22:47 +00:00
*
* @param array $args
2012-09-23 16:16:39 +00:00
* @return array
2011-08-09 15:16:18 +00:00
*/
public static function find_rates( $args = array() ) {
2014-11-21 12:05:44 +00:00
$args = wp_parse_args( $args, array(
'country' => '',
'state' => '',
'city' => '',
'postcode' => '',
'tax_class' => ''
) );
2012-08-08 10:42:42 +00:00
2012-09-23 16:16:39 +00:00
extract( $args, EXTR_SKIP );
2012-08-08 10:42:42 +00:00
if ( ! $country ) {
2012-09-23 16:16:39 +00:00
return array();
}
2011-08-09 15:16:18 +00:00
2014-11-21 12:05:44 +00:00
$valid_postcodes = self::_get_wildcard_postcodes( wc_clean( $postcode ) );
$rates_transient_key = 'wc_tax_rates_' . md5( sprintf( '%s+%s+%s+%s+%s', $country, $state, $city, implode( ',', $valid_postcodes), $tax_class ) );
$matched_tax_rates = get_transient( $rates_transient_key );
2012-11-27 16:22:47 +00:00
2014-11-21 12:05:44 +00:00
if ( false === $matched_tax_rates ) {
$matched_tax_rates = self::get_matched_tax_rates( $country, $state, $postcode, $city, $tax_class, $valid_postcodes );
set_transient( $rates_transient_key, $matched_tax_rates, WEEK_IN_SECONDS );
2012-09-23 16:16:39 +00:00
}
return apply_filters( 'woocommerce_find_rates', $matched_tax_rates, $args );
2014-11-21 12:05:44 +00:00
}
2014-11-21 13:06:30 +00:00
/**
* Searches for all matching country/state/postcode tax rates.
*
* @param array $args
* @return array
*/
public static function find_shipping_rates( $args = array() ) {
$rates = self::find_rates( $args );
$shipping_rates = array();
foreach ( $rates as $key => $rate ) {
if ( 'yes' === $rate['shipping'] ) {
$shipping_rates[ $key ] = $rate;
}
}
return $shipping_rates;
}
2014-11-21 12:05:44 +00:00
/**
* Loop through a set of tax rates and get the matching rates (1 per priority)
*
* @param string $country
* @param string $state
* @param string $postcode
* @param string $city
* @param string $tax_class
* @param array $valid_postcodes
* @return array
*/
private static function get_matched_tax_rates( $country, $state, $postcode, $city, $tax_class, $valid_postcodes ) {
global $wpdb;
2014-11-21 12:05:44 +00:00
$found_rates = $wpdb->get_results(
$wpdb->prepare( "
2014-09-20 19:02:51 +00:00
SELECT tax_rates.*
FROM {$wpdb->prefix}woocommerce_tax_rates as tax_rates
LEFT OUTER JOIN {$wpdb->prefix}woocommerce_tax_rate_locations as locations ON tax_rates.tax_rate_id = locations.tax_rate_id
LEFT OUTER JOIN {$wpdb->prefix}woocommerce_tax_rate_locations as locations2 ON tax_rates.tax_rate_id = locations2.tax_rate_id
2014-09-20 19:02:51 +00:00
WHERE tax_rate_country IN ( %s, '' )
AND tax_rate_state IN ( %s, '' )
AND tax_rate_class = %s
AND (
locations.location_type IS NULL
OR (
locations.location_type = 'postcode'
AND locations.location_code IN ('" . implode( "','", $valid_postcodes ) . "')
AND (
locations2.location_type = 'city' AND locations2.location_code = %s
OR 0 = (
SELECT COUNT(*) FROM {$wpdb->prefix}woocommerce_tax_rate_locations as sublocations
WHERE sublocations.location_type = 'city'
AND sublocations.tax_rate_id = tax_rates.tax_rate_id
)
)
)
OR (
locations.location_type = 'city'
AND locations.location_code = %s
AND 0 = (
SELECT COUNT(*) FROM {$wpdb->prefix}woocommerce_tax_rate_locations as sublocations
WHERE sublocations.location_type = 'postcode'
AND sublocations.tax_rate_id = tax_rates.tax_rate_id
)
)
)
GROUP BY tax_rate_id
ORDER BY tax_rate_priority, tax_rate_order
",
strtoupper( $country ),
strtoupper( $state ),
sanitize_title( $tax_class ),
strtoupper( $city ),
strtoupper( $city )
2014-11-21 12:05:44 +00:00
)
);
2014-09-20 19:02:51 +00:00
2014-11-21 12:05:44 +00:00
$matched_tax_rates = array();
$found_priority = array();
2014-11-21 12:05:44 +00:00
foreach ( $found_rates as $found_rate ) {
if ( in_array( $found_rate->tax_rate_priority, $found_priority ) ) {
continue;
}
2014-11-21 12:05:44 +00:00
$matched_tax_rates[ $found_rate->tax_rate_id ] = array(
'rate' => $found_rate->tax_rate,
'label' => $found_rate->tax_rate_name,
'shipping' => $found_rate->tax_rate_shipping ? 'yes' : 'no',
'compound' => $found_rate->tax_rate_compound ? 'yes' : 'no'
);
2014-11-21 12:05:44 +00:00
$found_priority[] = $found_rate->tax_rate_priority;
}
2014-11-21 12:05:44 +00:00
return apply_filters( 'woocommerce_matched_tax_rates', $matched_tax_rates, $country, $state, $postcode, $city, $tax_class );
2011-08-09 15:16:18 +00:00
}
2012-08-08 10:42:42 +00:00
2014-11-21 13:06:30 +00:00
/**
* Get the customer tax location based on their status and the current page
*
* Used by get_rates(), get_shipping_rates()
*
* @param $tax_class string Optional, passed to the filter for advanced tax setups.
2014-11-21 13:06:30 +00:00
* @return array
*/
public static function get_tax_location( $tax_class = '' ) {
$location = array();
if ( ! empty( WC()->customer ) ) {
$location = WC()->customer->get_taxable_address();
} elseif ( wc_prices_include_tax() || 'base' === get_option( 'woocommerce_default_customer_address' ) ) {
$location = array(
2014-11-21 13:06:30 +00:00
WC()->countries->get_base_country(),
WC()->countries->get_base_state(),
WC()->countries->get_base_postcode(),
WC()->countries->get_base_city()
);
}
return apply_filters( 'woocommerce_get_tax_location', $location, $tax_class );
2014-11-21 13:06:30 +00:00
}
2011-08-09 15:16:18 +00:00
/**
2012-08-14 20:19:41 +00:00
* Get's an array of matching rates for a tax class.
* @param string $tax_class
* @return array
2011-08-09 15:16:18 +00:00
*/
public static function get_rates( $tax_class = '' ) {
2014-11-21 13:06:30 +00:00
$tax_class = sanitize_title( $tax_class );
$location = self::get_tax_location( $tax_class );
2014-11-21 13:06:30 +00:00
$matched_tax_rates = array();
2012-11-27 16:22:47 +00:00
2014-11-21 13:06:30 +00:00
if ( sizeof( $location ) === 4 ) {
list( $country, $state, $postcode, $city ) = $location;
2012-08-08 10:42:42 +00:00
$matched_tax_rates = self::find_rates( array(
2012-11-27 16:22:47 +00:00
'country' => $country,
'state' => $state,
'postcode' => $postcode,
2012-09-23 16:16:39 +00:00
'city' => $city,
'tax_class' => $tax_class
) );
}
2011-08-09 15:16:18 +00:00
return apply_filters( 'woocommerce_matched_rates', $matched_tax_rates, $tax_class );
2011-08-09 15:16:18 +00:00
}
2012-08-08 10:42:42 +00:00
2011-08-09 15:16:18 +00:00
/**
2012-08-14 20:19:41 +00:00
* Get's an array of matching rates for the shop's base country.
2011-08-09 15:16:18 +00:00
*
* @param string Tax Class
* @return array
2011-08-09 15:16:18 +00:00
*/
public static function get_base_tax_rates( $tax_class = '' ) {
return apply_filters( 'woocommerce_base_tax_rates', self::find_rates( array(
'country' => WC()->countries->get_base_country(),
'state' => WC()->countries->get_base_state(),
'postcode' => WC()->countries->get_base_postcode(),
'city' => WC()->countries->get_base_city(),
2012-11-27 16:22:47 +00:00
'tax_class' => $tax_class
) ), $tax_class );
}
/**
* Alias for get_base_tax_rates()
*
* @deprecated 2.3
* @param string Tax Class
* @return array
*/
public static function get_shop_base_rate( $tax_class = '' ) {
return self::get_base_tax_rates( $tax_class );
2012-02-01 21:49:08 +00:00
}
2012-08-08 10:42:42 +00:00
2011-08-09 15:16:18 +00:00
/**
2012-08-14 20:19:41 +00:00
* Gets an array of matching shipping tax rates for a given class.
2011-08-09 15:16:18 +00:00
*
* @param string Tax Class
2012-08-08 10:42:42 +00:00
* @return mixed
2011-08-09 15:16:18 +00:00
*/
public static function get_shipping_tax_rates( $tax_class = null ) {
// See if we have an explicitly set shipping tax class
if ( $shipping_tax_class = get_option( 'woocommerce_shipping_tax_class' ) ) {
2014-11-21 13:06:30 +00:00
$tax_class = 'standard' === $shipping_tax_class ? '' : $shipping_tax_class;
}
2012-08-08 10:42:42 +00:00
$location = self::get_tax_location( $tax_class );
2014-11-21 13:06:30 +00:00
$matched_tax_rates = array();
2012-09-23 16:16:39 +00:00
2014-11-21 13:06:30 +00:00
if ( sizeof( $location ) === 4 ) {
list( $country, $state, $postcode, $city ) = $location;
2012-09-23 16:16:39 +00:00
2014-11-21 13:06:30 +00:00
if ( ! is_null( $tax_class ) ) {
// This will be per item shipping
$matched_tax_rates = self::find_shipping_rates( array(
2012-11-27 16:22:47 +00:00
'country' => $country,
'state' => $state,
'postcode' => $postcode,
2014-11-21 13:06:30 +00:00
'city' => $city,
'tax_class' => $tax_class
2012-09-23 16:16:39 +00:00
) );
2014-11-21 13:06:30 +00:00
} else {
2012-08-08 10:42:42 +00:00
2014-11-21 13:06:30 +00:00
// This will be per order shipping - loop through the order and find the highest tax class rate
$cart_tax_classes = WC()->cart->get_cart_item_tax_classes();
2012-08-08 10:42:42 +00:00
2014-11-21 13:06:30 +00:00
// If multiple classes are found, use highest. Don't bother with standard rate, we can get that later.
if ( sizeof( $cart_tax_classes ) > 1 && ! in_array( '', $cart_tax_classes ) ) {
$tax_classes = self::get_tax_classes();
2012-09-23 16:16:39 +00:00
foreach ( $tax_classes as $tax_class ) {
2014-11-21 13:06:30 +00:00
if ( in_array( $tax_class, $cart_tax_classes ) ) {
$matched_tax_rates = self::find_shipping_rates( array(
2012-11-27 16:22:47 +00:00
'country' => $country,
'state' => $state,
'postcode' => $postcode,
2012-09-23 16:16:39 +00:00
'city' => $city,
2012-11-27 16:22:47 +00:00
'tax_class' => $tax_class
2012-09-23 16:16:39 +00:00
) );
break;
2012-09-23 16:16:39 +00:00
}
}
2012-08-08 10:42:42 +00:00
2014-11-21 13:06:30 +00:00
// If a single tax class is found, use it
} elseif ( sizeof( $cart_tax_classes ) == 1 ) {
$matched_tax_rates = self::find_shipping_rates( array(
'country' => $country,
'state' => $state,
'postcode' => $postcode,
'city' => $city,
'tax_class' => $cart_tax_classes[0]
) );
}
2012-09-23 16:16:39 +00:00
}
2012-08-08 10:42:42 +00:00
2014-11-21 13:06:30 +00:00
// Get standard rate if no taxes were found
if ( ! sizeof( $matched_tax_rates ) ) {
$matched_tax_rates = self::find_shipping_rates( array(
2012-11-27 16:22:47 +00:00
'country' => $country,
'state' => $state,
'postcode' => $postcode,
2014-11-21 13:06:30 +00:00
'city' => $city
2012-09-23 16:16:39 +00:00
) );
2014-11-21 13:06:30 +00:00
}
2012-09-23 16:16:39 +00:00
}
2014-11-21 13:06:30 +00:00
return $matched_tax_rates;
2011-08-09 15:16:18 +00:00
}
2012-08-08 10:42:42 +00:00
2011-12-30 19:36:44 +00:00
/**
2012-08-14 20:19:41 +00:00
* Return true/false depending on if a rate is a compound rate.
2011-12-30 21:11:18 +00:00
*
* @param int key
2012-08-08 10:42:42 +00:00
* @return bool
2011-12-30 19:36:44 +00:00
*/
public static function is_compound( $key ) {
2012-12-03 12:18:34 +00:00
global $wpdb;
return $wpdb->get_var( $wpdb->prepare( "SELECT tax_rate_compound FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %s", $key ) ) ? true : false;
2011-12-30 19:36:44 +00:00
}
2011-12-30 21:11:18 +00:00
2011-12-30 19:36:44 +00:00
/**
2012-08-14 20:19:41 +00:00
* Return a given rates label.
2011-12-30 21:11:18 +00:00
*
* @param mixed $key_or_rate Tax rate ID, or the db row itself in object format
2012-08-08 10:42:42 +00:00
* @return string
2011-12-30 19:36:44 +00:00
*/
public static function get_rate_label( $key_or_rate ) {
2013-11-18 12:30:28 +00:00
global $wpdb;
if ( is_object( $key_or_rate ) ) {
$key = $key_or_rate->tax_rate_id;
$rate_name = $key_or_rate->tax_rate_name;
} else {
$key = $key_or_rate;
$rate_name = $wpdb->get_var( $wpdb->prepare( "SELECT tax_rate_name FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %s", $key ) );
}
if ( ! $rate_name ) {
2013-11-18 12:30:28 +00:00
$rate_name = WC()->countries->tax_or_vat();
}
2014-06-13 14:53:59 +00:00
return apply_filters( 'woocommerce_rate_label', $rate_name, $key );
2011-12-30 19:36:44 +00:00
}
2012-08-08 10:42:42 +00:00
2014-07-10 10:01:00 +00:00
/**
* Return a given rates percent.
*
* @param mixed $key_or_rate Tax rate ID, or the db row itself in object format
2014-07-10 10:01:00 +00:00
* @return string
*/
public static function get_rate_percent( $key_or_rate ) {
2014-07-10 10:01:00 +00:00
global $wpdb;
if ( is_object( $key_or_rate ) ) {
$key = $key_or_rate->tax_rate_id;
$tax_rate = $key_or_rate->tax_rate;
} else {
$key = $key_or_rate;
$tax_rate = $wpdb->get_var( $wpdb->prepare( "SELECT tax_rate FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %s", $key ) );
}
2014-07-10 10:01:00 +00:00
return apply_filters( 'woocommerce_rate_percent', floatval( $tax_rate ) . '%', $key );
}
/**
* Get a rates code. Code is made up of COUNTRY-STATE-NAME-Priority. E.g GB-VAT-1, US-AL-TAX-1
*
* @access public
* @param mixed $key_or_rate Tax rate ID, or the db row itself in object format
* @return string
*/
public static function get_rate_code( $key_or_rate ) {
global $wpdb;
if ( is_object( $key_or_rate ) ) {
$key = $key_or_rate->tax_rate_id;
$rate = $key_or_rate;
} else {
$key = $key_or_rate;
$rate = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %s", $key ) );
}
2014-10-28 11:24:09 +00:00
$code_string = '';
if ( null !== $rate ) {
$code = array();
$code[] = $rate->tax_rate_country;
$code[] = $rate->tax_rate_state;
$code[] = $rate->tax_rate_name ? $rate->tax_rate_name : 'TAX';
$code[] = absint( $rate->tax_rate_priority );
$code_string = strtoupper( implode( '-', array_filter( $code ) ) );
}
2014-10-28 11:24:09 +00:00
return apply_filters( 'woocommerce_rate_code', $code_string, $key );
}
/**
2012-08-14 20:19:41 +00:00
* Round tax lines and return the sum.
*
* @param array
2012-08-08 10:42:42 +00:00
* @return float
*/
public static function get_tax_total( $taxes ) {
2014-06-13 14:53:59 +00:00
return array_sum( array_map( array( __CLASS__, 'round' ), $taxes ) );
}
2014-11-21 13:06:30 +00:00
/**
* Get store tax classes
* @return array
*/
public static function get_tax_classes() {
return array_filter( array_map( 'trim', explode( "\n", get_option( 'woocommerce_tax_classes' ) ) ) );
2014-11-21 13:06:30 +00:00
}
/**
* format the postcodes
2014-11-21 21:40:42 +00:00
* @param string $postcode
* @return string
*/
private static function format_tax_rate_postcode( $postcode ) {
return strtoupper( trim( $postcode ) );
}
/**
* format the city
2014-11-21 21:40:42 +00:00
* @param string $city
* @return string
*/
private static function format_tax_rate_city( $city ) {
return strtoupper( trim( $city ) );
}
/**
* format the state
* @param string $state
* @return string
*/
private static function format_tax_rate_state( $state ) {
$state = strtoupper( $state );
return $state === '*' ? '' : $state;
}
/**
* format the country
2014-11-21 21:40:42 +00:00
* @param string $country
* @return string
*/
private static function format_tax_rate_country( $country ) {
$country = strtoupper( $country );
return $country === '*' ? '' : $country;
}
/**
* format the tax rate name
2014-11-21 21:40:42 +00:00
* @param string $name
* @return string
*/
private static function format_tax_rate_name( $name ) {
return $name ? $name : __( 'Tax', 'woocommerce' );
}
/**
* format the rate
2014-11-21 21:40:42 +00:00
* @param double $rate
* @return float
*/
private static function format_tax_rate( $rate ) {
return number_format( (double) $rate, 4, '.', '' );
}
/**
* format the priority
* @param string $priority
* @return int
*/
private static function format_tax_rate_priority( $priority ) {
return absint( $priority );
}
/**
* format the class
* @param string $class
* @return string
*/
private static function format_tax_rate_class( $class ) {
$class = sanitize_title( $class );
return $class === 'standard' ? '' : $class;
}
/**
* Prepare and format tax rate for DB insertion
* @param array $tax_rate
* @return array
*/
private static function prepare_tax_rate( $tax_rate ) {
foreach ( $tax_rate as $key => $value ) {
if ( method_exists( __CLASS__, 'format_' . $key ) ) {
$tax_rate[ $key ] = call_user_func( array( __CLASS__, 'format_' . $key ), $value );
}
}
return $tax_rate;
}
/**
* Insert a new tax rate
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param array $tax_rate
* @return int tax rate id
*/
public static function _insert_tax_rate( $tax_rate ) {
global $wpdb;
$wpdb->insert( $wpdb->prefix . 'woocommerce_tax_rates', self::prepare_tax_rate( $tax_rate ) );
do_action( 'woocommerce_tax_rate_added', $wpdb->insert_id, $tax_rate );
return $wpdb->insert_id;
}
/**
* Update a tax rate
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param int $tax_rate_id
* @param array $tax_rate
*/
public static function _update_tax_rate( $tax_rate_id, $tax_rate ) {
global $wpdb;
$tax_rate_id = absint( $tax_rate_id );
$wpdb->update(
$wpdb->prefix . "woocommerce_tax_rates",
self::prepare_tax_rate( $tax_rate ),
array(
'tax_rate_id' => $tax_rate_id
)
);
do_action( 'woocommerce_tax_rate_updated', $tax_rate_id, $tax_rate );
}
/**
* Delete a tax rate from the database
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param int $tax_rate_id
*/
public static function _delete_tax_rate( $tax_rate_id ) {
global $wpdb;
$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->prefix}woocommerce_tax_rate_locations WHERE tax_rate_id = %d;", $tax_rate_id ) );
$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %d;", $tax_rate_id ) );
do_action( 'woocommerce_tax_rate_deleted', $tax_rate_id );
}
/**
* Update postcodes for a tax rate in the DB
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param int $tax_rate_id
* @param string $postcodes String of postcodes separated by ; characters
* @return string
*/
public static function _update_tax_rate_postcodes( $tax_rate_id, $postcodes ) {
$postcodes = array_filter( array_diff( array_map( array( __CLASS__, 'format_tax_rate_postcode' ), explode( ';', $postcodes ) ), array( '*' ) ) );
$postcodes = self::_get_expanded_numeric_ranges_from_array( $postcodes );
2014-11-20 21:02:10 +00:00
self::_update_tax_rate_locations( $tax_rate_id, $postcodes, 'postcode' );
}
/**
* Update cities for a tax rate in the DB
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param int $tax_rate_id
* @param string $cities
* @return string
*/
public static function _update_tax_rate_cities( $tax_rate_id, $cities ) {
$cities = array_filter( array_diff( array_map( array( __CLASS__, 'format_tax_rate_city' ), explode( ';', $cities ) ), array( '*' ) ) );
2014-11-20 21:02:10 +00:00
self::_update_tax_rate_locations( $tax_rate_id, $cities, 'city' );
}
/**
* Updates locations (postcode and city)
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param int $tax_rate_id
* @param string $cities
* @return string
*/
private static function _update_tax_rate_locations( $tax_rate_id, $values, $type ) {
global $wpdb;
$wpdb->query(
$wpdb->prepare( "
2014-11-20 21:02:10 +00:00
DELETE FROM {$wpdb->prefix}woocommerce_tax_rate_locations WHERE tax_rate_id = %d AND location_type = %s;
", $tax_rate_id, $type
)
);
2014-11-21 13:06:30 +00:00
if ( sizeof( $values ) > 0 ) {
2014-11-20 21:02:10 +00:00
$sql = "( '" . implode( "', $tax_rate_id, '" . esc_sql( $type ) . "' ),( '", array_map( 'esc_sql', $values ) ) . "', $tax_rate_id, '" . esc_sql( $type ) . "' )";
$wpdb->query( "
INSERT INTO {$wpdb->prefix}woocommerce_tax_rate_locations ( location_code, tax_rate_id, location_type ) VALUES $sql;
" );
}
}
/**
* Expands ranges in an array (used for zipcodes). e.g. 101-105 would expand to 101, 102, 103, 104, 105
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param array $values array of values
* @return array expanded values
*/
private static function _get_expanded_numeric_ranges_from_array( $values = array() ) {
$expanded = array();
foreach ( $values as $value ) {
if ( strstr( $value, '-' ) ) {
$parts = array_map( 'absint', array_map( 'trim', explode( '-', $value ) ) );
for ( $expanded_value = $parts[0]; $expanded_value <= $parts[1]; $expanded_value ++ ) {
if ( strlen( $expanded_value ) < strlen( $parts[0] ) ) {
$expanded_value = str_pad( $expanded_value, strlen( $parts[0] ), "0", STR_PAD_LEFT );
}
$expanded[] = $expanded_value;
}
} else {
$expanded[] = trim( $value );
}
}
return array_filter( $expanded );
}
2014-11-21 12:05:44 +00:00
/**
* Get postcode wildcards in array format
*
* Internal use only.
*
* @since 2.3.0
* @access private
*
* @param string $postcode array of values
* @return array Array of postcodes with wildcards
*/
private static function _get_wildcard_postcodes( $postcode ) {
$postcodes = array( '*', strtoupper( $postcode ) );
$postcode_length = strlen( $postcode );
$wildcard_postcode = strtoupper( $postcode );
for ( $i = 0; $i < $postcode_length; $i ++ ) {
$wildcard_postcode = substr( $wildcard_postcode, 0, -1 );
$postcodes[] = $wildcard_postcode . '*';
}
return $postcodes;
}
}
2014-09-20 19:02:51 +00:00
WC_Tax::init();