From fc5f199906cdb655a61e8900e040f02346e22ed7 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosanches.com>
Date: Thu, 27 Jul 2017 11:45:42 -0300
Subject: [PATCH] Deprecated WC_Coupon validation methods

---
 includes/class-wc-coupon.php | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/includes/class-wc-coupon.php b/includes/class-wc-coupon.php
index 16cbb28ec0a..4217a65d311 100644
--- a/includes/class-wc-coupon.php
+++ b/includes/class-wc-coupon.php
@@ -763,6 +763,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon exists or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_exists.
 	 * @throws Exception
 	 */
 	private function validate_exists() {
@@ -774,6 +775,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon usage limit is valid or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_usage_limit.
 	 * @throws Exception
 	 */
 	private function validate_usage_limit() {
@@ -788,6 +790,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	 * Per user usage limit - check here if user is logged in (against user IDs).
 	 * Checked again for emails later on in WC_Cart::check_customer_coupons().
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_user_usage_limit.
 	 * @param  int  $user_id
 	 * @throws Exception
 	 */
@@ -806,6 +809,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon date is valid or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_expiry_date.
 	 * @throws Exception
 	 */
 	private function validate_expiry_date() {
@@ -817,6 +821,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon amount is valid or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_minimum_amount.
 	 * @throws Exception
 	 */
 	private function validate_minimum_amount() {
@@ -828,6 +833,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon amount is valid or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_maximum_amount.
 	 * @throws Exception
 	 */
 	private function validate_maximum_amount() {
@@ -839,6 +845,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon is valid for products in the cart is valid or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_product_ids.
 	 * @throws Exception
 	 */
 	private function validate_product_ids() {
@@ -860,6 +867,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon is valid for product categories in the cart is valid or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_product_categories.
 	 * @throws Exception
 	 */
 	private function validate_product_categories() {
@@ -887,6 +895,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Ensure coupon is valid for sale items in the cart is valid or throw exception.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_sale_items.
 	 * @throws Exception
 	 */
 	private function validate_sale_items() {
@@ -910,6 +919,9 @@ class WC_Coupon extends WC_Legacy_Coupon {
 
 	/**
 	 * All exclusion rules must pass at the same time for a product coupon to be valid.
+	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_excluded_items.
+	 * @throws Exception
 	 */
 	private function validate_excluded_items() {
 		if ( ! WC()->cart->is_empty() && $this->is_type( wc_get_product_coupon_types() ) ) {
@@ -930,6 +942,8 @@ class WC_Coupon extends WC_Legacy_Coupon {
 
 	/**
 	 * Cart discounts cannot be added if non-eligible product is found in cart.
+	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_eligible_items.
 	 */
 	private function validate_cart_excluded_items() {
 		if ( ! $this->is_type( wc_get_product_coupon_types() ) ) {
@@ -941,10 +955,11 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Exclude products from cart.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_excluded_product_ids.
 	 * @throws Exception
 	 */
 	private function validate_cart_excluded_product_ids() {
-		// Exclude Products
+		// Exclude Products.
 		if ( sizeof( $this->get_excluded_product_ids() ) > 0 ) {
 			$valid_for_cart = true;
 			if ( ! WC()->cart->is_empty() ) {
@@ -963,6 +978,7 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Exclude categories from cart.
 	 *
+	 * @deprecated 3.2.0 In favor of WC_Discounts->validate_coupon_excluded_product_categories.
 	 * @throws Exception
 	 */
 	private function validate_cart_excluded_product_categories() {
@@ -989,10 +1005,13 @@ class WC_Coupon extends WC_Legacy_Coupon {
 	/**
 	 * Check if a coupon is valid.
 	 *
-	 * @return boolean validity
+	 * @deprecated 3.2.0 In favor of WC_Discounts->is_coupon_valid.
 	 * @throws Exception
+	 * @return bool Validity.
 	 */
 	public function is_valid() {
+		wc_deprecated_function( 'is_valid', '3.2', 'WC_Discounts->is_coupon_valid' );
+
 		try {
 			$this->validate_exists();
 			$this->validate_usage_limit();