Required Products Coupons for WooCommerce

This plugin allows you to restrict the usage of WooCommerce coupons unless specific products or variations are in the cart.

You can specify which products are required for a coupon to be valid, providing more control over your discount strategies.

Features

• Restrict coupon usage based on all required products (including variations) being in the cart.
• Customize the error message via a filter.

Filters

runthings_wc_coupons_required_products_missing_products

This filter allows third-party plugins to alter the missing required products before the coupon is rejected.

For detailed documentation and advanced examples, see the full documentation on GitHub.

Parameters:

1. $missing_products (array): The missing products in the cart, in the format [product_id => quantity].
2. $coupon (WC_Coupon): The coupon object being validated.
3. $required_products (array): The required products for the coupon, in the format [product_id => quantity].
4. $cart_products (array): Products found in the cart, in the format [product_id => quantity].
5. $cart (WC_Cart): The cart instance.

runthings_wc_coupons_required_products_error_message

This filter allows customization of the error message shown when a coupon is not valid due to missing required products.

For detailed documentation and advanced examples, see the full documentation on GitHub.

Parameters:

1. $message (string): The default error message, e.g., "This coupon requires specific products in the cart.".
2. $coupon (WC_Coupon): The coupon object being validated.
3. $required_products (array): The required products for the coupon, in the format [product_id => quantity].
4. $missing_products (array): The missing products in the cart, in the format [product_id => quantity].

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see http://www.gnu.org/licenses/gpl-3.0.html.

Icon – Discount by Gregor Cresnar, from Noun Project, https://thenounproject.com/browse/icons/term/discount/ (CC BY 3.0)

Icon – restriction by Puspito, from Noun Project, https://thenounproject.com/browse/icons/term/restriction/ (CC BY 3.0)