=  SMNTCS Free Gift for WooCommerce =

Contributors:       nielslange
Tags:               WooCommerce Gift, Free Gift
Stable tag:         1.9
Tested up to:       6.8
Requires PHP:       7.4
Requires at least:  3.0
License:            GPL v2 or later
License URI:        https://www.gnu.org/licenses/gpl-2.0.html

Give free gifts to your WooCommerce customers.

== Description ==

SMNTCS Free Gift for WooCommerce is a lightweight plugin to give away free gifts to your WooCommerce customers.

== Installation ==

1. Upload the plugin to the `/wp-content/plugins/` directory.
2. Activate the plugin through the `Plugins` menu in WordPress.
3. Go to `Appearance` » `Customize`.
4. Enable free gifts.
5. Adjust settings based on your needs.

== Frequently Asked Questions ==

= How do I enable free gifts? =

1. Go to `Products` » `Categories` and create a category for the gifts, e.g. Gift.
2. Go to `Products` » `Add Product` and create your gift product.
3. Make sure to set the `Regular price` to 0 and the `Catalog visibility` to `Hidden`.
4. Go to `Appearance` » `Customise` » `Customise`.
5. Activate the checkbox `Enable free gift`.
6. Provide the `Minimum cart value`, e.g. 10.00.
7. Select the `Gift category`.
8. Provide a message for `Message "Proceed shopping"`.
9. Provide a message for `Button "Proceed shopping"`.
10. Provide a message for `Message "Add gift"`.
11. Provide a message for `Button "Add gift"`.
12. Click on `Save & Publish`.

= Can I create multiple gifts? =

Yes, you can create multiple gifts.

= I have multiple gifts set up. Can my customers choose their gift? =

No, at the moment a random gift will be assigned.

== Screenshots ==

1. Setting within the Customizer
2. Message when total order amount is to low
3. Message when total order amount is above the minimum value
4. Gift that has been added to the cart by the user

== Changelog ==

= 1.9 (2025.03.23) =

- Test up to WordPress 6.8

= 1.8 (2023.10.15) =

- Test up to WordPress 6.4

= 1.7 (2022.12.03) =

- Test up to WordPress 6.1

= 1.6 (2020.04.14) =

- [Add check if WooCommerce is installed](https://github.com/nielslange/smntcs-woocommerce-free-gift/issues/14)
- [Move settings into WooCommerce customizer](https://github.com/nielslange/smntcs-woocommerce-free-gift/issues/12)

= 1.5 (2020.04.07) =

- [Declaring required and supported WooCommerce version](https://github.com/nielslange/smntcs-woocommerce-free-gift/issues/9)
- Test up to WordPress 5.4

= 1.4 (2019.11.18) =

- Test up to WordPress 5.3

= 1.3 (2019.06.28) =

- Test up to WordPress 5.2

= 1.2 (2019.02.19) =

- Add README.md
- Test up to WordPress 5.0

= 1.1 (2016.07.22) =

- Save settings as option, not as theme_mod

= 1.0 (2016.07.20) =

- Initial release
