=== WooCommerce Multiple Free Gift ===
Contributors: ankitpokhrel, ncreep
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=J9FVY3ESPPD58
Tags: woocommerce, woocommerce free gift, woocommerce gift management, woocommerce multiple gifts, woocommerce multiple free gifts, woocommerce gift manager, woocommerce plugin, woocommerce freebies, woocommerce prizes
Requires at least: 3.8
Tested up to: 4.4
WC requires at least: 2.3
WC tested up to: 2.4.6
Stable tag: 1.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

WooCommerce giveaway made easy. Best way to offer freebies, gifts or prizes.

== Description ==
Gift giving is one of the best ways for marketing. This way creates good vibes and your customers will come back more often.  

WooCommerce Multiple Free Gift Plugin is a WordPress WooCommerce plugin that makes gift management easy for your woocommerce site. The plugin helps you offer free products or gifts to your customer when they purchase products at your store. WooCommerce Multiple Free Gift plugin - gives you an edge by allowing you to write your own gift conditions which gives you great control on how you want to provide gifts to your customer.

> **A NOTE ABOUT SUPPORT:** We’re here to help troubleshoot bugs, but please don't set expectations early as the support forums at WordPress.org are only checked every two days.

> Users looking for more timely/in-depth support and extended features are encouraged to check out [WooCommerce Multiple Free Gift Plugin PRO](http://ankitpokhrel.com.np/blog/downloads/woocommerce-multiple-free-gift-plugin-pro/ "WooCommerce Multiple Free Gift PRO").

> **FEATURES OF PRO VERSION**  
  – All features of basic version.  
  – Write your own rules.  
  – Rule can be from very simple to highly complex.  
  – You can write multiple fallback condition for gifts.  
  – If condition A isn’t fulfilled the plugin will check for next condition and so on.  
  - Automatic gift addition.  
  - Multiple themes.  
  - Option to exclude sales and tax amount from calculation.  
  – Priority support.  
  – Access to more advance features and future updates for free.  

> [Learn more &raquo;](http://ankitpokhrel.com.np/blog/downloads/woocommerce-multiple-free-gift-plugin-pro/ "WooCommerce Multiple Free Gift PRO")

**Overview**  
WooCommerce Multiple Free Gift Plugin enables the option to provide gifts to your customer. Gift Giving is one of the best ways for marketing. This way creates good vibes and your Customers will come back more often. With WooCommerce Multiple Free Gift Plugin you can provide gifts to your customer based on single or multiple products.

**Features**  

1. Gift based on single or particular product
    - Provide gift when only one item is added to the cart.  
    - BOGO (Buy one get one)  
    - Buy X get Y free  
    - Buy X get many free gifts (Y,Z...free)  
2. Choose number of gifts allowed
  - Allow 1 or N number of gifts without any problem.
3. Gift Criteria
  - Allow gifts based on total items in cart and total cart price.
  - Purchase over X USD get X free
  - Purchase over X USD get many free gifts (X, Y... free)
  - Purchase N number of items get X free
  - Purchase N number of items get many free gifts (X, Y... free)
4. Global gifts
  - Give gift for anything added in the cart.
5. Custom promotion message
6. Customization and translation ready
7. Loco translate compatible
8. Aelia Currency Converter compatible
9. Tested with over half million products

**How it works?**  
1. After successfull plugin activation go to `Woo Free Gift` settings page or product edit page.  
2. If you are in `Woo Free Gift` page, go to gift criteria first to add your condition, in main settings enable free gift and choose number of gifts allowed and gifts to show.  
3. If you are in product edit page, scroll down to products data section and go to `Free Gift Options` tab.  
4. You can enable free gift for a particular product from this page. Enable free gift and choose number of gifts allowed and gifts to show.  
5. Save.  
6. At frontend, add some products and go to cart page. You will notice a popup with gift products to add.

**Contribute**  
If you'd like to check out the code and contribute, join us on [Github](https://github.com/ankitpokhrel/WooCommerce-Multiple-Free-Gift/ "View this plugin in github"). Pull requests, issues, and plugin recommendations are more than welcome!

**Want more? Watch the demo of PRO version**  
https://www.youtube.com/watch?v=z5ZnYj1TH_8

== Installation ==

1. Unzip and upload the `woocommerce-multiple-free-gift-plugin` directory to the plugin directory (`/wp-content/plugins/`) or install it from `Plugins->Add New->Upload`.  
2. Activate the plugin through the `Plugins` menu in WordPress.  
3. That's all you need to do. You will notice Woo Free Gift settings page in the admin.  

== Frequently Asked Questions ==
= 1. How many gifts can I add? =
You can add as many gifts as you want. There is no limit to this.

= 2. How many gifts are allowed to select? =
You can define how many gifts you want to allow users to select from admin settings page. Users are allowed to select 1 gift by default.

= 3. Can I provide gifts based on total quantity or price? =
Yes, you can provide gifts based on total quantity or price. PRO version allows you to write your own rules. Rules can be very simple to highly complex.

= 4. Other problems or questions? =
Other problems? Don't forget to check the [blog](http://ankitpokhrel.com.np/blog/) or contact through support forum.

Please use [support forum](http://wordpress.org/support/plugin/woocommerce-free-gift-plugin) first if you have any question or queries about the project.  
If you don't receive any help in support forum then you can directly contact me at `info [at] ankitpokhrel.com.np`. Please atleast wait for 48hrs before sending another request.

Please feel free to report any bug found to `info [at] ankitpokhrel.com.np`.

== Screenshots == 
1. Gift criteria
2. Global gift page.
3. Single gift page.
4. General settings page.
5. Gifts shown in frontend.

== Changelog ==
= 1.1.0 =
* Now works with large number of products (fixes issue #1).
* Tested with over half million products.
* Compatible with Aelia Currency Switcher plugin (thanks to Diego Zanella).
* Remove the evil eval.
* Brazilian Portugese translation (thanks to Paula Bambino).
* Design improvements.
* Special thanks to Cory Jeffries for his contributions.

= 1.0.1 =
* Fix issue with remove gift button on first use
* Fix plugin text domain issue
* Enhancement: Loco translate compatible
* Fix info message design when no product is present

= 1.0.0 =
* Gift criteria based on total quantity and price.

= 0.0.0 =
* Initial release.

== Upgrade Notice ==
= 1.1.0 =
* This is a major update. Upgrade with caution.

= 1.0.1 =
* One of the library file name is changed which may cause some error. It would be better to remove previous files completely and add new one.

= 1.0.0 =
* You can now add a single gift criteria based on total quantity and price.

= 0.0.0 =
* First release.
