=== Spin Rewards for WooCommerce ===
Contributors: cosmicinfosoftware
Requires at least: 5.2
Tested up to: 6.8
Requires PHP: 7.4
WC requires at least: 5.0
WC tested up to: 10.1.0
Stable tag: 1.0.1
Version: 1.0.1
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: woocommerce, spin wheel, coupons, discounts, spin rewards

Grow sales and email signups with a customizable spin‑the‑wheel game that instantly awards discount coupons in WooCommerce.

== Description ==

**Spin Rewards for WooCommerce** adds an engaging spin‑the‑wheel experience to your store. Encourage visitors to play, win discounts, and shop immediately. Fully customizable design, slides, and reward probabilities, plus automated coupon creation, email collection, and detailed reports.
Designed to be lightweight, extensible, and theme‑compatible.

== Presentation ==

[**Demo**](https://plugins.cosmicinfosoftware.com/spin-rewards-for-woocommerce/) | [**Documentation**](https://documentation.cosmicinfosoftware.com/spin-rewards-for-woocommerce/documents/getting-started/)

== Key Features ==

⭐ Enable/disable the spin wheel globally
⭐ Collect email before spin with per-email spin limits
⭐ Customizable wheel design: pointer color, center color, background color, text color
⭐ Customizable wheel slices: labels, discount types (percentage/fixed), amounts, and win probability
⭐ Offer instant discount coupons to winners (auto‑generated via WooCommerce)
⭐ GDPR-Friendly: optional GDPR checkbox with customizable consent message
⭐ Coupon settings: type (percentage/fixed), length, prefix, suffix, expiry (in days), usage limits, minimum/maximum spend, include/exclude products & categories, free shipping, individual use, exclude sale items
⭐ Win/lose messages with placeholders: {coupon_label}, {checkout}
⭐ Automatic display of won coupon code after spin Detailed spin records and reports in admin panel
⭐ Display rules: show on shop, home, blog pages via toggle
⭐ Conditional display using WordPress tags: is_cart(), is_checkout(), is_product(), is_shop(), etc. with operators (||, &&, !)
⭐ Developer-friendly: template override support
⭐ Responsive popup with customizable title, spin button text, and close button Customizable spin button: text color, background, hover color, border radius
⭐ Customizable close button: text, font size, colors
⭐ Background blend mode support
⭐ Wheel pointer center position with color customization
⭐ Spin speed control (1–4 levels)
⭐ Auto-hide wheel after spin (in seconds)
⭐ Show/hide close button
⭐ Email notifications for winners (customer)
⭐ Klaviyo Email & SMS Integration
⭐ Validation messages: name, email, mobile, GDPR, spin limit, wait time
⭐ Localization: fully translatable frontend texts, validation messages, button labels
⭐ Error message styling: color and font size
⭐ Frontend popup spin wheel with responsive, theme‑friendly UI

== Installation ==

1. Download the plugin ZIP.
2. Log in to your WordPress dashboard and go to Plugins > Add New.
3. Click Upload Plugin, choose the ZIP, and click Install Now.
4. Activate the plugin.
5. Navigate to WooCommerce > Spin Rewards to configure design, prizes, and behavior.

== External Services ==

This plugin includes the following open-source libraries and third-party integrations:

1. **[Select2](https://select2.org/)**  
   A jQuery-based replacement for select boxes that supports searching, tagging, remote data sets, and infinite scrolling.  
   **License:** MIT

2. **[Mailchimp](https://mailchimp.com/)**  
   Email marketing and automation platform used for email list management and subscriber integration.  
   **License:** Proprietary (Third-party service)

== Usage ==

* Customers: See the spin wheel popup on the storefront (based on your display rules). Enter email (if enabled), spin, and receive a coupon if they win.
* Admins: Configure wheel design, slides, rewards, coupon behavior, localization, and notifications under WooCommerce > Spin Rewards. Review spins and performance in Reports.

== Frequently Asked Questions ==

= Can I customize the wheel design and slices? =
Yes. You can configure colors, labels, number of slices, and probabilities.

= How are coupons generated? =
When a customer wins, the plugin can automatically create WooCommerce coupons based on your settings (type, amount, prefix/suffix, length, usage limits, and expiry).

= Can I collect emails before spinning? =
Yes. You can require email entry and control spin limits to reduce abuse.

= Will it work with my theme? =
The plugin is theme‑friendly and follows WooCommerce standards. You may override plugin templates in your theme if needed.

= Are email notifications included? =
Yes. The plugin includes winner notifications for customers and optional admin alerts.

= Does it support HPOS (High‑Performance Order Storage)? =
Yes. The plugin is compatible with WooCommerce HPOS.

== Screenshots ==

1. Frontend
2. General setting
3. Spin popup setting
4. Spin reward setting
5. Wheel slides setting
6. Spin wheel design configuration
7. Offer coupon setting
8. Notification setting
9. Email API and marketing tool setting
10. String localization setting
11. Spin reward record list
12. Spin rewards reports

== Changelog ==

= 1.0.0 =
* Initial release.
* Popup spin wheel with customizable design and slices.
* Automatic WooCommerce coupon creation for winners.
* Email collection and per‑email spin limits.
* Localization and notification settings.
* Spin records and reports for admins.

= 1.0.1 =
* Compatibility with WordPress 7.0

== Upgrade Notice ==

= 1.0.0 =
Initial release of Spin Rewards for WooCommerce.

= 1.0.1 =
* Compatibility with WordPress 7.0
