/home/techb158/l2hypotheques.com/wp-content/plugins/woocommerce/includes
Edit: /home/techb158/l2hypotheques.com/wp-content/plugins/woocommerce/includes/class-wc-coupon.php (44920B)
'',
'amount' => 0,
'status' => null,
'date_created' => null,
'date_modified' => null,
'date_expires' => null,
'discount_type' => 'fixed_cart',
'description' => '',
'usage_count' => 0,
'individual_use' => false,
'product_ids' => array(),
'excluded_product_ids' => array(),
'usage_limit' => 0,
'usage_limit_per_user' => 0,
'limit_usage_to_x_items' => null,
'free_shipping' => false,
'product_categories' => array(),
'excluded_product_categories' => array(),
'exclude_sale_items' => false,
'minimum_amount' => '',
'maximum_amount' => '',
'email_restrictions' => array(),
'used_by' => array(),
'virtual' => false,
);
// Coupon message codes.
const E_WC_COUPON_INVALID_FILTERED = 100;
const E_WC_COUPON_INVALID_REMOVED = 101;
const E_WC_COUPON_NOT_YOURS_REMOVED = 102;
const E_WC_COUPON_ALREADY_APPLIED = 103;
const E_WC_COUPON_ALREADY_APPLIED_INDIV_USE_ONLY = 104;
const E_WC_COUPON_NOT_EXIST = 105;
const E_WC_COUPON_USAGE_LIMIT_REACHED = 106;
const E_WC_COUPON_EXPIRED = 107;
const E_WC_COUPON_MIN_SPEND_LIMIT_NOT_MET = 108;
const E_WC_COUPON_NOT_APPLICABLE = 109;
const E_WC_COUPON_NOT_VALID_SALE_ITEMS = 110;
const E_WC_COUPON_PLEASE_ENTER = 111;
const E_WC_COUPON_MAX_SPEND_LIMIT_MET = 112;
const E_WC_COUPON_EXCLUDED_PRODUCTS = 113;
const E_WC_COUPON_EXCLUDED_CATEGORIES = 114;
const E_WC_COUPON_USAGE_LIMIT_COUPON_STUCK = 115;
const E_WC_COUPON_USAGE_LIMIT_COUPON_STUCK_GUEST = 116;
const WC_COUPON_SUCCESS = 200;
const WC_COUPON_REMOVED = 201;
/**
* Cache group.
*
* @var string
*/
protected $cache_group = 'coupons';
/**
* Error message.
*
* This property should not be considered public API, and should not be accessed directly.
* It is being added to suppress PHP > 8.0 warnings against dynamic property creation, and all access
* should be through the getter and setter methods, namely `get_error_message()` and `set_error_message()`.
* In the future, the access modifier may be changed back to protected.
*
* @var string
*/
public $error_message;
/**
* Sorting.
*
* Used by `get_coupons_from_cart` to sort coupons.
*
* @var int
*/
public $sort = 0;
/**
* Coupon constructor. Loads coupon data.
*
* @param mixed $data Coupon data, object, ID or code.
*/
public function __construct( $data = '' ) {
parent::__construct( $data );
// If we already have a coupon object, read it again.
if ( $data instanceof WC_Coupon ) {
$this->set_id( absint( $data->get_id() ) );
$this->read_object_from_database();
return;
}
// This filter allows custom coupon objects to be created on the fly.
$coupon = apply_filters( 'woocommerce_get_shop_coupon_data', false, $data, $this );
if ( $coupon ) {
$this->read_manual_coupon( $data, $coupon );
return;
}
// Try to load coupon using ID or code.
if ( is_int( $data ) && 'shop_coupon' === get_post_type( $data ) ) {
$this->set_id( $data );
} elseif ( is_string( $data ) && ! StringUtil::is_null_or_whitespace( $data ) ) {
$id = wc_get_coupon_id_by_code( $data );
// Need to support numeric strings for backwards compatibility.
if ( ! $id && 'shop_coupon' === get_post_type( $data ) ) {
$this->set_id( $data );
} else {
$this->set_id( $id );
$this->set_code( $data );
}
} else {
$this->set_object_read( true );
}
$this->read_object_from_database();
}
/**
* Returns all data for this object.
*
* @since 2.6.0
* @return array
*/
public function get_data() {
$data = parent::get_data();
if ( '' === $data['minimum_amount'] ) {
$data['minimum_amount'] = '0';
}
if ( '' === $data['maximum_amount'] ) {
$data['maximum_amount'] = '0';
}
return $data;
}
/**
* If the object has an ID, read using the data store.
*
* @since 3.4.1
* @return void
*/
protected function read_object_from_database() {
$this->data_store = WC_Data_Store::load( 'coupon' );
if ( $this->get_id() > 0 ) {
$this->data_store->read( $this );
}
}
/**
* Checks the coupon type.
*
* @param string|array $type Array or string of types.
* @return bool
*/
public function is_type( $type ) {
return ( $this->get_discount_type() === $type || ( is_array( $type ) && in_array( $this->get_discount_type(), $type, true ) ) );
}
/**
* Prefix for action and filter hooks on data.
*
* @since 3.0.0
* @return string
*/
protected function get_hook_prefix() {
return 'woocommerce_coupon_get_';
}
/*
|--------------------------------------------------------------------------
| Getters
|--------------------------------------------------------------------------
|
| Methods for getting data from the coupon object.
|
*/
/**
* Get coupon code.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return string
*/
public function get_code( $context = 'view' ) {
return $this->get_prop( 'code', $context );
}
/**
* Get coupon description.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return string
*/
public function get_description( $context = 'view' ) {
return $this->get_prop( 'description', $context );
}
/**
* Get coupon status.
*
* @since 6.2.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return string
*/
public function get_status( $context = 'view' ) {
return $this->get_prop( 'status', $context );
}
/**
* Get discount type.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return string
*/
public function get_discount_type( $context = 'view' ) {
return $this->get_prop( 'discount_type', $context );
}
/**
* Get coupon amount.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return string
*/
public function get_amount( $context = 'view' ) {
return wc_format_decimal( $this->get_prop( 'amount', $context ) );
}
/**
* Get coupon expiration date.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return WC_DateTime|NULL object if the date is set or null if there is no date.
*/
public function get_date_expires( $context = 'view' ) {
return $this->get_prop( 'date_expires', $context );
}
/**
* Get date_created
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return WC_DateTime|NULL object if the date is set or null if there is no date.
*/
public function get_date_created( $context = 'view' ) {
return $this->get_prop( 'date_created', $context );
}
/**
* Get date_modified
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return WC_DateTime|NULL object if the date is set or null if there is no date.
*/
public function get_date_modified( $context = 'view' ) {
return $this->get_prop( 'date_modified', $context );
}
/**
* Get coupon usage count.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return integer
*/
public function get_usage_count( $context = 'view' ) {
return $this->get_prop( 'usage_count', $context );
}
/**
* Get the "individual use" checkbox status.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return bool
*/
public function get_individual_use( $context = 'view' ) {
return $this->get_prop( 'individual_use', $context );
}
/**
* Get product IDs this coupon can apply to.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return array
*/
public function get_product_ids( $context = 'view' ) {
return $this->get_prop( 'product_ids', $context );
}
/**
* Get product IDs that this coupon should not apply to.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return array
*/
public function get_excluded_product_ids( $context = 'view' ) {
return $this->get_prop( 'excluded_product_ids', $context );
}
/**
* Get coupon usage limit.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return integer
*/
public function get_usage_limit( $context = 'view' ) {
return $this->get_prop( 'usage_limit', $context );
}
/**
* Get coupon usage limit per customer (for a single customer)
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return integer
*/
public function get_usage_limit_per_user( $context = 'view' ) {
return $this->get_prop( 'usage_limit_per_user', $context );
}
/**
* Usage limited to certain amount of items
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return integer|null
*/
public function get_limit_usage_to_x_items( $context = 'view' ) {
return $this->get_prop( 'limit_usage_to_x_items', $context );
}
/**
* If this coupon grants free shipping or not.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return bool
*/
public function get_free_shipping( $context = 'view' ) {
return $this->get_prop( 'free_shipping', $context );
}
/**
* Get product categories this coupon can apply to.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return array
*/
public function get_product_categories( $context = 'view' ) {
return $this->get_prop( 'product_categories', $context );
}
/**
* Get product categories this coupon cannot not apply to.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return array
*/
public function get_excluded_product_categories( $context = 'view' ) {
return $this->get_prop( 'excluded_product_categories', $context );
}
/**
* If this coupon should exclude items on sale.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return bool
*/
public function get_exclude_sale_items( $context = 'view' ) {
return $this->get_prop( 'exclude_sale_items', $context );
}
/**
* Get minimum spend amount.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return string
*/
public function get_minimum_amount( $context = 'view' ) {
if ( 'edit' !== $context && $this->get_prop( 'minimum_amount', $context ) === '' ) {
return wc_format_decimal( 0 );
}
return wc_format_decimal( $this->get_prop( 'minimum_amount', $context ) );
}
/**
* Get maximum spend amount.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return string
*/
public function get_maximum_amount( $context = 'view' ) {
if ( 'edit' !== $context && $this->get_prop( 'maximum_amount', $context ) === '' ) {
return wc_format_decimal( 0 );
}
return wc_format_decimal( $this->get_prop( 'maximum_amount', $context ) );
}
/**
* Get emails to check customer usage restrictions.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return array
*/
public function get_email_restrictions( $context = 'view' ) {
return $this->get_prop( 'email_restrictions', $context );
}
/**
* Get records of all users who have used the current coupon.
*
* @since 3.0.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return array
*/
public function get_used_by( $context = 'view' ) {
return $this->get_prop( 'used_by', $context );
}
/**
* If the filter is added through the woocommerce_get_shop_coupon_data filter, it's virtual and not in the DB.
*
* @since 3.2.0
* @param string $context What the value is for. Valid values are 'view' and 'edit'.
* @return boolean
*/
public function get_virtual( $context = 'view' ) {
return (bool) $this->get_prop( 'virtual', $context );
}
/**
* Get discount amount for a cart item.
*
* @param float $discounting_amount Amount the coupon is being applied to.
* @param array|null $cart_item Cart item being discounted if applicable.
* @param boolean $single True if discounting a single qty item, false if its the line.
* @return float Amount this coupon has discounted.
*/
public function get_discount_amount( $discounting_amount, $cart_item = null, $single = false ) {
$discount = 0;
$cart_item_qty = is_null( $cart_item ) ? 1 : $cart_item['quantity'];
if ( $this->is_type( array( 'percent' ) ) ) {
$discount = (float) $this->get_amount() * ( $discounting_amount / 100 );
} elseif ( $this->is_type( 'fixed_cart' ) && ! is_null( $cart_item ) && WC()->cart->subtotal_ex_tax ) {
/**
* This is the most complex discount - we need to divide the discount between rows based on their price in.
* proportion to the subtotal. This is so rows with different tax rates get a fair discount, and so rows.
* with no price (free) don't get discounted.
*
* Get item discount by dividing item cost by subtotal to get a %.
*
* Uses price inc tax if prices include tax to work around https://github.com/woocommerce/woocommerce/issues/7669 and https://github.com/woocommerce/woocommerce/issues/8074.
*/
if ( wc_prices_include_tax() ) {
$discount_percent = ( wc_get_price_including_tax( $cart_item['data'] ) * $cart_item_qty ) / WC()->cart->subtotal;
} else {
$discount_percent = ( wc_get_price_excluding_tax( $cart_item['data'] ) * $cart_item_qty ) / WC()->cart->subtotal_ex_tax;
}
$discount = ( (float) $this->get_amount() * $discount_percent ) / $cart_item_qty;
} elseif ( $this->is_type( 'fixed_product' ) ) {
$discount = min( $this->get_amount(), $discounting_amount );
$discount = $single ? $discount : $discount * $cart_item_qty;
}
return apply_filters(
'woocommerce_coupon_get_discount_amount',
NumberUtil::round( min( $discount, $discounting_amount ), wc_get_rounding_precision() ),
$discounting_amount,
$cart_item,
$single,
$this
);
}
/*
|--------------------------------------------------------------------------
| Setters
|--------------------------------------------------------------------------
|
| Functions for setting coupon data. These should not update anything in the
| database itself and should only change what is stored in the class
| object.
|
*/
/**
* Set coupon code.
*
* @since 3.0.0
* @param string $code Coupon code.
* @return void
*/
public function set_code( $code ) {
$this->set_prop( 'code', wc_format_coupon_code( $code ) );
}
/**
* Set coupon description.
*
* @since 3.0.0
* @param string $description Description.
* @return void
*/
public function set_description( $description ) {
$this->set_prop( 'description', $description );
}
/**
* Set coupon status.
*
* @since 3.0.0
* @param string $status Status.
* @return void
*/
public function set_status( $status ) {
$this->set_prop( 'status', $status );
}
/**
* Set discount type.
*
* @since 3.0.0
* @param string $discount_type Discount type.
* @return void
*/
public function set_discount_type( $discount_type ) {
$this->set_discount_type_core( $discount_type, true );
}
/**
* Set discount type, optionally disabling the type verification.
*
* @since 10.3.0
* @param string $discount_type Discount type.
* @param bool $verify_discount_type Whether to verify if the discount type is valid.
* @return void
*/
private function set_discount_type_core( $discount_type, bool $verify_discount_type ) {
if ( 'percent_product' === $discount_type ) {
$discount_type = 'percent'; // Backwards compatibility.
}
if ( $verify_discount_type && ! in_array( $discount_type, array_keys( wc_get_coupon_types() ), true ) ) {
$this->error( 'coupon_invalid_discount_type', __( 'Invalid discount type.', 'woocommerce' ) );
}
$this->set_prop( 'discount_type', $discount_type );
}
/**
* Set amount.
*
* @since 3.0.0
* @param float|string $amount Amount.
* @return void
*/
public function set_amount( $amount ) {
$amount = wc_format_decimal( $amount );
if ( ! is_numeric( $amount ) ) {
$amount = 0;
}
if ( (float) $amount < 0 ) {
$this->error( 'coupon_invalid_amount', __( 'Invalid discount amount.', 'woocommerce' ) );
}
if ( 'percent' === $this->get_discount_type() && (float) $amount > 100 ) {
$this->error( 'coupon_invalid_amount', __( 'Invalid discount amount.', 'woocommerce' ) );
}
$this->set_prop( 'amount', $amount );
}
/**
* Set expiration date.
*
* @since 3.0.0
* @param string|integer|null $date UTC timestamp, or ISO 8601 DateTime. If the DateTime string has no timezone or offset, WordPress site timezone will be assumed. Null if there is no date.
* @return void
*/
public function set_date_expires( $date ) {
$this->set_date_prop( 'date_expires', $date );
}
/**
* Set date_created
*
* @since 3.0.0
* @param string|integer|null $date UTC timestamp, or ISO 8601 DateTime. If the DateTime string has no timezone or offset, WordPress site timezone will be assumed. Null if there is no date.
* @return void
*/
public function set_date_created( $date ) {
$this->set_date_prop( 'date_created', $date );
}
/**
* Set date_modified
*
* @since 3.0.0
* @param string|integer|null $date UTC timestamp, or ISO 8601 DateTime. If the DateTime string has no timezone or offset, WordPress site timezone will be assumed. Null if there is no date.
* @return void
*/
public function set_date_modified( $date ) {
$this->set_date_prop( 'date_modified', $date );
}
/**
* Set how many times this coupon has been used.
*
* @since 3.0.0
* @param int $usage_count Usage count.
* @return void
*/
public function set_usage_count( $usage_count ) {
$this->set_prop( 'usage_count', absint( $usage_count ) );
}
/**
* Set if this coupon can only be used once.
*
* @since 3.0.0
* @param bool $is_individual_use If is for individual use.
* @return void
*/
public function set_individual_use( $is_individual_use ) {
$this->set_prop( 'individual_use', (bool) $is_individual_use );
}
/**
* Set the product IDs this coupon can be used with.
*
* @since 3.0.0
* @param array $product_ids Products IDs.
* @return void
*/
public function set_product_ids( $product_ids ) {
$this->set_prop( 'product_ids', array_filter( wp_parse_id_list( (array) $product_ids ) ) );
}
/**
* Set the product IDs this coupon cannot be used with.
*
* @since 3.0.0
* @param array $excluded_product_ids Exclude product IDs.
* @return void
*/
public function set_excluded_product_ids( $excluded_product_ids ) {
$this->set_prop( 'excluded_product_ids', array_filter( wp_parse_id_list( (array) $excluded_product_ids ) ) );
}
/**
* Set the amount of times this coupon can be used.
*
* @since 3.0.0
* @param int $usage_limit Usage limit.
* @return void
*/
public function set_usage_limit( $usage_limit ) {
$this->set_prop( 'usage_limit', absint( $usage_limit ) );
}
/**
* Set the amount of times this coupon can be used per user.
*
* @since 3.0.0
* @param int $usage_limit Usage limit.
* @return void
*/
public function set_usage_limit_per_user( $usage_limit ) {
$this->set_prop( 'usage_limit_per_user', absint( $usage_limit ) );
}
/**
* Set usage limit to x number of items.
*
* @since 3.0.0
* @param int|null $limit_usage_to_x_items Limit usage to X items.
* @return void
*/
public function set_limit_usage_to_x_items( $limit_usage_to_x_items ) {
$this->set_prop( 'limit_usage_to_x_items', is_null( $limit_usage_to_x_items ) ? null : absint( $limit_usage_to_x_items ) );
}
/**
* Set if this coupon enables free shipping or not.
*
* @since 3.0.0
* @param bool $free_shipping If grant free shipping.
* @return void
*/
public function set_free_shipping( $free_shipping ) {
$this->set_prop( 'free_shipping', (bool) $free_shipping );
}
/**
* Set the product category IDs this coupon can be used with.
*
* @since 3.0.0
* @param array $product_categories List of product categories.
* @return void
*/
public function set_product_categories( $product_categories ) {
$this->set_prop( 'product_categories', array_filter( wp_parse_id_list( (array) $product_categories ) ) );
}
/**
* Set the product category IDs this coupon cannot be used with.
*
* @since 3.0.0
* @param array $excluded_product_categories List of excluded product categories.
* @return void
*/
public function set_excluded_product_categories( $excluded_product_categories ) {
$this->set_prop( 'excluded_product_categories', array_filter( wp_parse_id_list( (array) $excluded_product_categories ) ) );
}
/**
* Set if this coupon should excluded sale items or not.
*
* @since 3.0.0
* @param bool $exclude_sale_items If should exclude sale items.
* @return void
*/
public function set_exclude_sale_items( $exclude_sale_items ) {
$this->set_prop( 'exclude_sale_items', (bool) $exclude_sale_items );
}
/**
* Set the minimum spend amount.
*
* @since 3.0.0
* @param float|string $amount Minimum amount.
* @return void
*/
public function set_minimum_amount( $amount ) {
$this->set_prop( 'minimum_amount', wc_format_decimal( $amount ) );
}
/**
* Set the maximum spend amount.
*
* @since 3.0.0
* @param float|string $amount Maximum amount.
* @return void
*/
public function set_maximum_amount( $amount ) {
if ( (float) $amount && (float) $this->get_minimum_amount() > (float) $amount ) {
$this->error( 'coupon_invalid_maximum_amount', __( 'Invalid maximum spend value.', 'woocommerce' ) );
}
$this->set_prop( 'maximum_amount', wc_format_decimal( $amount ) );
}
/**
* Set email restrictions.
*
* @since 3.0.0
* @param array $emails List of emails.
* @return void
*/
public function set_email_restrictions( $emails = array() ) {
$emails = array_filter( array_map( 'sanitize_email', array_map( 'strtolower', (array) $emails ) ) );
foreach ( $emails as $email ) {
if ( ! is_email( $email ) ) {
$this->error( 'coupon_invalid_email_address', __( 'Invalid email address restriction.', 'woocommerce' ) );
}
}
$this->set_prop( 'email_restrictions', $emails );
}
/**
* Set which users have used this coupon.
*
* @since 3.0.0
* @param array $used_by List of user IDs.
* @return void
*/
public function set_used_by( $used_by ) {
$this->set_prop( 'used_by', array_filter( $used_by ) );
}
/**
* Set coupon virtual state.
*
* @param boolean $virtual Whether it is virtual or not.
* @since 3.2.0
* @return void
*/
public function set_virtual( $virtual ) {
$this->set_prop( 'virtual', (bool) $virtual );
}
/*
|--------------------------------------------------------------------------
| Other Actions
|--------------------------------------------------------------------------
*/
/**
* Developers can programmatically return coupons. This function will read those values into our WC_Coupon class.
*
* @since 3.0.0
* @param string $code Coupon code.
* @param array $coupon Array of coupon properties.
* @return void
*/
public function read_manual_coupon( $code, $coupon ) {
foreach ( $coupon as $key => $value ) {
switch ( $key ) {
case 'excluded_product_ids':
case 'exclude_product_ids':
if ( ! is_array( $coupon[ $key ] ) ) {
wc_doing_it_wrong( $key, $key . ' should be an array instead of a string.', '3.0' );
$coupon['excluded_product_ids'] = wc_string_to_array( $value );
}
break;
case 'exclude_product_categories':
case 'excluded_product_categories':
if ( ! is_array( $coupon[ $key ] ) ) {
wc_doing_it_wrong( $key, $key . ' should be an array instead of a string.', '3.0' );
$coupon['excluded_product_categories'] = wc_string_to_array( $value );
}
break;
case 'product_ids':
if ( ! is_array( $coupon[ $key ] ) ) {
wc_doing_it_wrong( $key, $key . ' should be an array instead of a string.', '3.0' );
$coupon[ $key ] = wc_string_to_array( $value );
}
break;
case 'individual_use':
case 'free_shipping':
case 'exclude_sale_items':
if ( ! is_bool( $coupon[ $key ] ) ) {
wc_doing_it_wrong( $key, $key . ' should be true or false instead of yes or no.', '3.0' );
$coupon[ $key ] = wc_string_to_bool( $value );
}
break;
case 'expiry_date':
$coupon['date_expires'] = $value;
break;
}
}
$this->set_props( $coupon );
$this->set_code( $code );
$this->set_id( 0 );
$this->set_virtual( true );
}
/**
* Increase usage count for current coupon.
*
* @param string $used_by Either user ID or billing email.
* @param WC_Order $order If provided, will clear the coupons held by this order.
* @return void
*/
public function increase_usage_count( $used_by = '', $order = null ) {
if ( $this->get_id() && $this->data_store ) {
$new_count = $this->data_store->increase_usage_count( $this, $used_by, $order );
// Bypass set_prop and remove pending changes since the data store saves the count already.
$this->data['usage_count'] = $new_count;
if ( isset( $this->changes['usage_count'] ) ) {
unset( $this->changes['usage_count'] );
}
}
}
/**
* Decrease usage count for current coupon.
*
* @param string $used_by Either user ID or billing email.
* @return void
*/
public function decrease_usage_count( $used_by = '' ) {
if ( $this->get_id() && $this->get_usage_count() > 0 && $this->data_store ) {
$new_count = $this->data_store->decrease_usage_count( $this, $used_by );
// Bypass set_prop and remove pending changes since the data store saves the count already.
$this->data['usage_count'] = $new_count;
if ( isset( $this->changes['usage_count'] ) ) {
unset( $this->changes['usage_count'] );
}
}
}
/*
|--------------------------------------------------------------------------
| Validation & Error Handling
|--------------------------------------------------------------------------
*/
/**
* Returns the error_message string.
* @return string
*/
public function get_error_message() {
return $this->error_message;
}
/**
* Sets the error_message string.
*
* @param string $message Message string.
*
* @return void
*/
public function set_error_message( string $message ) {
$this->error_message = $message;
}
/**
* Check if a coupon is valid for the cart.
*
* @deprecated 3.2.0 In favor of WC_Discounts->is_coupon_valid.
* @return bool
*/
public function is_valid() {
$discounts = new WC_Discounts( WC()->cart );
$valid = $discounts->is_coupon_valid( $this );
if ( is_wp_error( $valid ) ) {
$this->error_message = $valid->get_error_message();
return false;
}
return $valid;
}
/**
* Check if a coupon is valid.
*
* @return bool
*/
public function is_valid_for_cart() {
return apply_filters( 'woocommerce_coupon_is_valid_for_cart', $this->is_type( wc_get_cart_coupon_types() ), $this );
}
/**
* Check if a coupon is valid for a product.
*
* @param WC_Product $product Product instance.
* @param array $values Values.
* @return bool
*/
public function is_valid_for_product( $product, $values = array() ) {
if ( ! $this->is_type( wc_get_product_coupon_types() ) || ! is_a( $product, WC_Product::class ) ) {
return apply_filters( 'woocommerce_coupon_is_valid_for_product', false, $product, $this, $values );
}
$valid = false;
$product_cats = wc_get_product_cat_ids( $product->is_type( ProductType::VARIATION ) ? $product->get_parent_id() : $product->get_id() );
$product_ids = array( $product->get_id(), $product->get_parent_id() );
// Specific products get the discount.
if ( count( $this->get_product_ids() ) && count( array_intersect( $product_ids, $this->get_product_ids() ) ) ) {
$valid = true;
}
// Category discounts.
if ( count( $this->get_product_categories() ) && count( array_intersect( $product_cats, $this->get_product_categories() ) ) ) {
$valid = true;
}
// No product ids - all items discounted.
if ( ! count( $this->get_product_ids() ) && ! count( $this->get_product_categories() ) ) {
$valid = true;
}
// Specific product IDs excluded from the discount.
if ( count( $this->get_excluded_product_ids() ) && count( array_intersect( $product_ids, $this->get_excluded_product_ids() ) ) ) {
$valid = false;
}
// Specific categories excluded from the discount.
if ( count( $this->get_excluded_product_categories() ) && count( array_intersect( $product_cats, $this->get_excluded_product_categories() ) ) ) {
$valid = false;
}
// Sale Items excluded from discount.
if ( $this->get_exclude_sale_items() && $product->is_on_sale() ) {
$valid = false;
}
return apply_filters( 'woocommerce_coupon_is_valid_for_product', $valid, $product, $this, $values );
}
/**
* Converts one of the WC_Coupon message/error codes to a message string and.
* displays the message/error.
*
* @param int $msg_code Message/error code.
* @param string $notice_type Notice type.
* @return void
*/
public function add_coupon_message( $msg_code, $notice_type = 'success' ) {
if ( $msg_code < 200 ) {
$msg = $this->get_coupon_error( $msg_code );
$notice_type = 'error';
} else {
$msg = $this->get_coupon_message( $msg_code );
}
if ( empty( $msg ) ) {
return;
}
// Since coupon validation is done multiple times (e.g. to ensure a valid cart), we need to check for dupes.
if ( wc_has_notice( $msg, $notice_type ) ) {
return;
}
wc_add_notice( $msg, $notice_type );
}
/**
* Map one of the WC_Coupon message codes to a message string.
*
* @param integer $msg_code Message code.
* @return string Message/error string.
*/
public function get_coupon_message( $msg_code ) {
switch ( $msg_code ) {
case self::WC_COUPON_SUCCESS:
$msg = __( 'Coupon code applied successfully.', 'woocommerce' );
break;
case self::WC_COUPON_REMOVED:
$msg = __( 'Coupon code removed successfully.', 'woocommerce' );
break;
default:
$msg = '';
break;
}
return apply_filters( 'woocommerce_coupon_message', $msg, $msg_code, $this );
}
/**
* Map one of the WC_Coupon error codes to a message string.
*
* @param int $err_code Message/error code.
* @return string Message/error string
*/
public function get_coupon_error( $err_code ) {
switch ( $err_code ) {
case self::E_WC_COUPON_INVALID_FILTERED:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Coupon "%s" cannot be applied because it is not valid.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_NOT_EXIST:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Coupon "%s" cannot be applied because it does not exist.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_INVALID_REMOVED:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Sorry, it seems the coupon "%s" is invalid - it has now been removed from your order.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_NOT_YOURS_REMOVED:
// We check for supplied billing email. On shortcode, this will be present for checkout requests.
$billing_email = \Automattic\WooCommerce\Utilities\ArrayUtil::get_value_or_default( $_POST, 'billing_email' ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
if ( ! is_null( $billing_email ) ) {
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Please enter a valid email to use coupon code "%s".', 'woocommerce' ),
esc_html( $this->get_code() )
);
} else {
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Please enter a valid email at checkout to use coupon code "%s".', 'woocommerce' ),
esc_html( $this->get_code() )
);
}
break;
case self::E_WC_COUPON_ALREADY_APPLIED:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Coupon code "%s" already applied!', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_ALREADY_APPLIED_INDIV_USE_ONLY:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Sorry, coupon "%s" has already been applied and cannot be used in conjunction with other coupons.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_USAGE_LIMIT_REACHED:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Usage limit for coupon "%s" has been reached.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_EXPIRED:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Coupon "%s" has expired.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_MIN_SPEND_LIMIT_NOT_MET:
$allowed_tags = array(
'span' => array(
'class' => true,
),
'bdi' => true,
'small' => true,
);
$err = sprintf(
/* translators: %1$s: coupon code, %2$s: coupon minimum amount */
esc_html__( 'The minimum spend for coupon "%1$s" is %2$s.', 'woocommerce' ),
esc_html( $this->get_code() ),
wp_kses( wc_price( $this->get_minimum_amount() ), $allowed_tags )
);
break;
case self::E_WC_COUPON_MAX_SPEND_LIMIT_MET:
$allowed_tags = array(
'span' => array(
'class' => true,
),
'bdi' => true,
'small' => true,
);
$err = sprintf(
/* translators: %1$s: coupon code, %2$s: coupon maximum amount */
esc_html__( 'The maximum spend for coupon "%1$s" is %2$s.', 'woocommerce' ),
esc_html( $this->get_code() ),
wp_kses( wc_price( $this->get_maximum_amount() ), $allowed_tags )
);
break;
case self::E_WC_COUPON_NOT_APPLICABLE:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Sorry, coupon "%s" is not applicable to your cart contents.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_USAGE_LIMIT_COUPON_STUCK:
if ( is_user_logged_in() && wc_get_page_id( 'myaccount' ) > 0 && ! WC()->is_store_api_request() ) {
$err = sprintf(
/* translators: %1$s: coupon code, %2$s: myaccount page link. */
wp_kses_data( __( 'Usage limit for coupon "%1$s" has been reached. If you were using this coupon just now but your order was not complete, you can retry or cancel the order by going to the
my account page.', 'woocommerce' ) ),
esc_html( $this->get_code() ),
esc_attr( wc_get_endpoint_url( 'orders', '', wc_get_page_permalink( 'myaccount' ) ) )
);
} else {
$err = $this->get_coupon_error( self::E_WC_COUPON_USAGE_LIMIT_REACHED );
}
break;
case self::E_WC_COUPON_USAGE_LIMIT_COUPON_STUCK_GUEST:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Usage limit for coupon "%s" has been reached. Please try again after some time, or contact us for help.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
case self::E_WC_COUPON_EXCLUDED_PRODUCTS:
// Store excluded products that are in cart in $products.
$products = array();
if ( ! WC()->cart->is_empty() ) {
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
if ( in_array( intval( $cart_item['product_id'] ), $this->get_excluded_product_ids(), true ) || in_array( intval( $cart_item['variation_id'] ), $this->get_excluded_product_ids(), true ) || in_array( intval( $cart_item['data']->get_parent_id() ), $this->get_excluded_product_ids(), true ) ) {
$products[] = $cart_item['data']->get_name();
}
}
}
$err = sprintf(
/* translators: %1$s: coupon code, %2$s: products list */
esc_html__( 'Sorry, coupon "%1$s" is not applicable to the products: %2$s.', 'woocommerce' ),
esc_html( $this->get_code() ),
esc_html( implode( ', ', $products ) )
);
break;
case self::E_WC_COUPON_EXCLUDED_CATEGORIES:
// Store excluded categories that are in cart in $categories.
$categories = array();
if ( ! WC()->cart->is_empty() ) {
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$product_cats = wc_get_product_cat_ids( $cart_item['product_id'] );
$intersect = array_intersect( $product_cats, $this->get_excluded_product_categories() );
if ( count( $intersect ) > 0 ) {
foreach ( $intersect as $cat_id ) {
$cat = get_term( $cat_id, 'product_cat' );
$categories[] = $cat->name;
}
}
}
}
$err = sprintf(
/* translators: "%1$s": coupon code, %2$s: categories list */
esc_html__( 'Sorry, coupon "%1$s" is not applicable to the categories: %2$s.', 'woocommerce' ),
esc_html( $this->get_code() ),
esc_html( implode( ', ', array_unique( $categories ) ) )
);
break;
case self::E_WC_COUPON_NOT_VALID_SALE_ITEMS:
$err = sprintf(
/* translators: %s: coupon code */
esc_html__( 'Sorry, coupon "%s" is not valid for sale items.', 'woocommerce' ),
esc_html( $this->get_code() )
);
break;
default:
$err = '';
break;
}
return apply_filters( 'woocommerce_coupon_error', $err, $err_code, $this );
}
/**
* Map one of the WC_Coupon error codes to an error string.
* No coupon instance will be available where a coupon does not exist,
* so this static method exists.
*
* @param int $err_code Error code.
* @return string Error string.
*/
public static function get_generic_coupon_error( $err_code ) {
switch ( $err_code ) {
case self::E_WC_COUPON_NOT_EXIST:
$err = __( 'Coupon does not exist.', 'woocommerce' );
break;
case self::E_WC_COUPON_PLEASE_ENTER:
$err = __( 'Please enter a coupon code.', 'woocommerce' );
break;
default:
$err = '';
break;
}
// When using this static method, there is no $this to pass to filter.
return apply_filters( 'woocommerce_coupon_error', $err, $err_code, null );
}
/**
* Get the coupon information that is needed to reapply the coupon to an existing order.
* This information is intended to be stored as a meta value in the order line item corresponding to the coupon
* and should NOT be modified or extended (additional/custom data should go in a separate metadata entry).
*
* The information returned is a JSON-encoded string of an array with the following coupon information:
*
* 0: Id
* 1: Code
* 2: Type, null is equivalent to 'fixed_cart'
* 3: Nominal amount (either a fixed amount or a percent, depending on the coupon type)
* 4: The coupon grants free shipping? (present only if true)
*
* @return string A JSON string with information that allows the coupon to be reapplied to an existing order.
*/
public function get_short_info(): string {
$type = $this->get_discount_type();
$info = array(
$this->get_id(),
$this->get_code(),
'fixed_cart' === $type ? null : $type,
(float) $this->get_prop( 'amount' ),
);
if ( $this->get_free_shipping() ) {
$info[] = true;
}
return wp_json_encode( $info );
}
/**
* Parse short info JSON into an array of coupon properties without validation.
*
* @param string $info JSON string as returned by 'get_short_info'.
* @return array {
* Parsed coupon properties.
*
* `@type` int $id Coupon ID.
* `@type` string $code Coupon code.
* `@type` string $discount_type Discount type ('fixed_cart', 'percent', etc.).
* `@type` float $amount Discount amount.
* `@type` bool $free_shipping Whether free shipping is enabled.
* }
*/
private static function parse_short_info( string $info ): array {
$data = json_decode( $info, true );
if ( ! is_array( $data ) ) {
$data = array();
}
return array(
'id' => $data[0] ?? 0,
'code' => $data[1] ?? '',
'discount_type' => $data[2] ?? 'fixed_cart',
'amount' => (float) ( $data[3] ?? 0 ),
'free_shipping' => (bool) ( $data[4] ?? false ),
);
}
/**
* Sets the coupon parameters from a reapply information set generated with 'get_short_info'.
*
* @param string $info JSON string with reapply information as returned by 'get_short_info'.
* @return void
*/
public function set_short_info( string $info ) {
$data = self::parse_short_info( $info );
$this->set_id( $data['id'] );
$this->set_code( $data['code'] );
$this->set_discount_type_core( $data['discount_type'], false );
$this->set_amount( $data['amount'] );
$this->set_free_shipping( $data['free_shipping'] );
}
/**
* Create a WC_Coupon instance from an order's coupon line item without validation.
*
* This is useful for read-only contexts (e.g., REST API responses) where the stored
* data should be returned even if it contains invalid values.
*
* @since 10.6.0
*
* @param \WC_Order_Item_Coupon $order_item The coupon line item from an order.
* @return self A WC_Coupon instance populated with the stored data.
*/
public static function from_order_item( \WC_Order_Item_Coupon $order_item ): self {
$coupon_info = $order_item->get_meta( 'coupon_info', true );
if ( is_string( $coupon_info ) && '' !== $coupon_info ) {
$data = self::parse_short_info( $coupon_info );
} else {
$coupon_meta = $order_item->get_meta( 'coupon_data', true );
if ( is_object( $coupon_meta ) || is_array( $coupon_meta ) ) {
$coupon_meta = (array) $coupon_meta;
$data = array(
'id' => 0,
'code' => '',
'discount_type' => $coupon_meta['discount_type'] ?? 'fixed_cart',
'amount' => (float) ( $coupon_meta['amount'] ?? 0 ),
'free_shipping' => (bool) ( $coupon_meta['free_shipping'] ?? false ),
);
} else {
return new self();
}
}
$coupon = new self();
$coupon->set_id( $data['id'] );
$coupon->set_code( $data['code'] );
$coupon->set_discount_type_core( $data['discount_type'], false );
$coupon->set_prop( 'amount', $data['amount'] );
$coupon->set_free_shipping( $data['free_shipping'] );
return $coupon;
}
/**
* Returns alternate error messages based on context (eg. Cart and Checkout).
*
* @param int $err_code Message/error code.
*
* @return array Context based alternate error messages.
*/
public function get_context_based_coupon_errors( $err_code = null ) {
switch ( $err_code ) {
case self::E_WC_COUPON_NOT_YOURS_REMOVED:
return array(
'cart' => sprintf(
/* translators: %s: coupon code */
esc_html__( 'Please enter a valid email at checkout to use coupon code "%s".', 'woocommerce' ),
esc_html( $this->get_code() )
),
'checkout' => sprintf(
/* translators: %s: coupon code */
esc_html__( 'Please enter a valid email to use coupon code "%s".', 'woocommerce' ),
esc_html( $this->get_code() )
),
);
default:
return array();
}
}
}