laipower/wp-content/plugins/easy-digital-downloads/includes/tax-functions.php

<?php
/**
 * Tax Functions
 *
 * These are functions used for checking if taxes are enabled, calculating taxes, etc.
 * Functions for retrieving tax amounts and such for individual payments are in
 * includes/payment-functions.php and includes/cart-functions.php
 *
 * @package     EDD
 * @subpackage  Functions/Taxes
 * @copyright   Copyright (c) 2018, Easy Digital Downloads, LLC
 * @license     http://opensource.org/licenses/gpl-2.0.php GNU Public License
 * @since       1.3.3
 */

// Exit if accessed directly
defined( 'ABSPATH' ) || exit;

/**
 * Checks if taxes are enabled by using the option set from the EDD Settings.
 * The value returned can be filtered.
 *
 * @since 1.3.3
 *
 * @return bool True if taxes are enabled, false otherwise..
 */
function edd_use_taxes() {
	$ret = edd_get_option( 'enable_taxes', false );

	return (bool) apply_filters( 'edd_use_taxes', $ret );
}

/**
 * Retrieve tax rates
 *
 * @since 1.6
 * @since 3.0 Updated to use new query class.
 *            Added $output parameter to output an array of EDD\Adjustments\Adjustment objects, if set to `object`.
 *            Added $args parameter.
 *
 * @param array  $args   Query arguments
 * @param string $output Optional. Type of data to output. Any of ARRAY_N | OBJECT.
 *
 * @return array|\EDD\Adjustments\Adjustment[] Tax rates.
 */
function edd_get_tax_rates( $args = array(), $output = ARRAY_N ) {

	if ( isset( $args['status'] ) && 'active' === $args['status'] ) {
		add_filter( 'edd_adjustments_query_clauses', 'edd_active_tax_rates_query_clauses' );
	}

	// Instantiate a query object
	$adjustments = new EDD\Database\Queries\Adjustment();

	// Parse args
	$r = wp_parse_args( $args, array(
		'number'  => 30,
		'type'    => 'tax_rate',
		'orderby' => 'date_created',
		'order'   => 'ASC',
	) );

	if ( isset( $args['status'] ) && 'active' === $args['status'] ) {
		remove_filter( 'edd_adjustments_query_clauses', 'edd_active_tax_rates_query_clauses' );
	}

	$adjustments->query( $r );

	if ( OBJECT === $output ) {
		return $adjustments->items;
	}

	$rates = array();

	if ( $adjustments->items ) {
		foreach ( $adjustments->items as $tax_rate ) {
			$rate = array(
				'id'      => absint( $tax_rate->id ),
				'country' => esc_attr( $tax_rate->name ),
				'rate'    => floatval( $tax_rate->amount ),
				'state'   => '',
				'global'  => '1',
				'status'  => esc_attr( $tax_rate->status ),
				'scope'   => esc_attr( $tax_rate->scope ),
			);

			if ( ! empty( $tax_rate->description ) ) {
				$rate['state'] = esc_attr( $tax_rate->description );
			}

			if ( 'region' === $tax_rate->scope ) {
				$rate['global'] = '0';
			}

			$rates[] = $rate;
		}
	}

	return (array) apply_filters( 'edd_get_tax_rates', $rates );
}

/**
 * Query for and return array of tax rates counts, keyed by status.
 *
 * @since 3.0
 *
 * @return array
 */
function edd_get_tax_rate_counts( $args = array() ) {

	// Parse arguments
	$r = wp_parse_args( $args, array(
		'count'   => true,
		'groupby' => 'status',
		'type'    => 'tax_rate'
	) );

	// Query for count.
	$counts = new EDD\Database\Queries\Adjustment( $r );

	// Format & return
	return edd_format_counts( $counts, $r['groupby'] );
}

/**
 * Add a WHERE clause to ensure only active tax rates are returned.
 *
 * @since 3.0
 *
 * @param array $clauses Query clauses.
 * @return array $clauses Updated query clauses.
 */
function edd_active_tax_rates_query_clauses( $clauses ) {
	$date = \Carbon\Carbon::now( edd_get_timezone_id() )->toDateTimeString();

	$clauses['where'] .= "
		AND ( start_date < '{$date}' OR start_date IS NULL )
		AND ( end_date > '{$date}' OR end_date IS NULL )
	";

	return $clauses;
}

/**
 * Get taxation rate.
 *
 * @since 1.3.3
 * @since 3.0 Refactored to work with custom tables and start and end dates.
 *            Renamed $state parameter to $region.
 *            Added $fallback parameter to only get rate for passed Country and Region.
 *
 * @param string  $country Country.
 * @param string  $region  Region.
 * @param boolean $fallback Fall back to (in order): server $_POST data, the current Customer's
 *                          address information, then your store's Business Country setting.
 *                          Default true.
 *
 * @return float
 */
function edd_get_tax_rate( $country = '', $region = '', $fallback = true ) {

	// Get the address, to try to get the tax rate
	$user_address = edd_get_customer_address();

	$address_line_1 = ! empty( $_POST['card_address'] )
		? sanitize_text_field( $_POST['card_address'] )
		: '';

	$address_line_2 = ! empty( $_POST['card_address_2'] )
		? sanitize_text_field( $_POST['card_address_2'] )
		: '';

	$city = ! empty( $_POST['card_city'] )
		? sanitize_text_field( $_POST['card_city'] )
		: '';

	$zip = ! empty( $_POST['card_zip'] )
		? sanitize_text_field( $_POST['card_zip'] )
		: '';

	// Country
	if ( empty( $country ) && true === $fallback ) {
		if ( ! empty( $_POST['billing_country'] ) ) {
			$country = $_POST['billing_country'];
		} elseif ( is_user_logged_in() && ! empty( $user_address['country'] ) ) {
			$country = $user_address['country'];
		}

		$country = empty( $country )
			? edd_get_shop_country()
			: $country;
	}

	// Region
	if ( empty( $region ) && true === $fallback ) {
		if ( ! empty( $_POST['state'] ) ) {
			$region = $_POST['state'];
		} elseif ( ! empty( $_POST['card_state'] ) ) {
			$region = $_POST['card_state'];
		} elseif ( is_user_logged_in() && ! empty( $user_address['state'] ) ) {
			$region = $user_address['state'];
		}

		$region = empty( $region )
			? edd_get_shop_state()
			: $region;
	}

	$tax_rate = edd_get_tax_rate_by_location(
		array(
			'country' => $country,
			'region'  => $region,
		)
	);

	$rate = $tax_rate ? $tax_rate->amount : 0.00;

	// Convert to a number we can use
	$rate = $rate / 100;

	/**
	 * Allow the tax rate to be filtered.
	 *
	 * @since 1.3.3
	 * @since 3.0 Added entire customer address.
	 *
	 * @param float  $rate           Calculated tax rate.
	 * @param string $country        Country.
	 * @param string $region         Region.
	 * @param string $address_line_1 First line of address.
	 * @param string $address_line_2 Second line of address.
	 * @param string $city           City.
	 * @param string $zip            ZIP code.
	 */
	return apply_filters( 'edd_tax_rate', $rate, $country, $region, $address_line_1, $address_line_2, $city, $zip );
}

/**
 * Retrieve a fully formatted tax rate
 *
 * @since 1.9
 * @param string $country The country to retrieve a rate for
 * @param string $state The state to retrieve a rate for
 * @return string Formatted rate
 */
function edd_get_formatted_tax_rate( $country = false, $state = false ) {
	$rate      = edd_get_tax_rate( $country, $state );
	$rate      = round( $rate * 100, 4 );
	$formatted = $rate .= '%';

	return apply_filters( 'edd_formatted_tax_rate', $formatted, $rate, $country, $state );
}

/**
 * Calculate the taxed amount.
 *
 * @since 1.3.3
 * @since 3.0 Renamed $state parameter to $region.
 *            Added $fallback parameter.
 *            Added `$tax_rate` parameter.
 *
 * @param float      $amount   Amount.
 * @param string     $country  Country. Default base country.
 * @param string     $region   Region. Default base region.
 * @param boolean    $fallback Fall back to (in order): server $_POST data, the current Customer's
 *                             address information, then your store's Business Country setting.
 *                             Default true.
 * @param null|float $tax_rate Tax rate to use for the calculataion. If `null`, the rate is retrieved using
 *                             `edd_get_tax_rate()`.
 *
 * @return float $tax Taxed amount.
 */
function edd_calculate_tax( $amount = 0.00, $country = '', $region = '', $fallback = true, $tax_rate = null ) {
	$rate = ( null === $tax_rate ) ? edd_get_tax_rate( $country, $region, $fallback ) : $tax_rate;
	$tax  = 0.00;

	if ( edd_use_taxes() && $amount > 0 ) {

		if ( edd_prices_include_tax() ) {
			$pre_tax = ( $amount / ( 1 + $rate ) );
			$tax     = $amount - $pre_tax;
		} else {
			$tax = $amount * $rate;
		}
	}

	/**
	 * Filter the taxed amount.
	 *
	 * @since 1.5.3
	 *
	 * @param float $tax      Taxed amount.
	 * @param float $rate     Tax rate applied.
	 * @param string $country Country.
	 * @param string $region  Region.
	 */
	return apply_filters( 'edd_taxed_amount', $tax, $rate, $country, $region );
}

/**
 * Returns the formatted tax amount for the given year
 *
 * @since 1.3.3
 * @param $year int The year to retrieve taxes for, i.e. 2012
 * @uses edd_get_sales_tax_for_year()
 * @return void
 */
function edd_sales_tax_for_year( $year = null ) {
	echo edd_currency_filter( edd_format_amount( edd_get_sales_tax_for_year( $year ) ) );
}

/**
 * Gets the sales tax for the given year
 *
 * @since 1.3.3
 * @param $year int The year to retrieve taxes for, i.e. 2012
 * @uses edd_get_payment_tax()
 * @return float $tax Sales tax
 */
function edd_get_sales_tax_for_year( $year = null ) {
	global $wpdb;

	// Start at zero
	$tax = 0;

	if ( ! empty( $year ) ) {
		$year = absint( $year );

		$tax = $wpdb->get_var( $wpdb->prepare( "SELECT SUM(tax) FROM {$wpdb->edd_orders} WHERE status IN('complete', 'revoked') AND YEAR(date_created) = %d", $year ) );
	}

	if ( ! $tax || is_null( $tax ) ) {
		$tax = 0.00;
	}

	// Filter & return
	return (float) apply_filters( 'edd_get_sales_tax_for_year', $tax, $year );
}

/**
 * Is the cart taxed?
 *
 * This used to include a check for local tax opt-in, but that was ripped out in v1.6, so this is just a wrapper now
 *
 * @since 1.5
 * @return bool
 */
function edd_is_cart_taxed() {
	return edd_use_taxes();
}

/**
 * Check if the individual product prices include tax
 *
 * @since 1.5
 * @return bool $include_tax
 */
function edd_prices_include_tax() {
	$ret = ( edd_get_option( 'prices_include_tax', false ) === 'yes' && edd_use_taxes() );

	return apply_filters( 'edd_prices_include_tax', $ret );
}

/**
 * Checks whether the user has enabled display of taxes on the checkout
 *
 * @since 1.5
 * @return bool $include_tax
 */
function edd_prices_show_tax_on_checkout() {
	$ret = ( edd_get_option( 'checkout_include_tax', false ) === 'yes' && edd_use_taxes() );

	return apply_filters( 'edd_taxes_on_prices_on_checkout', $ret );
}

/**
 * Check to see if we should show included taxes
 *
 * Some countries (notably in the EU) require included taxes to be displayed.
 *
 * @since 1.7
 * @author Daniel J Griffiths
 * @return bool
 */
function edd_display_tax_rate() {
	$ret = edd_use_taxes() && edd_get_option( 'display_tax_rate', false );

	return apply_filters( 'edd_display_tax_rate', $ret );
}

/**
 * Should we show address fields for taxation purposes?
 *
 * @since 1.y
 * @return bool
 */
function edd_cart_needs_tax_address_fields() {

	if ( ! edd_is_cart_taxed() ) {
		return false;
	}

	return ! did_action( 'edd_after_cc_fields', 'edd_default_cc_address_fields' );
}

/**
 * Is this Download excluded from tax?
 *
 * @since 1.9
 * @return bool
 */
function edd_download_is_tax_exclusive( $download_id = 0 ) {
	$ret = (bool) get_post_meta( $download_id, '_edd_download_tax_exclusive', true );

	return (Bool) apply_filters( 'edd_download_is_tax_exclusive', $ret, $download_id );
}

/**
 * Gets the tax rate object from the database for a given country / region.
 * Used in `edd_get_tax_rate`, `edd_build_order`, `edd_add_manual_order`.
 * If a regional tax rate is found, it will be returned immediately,
 * so rates with a scope of `country` may be overridden by a more specific rate.
 *
 * @param array $args {
 *     Country and, optionally, region to get the tax rate for.
 *
 *     @type string $country Required - country to check.
 *     @type string $region  Optional - check a specific region within the country.
 * }
 * @return \EDD\Database\Rows\Adjustment|false
 *
 * @since 3.0
 */
function edd_get_tax_rate_by_location( $args ) {

	$rate      = false;
	$tax_rates = array();

	// Fetch all the active country tax rates from the database.
	// The region is not passed in deliberately in order to check for country-wide tax rates.
	if ( ! empty( $args['country'] ) ) {
		$tax_rates = edd_get_tax_rates(
			array(
				'name'   => $args['country'],
				'status' => 'active',
			),
			OBJECT
		);
	}

	if ( ! empty( $tax_rates ) ) {
		foreach ( $tax_rates as $tax_rate ) {

			// Regional tax rate.
			if ( ! empty( $args['region'] ) && ! empty( $tax_rate->description ) && 'region' === $tax_rate->scope ) {
				if ( strtolower( $args['region'] ) !== strtolower( $tax_rate->description ) ) {
					continue;
				}

				// A tax rate matching the region/description was found, so return it.
				return $tax_rate;
			} elseif ( 'country' === $tax_rate->scope ) {
				// Countrywide tax rate.
				$rate = $tax_rate;
			}
		}

		if ( $rate ) {
			return $rate;
		}
	}

	// No regional or country rate was found, so look for a global rate.
	$global_rates = edd_get_tax_rates(
		array(
			'name'   => '',
			'scope'  => 'global',
			'status' => 'active',
		),
		OBJECT
	);

	return ! empty( $global_rates ) ? reset( $global_rates ) : $rate;
}

/**
 * Clears the tax rate cache prior to displaying the cart.
 * This fixes potential issues with custom tax rates / rate filtering from after we added
 * tax rate caching logic.
 *
 * @link https://github.com/easydigitaldownloads/easy-digital-downloads/pull/8509#issuecomment-926576698
 *
 * @since 3.0
 */
add_action( 'edd_before_checkout_cart', function () {
	EDD()->cart->set_tax_rate( null );
} );

/**
 * Adds a tax rate to the database.
 * If an active tax rate is found, it's demoted to inactive and the new one is added.
 *
 * @since 3.0.3
 * @param array $data The array of data to create the tax rate.
 * @return int|false Returns the tax rate ID if one is added; otherwise false.
 */
function edd_add_tax_rate( $data = array() ) {
	$data = wp_parse_args(
		$data,
		array(
			'name'        => '',
			'description' => '',
			'status'      => 'active',
		)
	);

	// The type and amount type for tax rates cannot be overridden.
	$data['type']        = 'tax_rate';
	$data['amount_type'] = 'percent';

	if ( empty( $data['scope'] ) ) {
		$scope = 'country';
		if ( empty( $data['name'] ) && empty( $data['description'] ) ) {
			$scope = 'global';
		} elseif ( ! empty( $data['name'] ) && ! empty( $data['description'] ) ) {
			$scope = 'region';
		}
		$data['scope'] = $scope;
	}

	// Check if the tax rate exists.
	$data_to_check = array(
		'type'        => 'tax_rate',
		'fields'      => 'ids',
		'status'      => 'active',
		'name'        => $data['name'],
		'description' => $data['description'],
		'scope'       => $data['scope'],
	);

	// Query for potentially matching active rates.
	$tax_rate_exists = edd_get_adjustments( $data_to_check );
	$tax_rate_id     = edd_add_adjustment( $data );

	// If the new tax rate was successfully added, set the old one to inactive.
	if ( $tax_rate_id && ! empty( $tax_rate_exists ) ) {
		edd_update_adjustment( $tax_rate_exists[0], array( 'status' => 'inactive' ) );
	}

	return $tax_rate_id;
}