=== Free Gift for WooCommerce ===
Contributors: vishitshah
Tags: woocommerce, woocommerce gift, free gift, gift, free product
Requires at least: 5.2
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.1
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

== Description ==
Boost your WooCommerce store's conversions by offering automatic free gifts! This plugin lets you reward customers with free products based on cart conditions.

**Key Features:**
- 🎁 Add multiple free gifts to customer orders automatically
- 🔐 Restrict gifts to logged-in users only
- 💰 Set minimum cart amount requirements for gifts
- 🏷️ Display "Free Gift" labels in the cart
- 🔢 Set different quantities for each gift product
- 🛒 Fully compatible with WooCommerce cart system

Perfect for running promotions, rewarding loyal customers, or increasing average order values. Tested with Storefront theme and latest WooCommerce versions.

= Short Description =
Automatically add free gifts to WooCommerce carts based on customizable conditions like order amount or customer status.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/free-gift-for-woocommerce` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Configure the plugin settings under WooCommerce -> Settings -> Free Gift tab

== Frequently Asked Questions ==

= How to set the free gift(s)? =
- Open `WooCommerce - Settings - Free Gift (tab)` in WordPress admin panel.
- Specify the product IDs to be the gifts, separated a coma, and appropriate gifts quantity.
For example, if you set the ‘Product IDs’ field as `45,112,62` and ‘Quantity’ field as `3,2,1` you will present to your customer 3 products with IDs `45,112,62`.
The first gift (product) will have the quantity 3 pcs., the second – 2 pcs., and the last one – 1 pcs.
- Setup other conditions (show only for authorized users, show labels in cart) if you need them.

= How to hide gifts from catalog? =
- Select the product that you want to be a gift.
- In the section 'Publish' (to the right of the title) click the 'Edit' link next to 'Catalog visibility' and chose the 'Hidden' option.
 Update the product.

= How to know a product ID? =
[Read the article](https://docs.woocommerce.com/document/find-product-category-ids/)

== Screenshots ==

1. Cart.
2. Settings.

== Changelog ==

= 1.1 =
* Compatibility with WordPress 6.8
* Compatibility with WooCommerce 9.8.1

= 0.0.4 =
* Added condition for minimal order amount.

= 0.0.3 =
* Now you can choose several products for the free gift.
* Give the gifts only for authorized users.
* Show 'Free Gift' labels for the gifts in cart.
* Check compatibility with WordPress 5.5.1 and WooCommerce 4.4.1.