=== Complimentary Products Manager For WooCommerce ===
Contributors: maulikvirparia
Tags: woocommerce, complementary products, sample products management, free coupons allocation, product quota
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.0.0
Requires PHP: 7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Manage allocation of complimentary products (free or paid) in your WooCommerce store with comprehensive logs and reporting.

== Description ==

The Complimentary Products Manager For WooCommerce plugin allows store owners to manage complimentary product allocations for specific user roles. It tracks coupon balances, logs transactions, and provides detailed reporting. Key features include:

- Assign complimentary product coupons to users based on roles.
- Display coupon balances on user profiles and via shortcodes.
- Restrict complimentary products to eligible users.
- Comprehensive transaction logging and CSV report downloads.
- Shortcode for displaying coupon balance on the frontend: `[cpmwc_coupon_balance]`.
- Shortcode for displaying coupon balance on the checkout page: `[cpmwc_checkout_coupon_balance]`.

== Installation ==      

1. Upload the `complimentary-products-manager` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to Product Coupons to configure the complimentary product and eligible user roles.
4. Use the `[cpmwc_coupon_balance]` shortcode to display coupon balances on the frontend.
5. Use the `[cpmwc_checkout_coupon_balance]` shortcode to display coupon balances on the checkout page.

== Frequently Asked Questions ==

= What does this plugin do? =
It allows WooCommerce store owners to manage complimentary product allocations, track coupon balances, and generate transaction reports.

= How do I configure the complimentary product? =
Navigate to Product Coupons in the WordPress admin, select a product, and choose eligible user roles.

= Can I display coupon balances on the frontend? =
Yes, use the `[cpmwc_coupon_balance]` shortcode on any page or post, and `[cpmwc_checkout_coupon_balance]` on the checkout page.

== Screenshots ==

1. Admin settings page for configuring the complimentary product and user roles.
2. Transaction history with filtering and CSV download options.
3. User profile section showing coupon balance.
4. Frontend coupon balance display using the shortcode.
5. Checkout page coupon balance display.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release of the plugin.