=== Product Attribute Filter for Coupons ===
Contributors: cgaeking
Tags: coupon, coupons, attribute, gutschein, gutscheine
Requires at least: 5.8
Tested up to: 6.8
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 9.8.5

A simple WooCommerce extension to restrict coupons to specific product attributes.

== Description ==

Do you want more control over your WooCommerce coupons? By default, you can restrict coupons to products or categories, but not to specific product attributes like "Color: Blue" or "Size: Large".

**WooCommerce Attribute Coupons** solves this problem by adding a simple but powerful new restriction rule to your coupon settings.

**Key Features:**

* **Seamless Integration:** Adds new fields directly into the "Usage Restriction" tab on the coupon edit screen.
* **Attribute Selection:** Choose any globally defined product attribute (e.g., Color, Size, Brand).
* **Attribute Value Selection:** After selecting an attribute, choose a specific value (e.g., Blue, Large, Nike).
* **Smart Validation:** The coupon will only be valid if a product with the selected attribute and value is present in the customer's cart.
* **User-Friendly:** The setup is intuitive and requires no coding knowledge.

This plugin is perfect for targeted promotions, such as offering a discount on all red t-shirts or clearing out inventory of a specific product variant.

== Installation ==

You can install this plugin directly from your WordPress dashboard:

1.  Go to 'Plugins' > 'Add New'.
2.  Search for "WooCommerce Attribute Coupons".
3.  Click 'Install Now' and then 'Activate'.

Alternatively, you can install it manually:

1.  Download the plugin .zip file from WordPress.org.
2.  Go to 'Plugins' > 'Add New' > 'Upload Plugin' in your WordPress dashboard.
3.  Upload the .zip file and click 'Activate'.

**Usage:**

1.  Go to 'Marketing' > 'Coupons'.
2.  Create a new coupon or edit an existing one.
3.  Navigate to the 'Usage restriction' tab.
4.  You will find two new fields: "Product attribute restriction" and "Attribute value restriction".
5.  Select an attribute and a value, then save the coupon.

== Frequently Asked Questions ==

= Does this work with variable products? =

Yes. The plugin checks the attributes of the products in the cart. If a specific variation with the required attribute is in the cart, the coupon will be considered valid.

= Can I add multiple attribute rules to a single coupon? =

In the current version (1.0.0), you can only set one attribute rule per coupon (e.g., "Color: Blue"). Support for multiple or combined rules may be considered for future versions.

= Which attributes can I use? =

You can use any globally created product attributes. You can manage these under 'Products' > 'Attributes' in your WordPress dashboard.

== Screenshots ==

1.  The new fields for attribute restriction in the coupon admin area.

== Changelog ==

= 1.0.0 =
* Initial release of the plugin.

== Upgrade Notice ==

= 1.0.0 =
* The first version of the plugin. Enjoy the new feature!