=== WebEquipe Spin & Win Wheel === Contributors: webequipe, bdsarwar Tags: spin wheel, lucky draw, giveaway, coupon, lead generation Requires at least: 5.7 Tested up to: 7.1 Requires PHP: 8.1 Stable tag: 2.1.0 License: GPL v2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Add a spin-to-win prize wheel that collects emails and shows a prize. Pro adds WooCommerce coupons, themes, spin limits, and analytics. == Description == **WebEquipe Spin & Win Wheel** adds an interactive prize wheel to your WordPress site. Visitors enter their email, spin, and see what they won. You control the prizes, the odds, the design, and where the wheel appears. Every entry is saved to the Winner List. Leads can sync to Mailchimp. The free plugin works on any WordPress site. WooCommerce coupon rewards are part of Pro. [youtube https://www.youtube.com/watch?v=unjPdXyJ_lY] = How to Use = 1. Go to **WebEquipe Spin & Win Wheel → All Wheels → Add New**. 2. Choose **Start from Blank**, add a title, and set the status to **Active**. 3. Open the **Prizes** tab and add rewards and winning chances. The chances must total 100%. 4. Style the wheel in the **Design** tab and check the live preview. 5. Write the win and lose messages in the **Messages** tab and save. 6. Copy the shortcode, for example `[wsww-spin id="1"]`, and paste it on a page. There is no Elementor widget or Gutenberg block. Only one `[wsww-spin]` shortcode can run on a page. A field-by-field guide is under **WebEquipe Spin & Win Wheel → Help**, and online at [webequipe.com/spin-win-wheel/doc](https://webequipe.com/spin-win-wheel/doc/). = Display Options = * **Popup:** The wheel opens after the **First display delay** you set. * **Button Click:** Visitors click a button and the wheel slides in from the left, the right, or the center. * **Display in page:** The wheel sits in the page where you place the shortcode. = What You Can Do = * **Unlimited wheels.** Place one wheel on each page. * **Odds you set.** Each prize has a winning chance, and the result is chosen on the server. * **Lead form.** Email is required. Name and mobile are optional. * **Device targeting.** Show the wheel on laptop, tablet, or mobile. * **Four layouts.** Put the wheel on the left, right, top, or bottom, and preview the design before you publish. * **Confetti and a suspense spin.** Free includes these two effects, plus a fixed sound for each. Pro adds the rest. * **Emails.** Send the visitor their result and alert the admin on every spin. * **Consent checkbox.** Ask for marketing consent before the spin. * **Mailchimp.** Send leads to an audience, with an optional tag. * **Winner List.** Filter by wheel, search by email, update claim status, and export CSV. * **Dashboard.** See wheels, spins, winners, and leads. * **Help.** A plain-language guide to every setting, inside the plugin. = Pro = Pro is a separate plugin. A Freemius license on its own does not unlock these features inside the free plugin. Install and activate **WebEquipe Spin & Win Wheel Pro**. **WooCommerce coupon rewards** Give a winner a unique coupon locked to their email, or hand out a coupon that already exists in WooCommerce. Choose percentage, fixed cart, fixed product, or free shipping. Set expiry by duration or date, usage limits, a minimum cart subtotal, and what happens if a coupon already exists. The code can appear in the win message as `{coupon_code}`, go out in the winner email, and be applied to an active cart. **Eight starter themes** WooCommerce Native, Flash Sale, VIP Loyalty Gold, Fashion & Beauty Blush, Festive Holiday, Gamification Arcade, Fresh Grocery & Organic, and Tech & Electronics. Free starts from a blank wheel, which you style yourself. **Effects, pointer, and sound** Free includes Confetti Burst, the Suspense spin, and a fixed sound for each. Pro adds Coin Shower, Firework Sparkle, Balloon Rise, Glow Pulse, and Ribbon Streamers, with intensity (Subtle, Standard, or Bold) and pointer wobble. Pro spin motions add Smooth, Snap Stop, Power Spin, Casino Coast, and Bounce Land, plus motion blur and a pointer tick. Pro also adds a custom pointer and extra sound presets, including your own upload. **Abuse protection** Limit spins per IP address and per email, cap how many coupons one email can win, and check each spin with Google reCAPTCHA v3. **Email integrations** Klaviyo, HubSpot, Brevo, Omnisend, and MailerLite. Capture both outcomes, wins only, or losses only. **Dashboard analytics** Performance over 7, 30, or 90 days, including attributed orders, revenue, coupon redemption, new customers, and average order value. On Free, those panels show sample figures until Pro is active. **Win result reload** After a win popup, reload the page on a delay from 5 seconds to 1 minute. * **Free:** unlimited wheels, popup, button, and in-page display, device targeting, lead form, live preview, confetti and suspense effects, win and lose messages, visitor and admin emails, consent checkbox, Mailchimp, Winner List with CSV export, and dashboard totals. * **Pro:** everything in Free, plus WooCommerce coupons, eight themes, the extra effects and sounds, a custom pointer, spin limits, coupon caps, reCAPTCHA v3, Klaviyo, HubSpot, Brevo, Omnisend, MailerLite, revenue analytics, and win-result reload. [View Pro plans](https://webequipe.com/spin-win-wheel/#pricing) = Support = * Support forum: [WordPress.org support](https://wordpress.org/support/plugin/webequipe-spin-win-wheel/) * Documentation: [webequipe.com/spin-win-wheel/doc](https://webequipe.com/spin-win-wheel/doc/) == Installation == = From the WordPress dashboard = 1. Go to **Plugins → Add New**. 2. Search for "WebEquipe Spin & Win Wheel". 3. Click **Install Now**, then **Activate**. = Manual upload = 1. Download the plugin zip file. 2. Go to **Plugins → Add New → Upload Plugin** and choose the file. 3. Click **Install Now**, then **Activate**. = After activation = 1. Open **WebEquipe Spin & Win Wheel → Settings → General** and turn on the consent checkbox if your privacy rules need it. 2. Open **Settings → Email Marketing** and connect Mailchimp if you want leads in an audience. 3. Open **All Wheels → Add New**, build a wheel, and set it to Active. 4. Paste the wheel shortcode on a page. Field-by-field setup for prizes, design, messages, coupons, and limits is in **WebEquipe Spin & Win Wheel → Help** and at [webequipe.com/spin-win-wheel/doc](https://webequipe.com/spin-win-wheel/doc/). == Frequently Asked Questions == = Do I need WooCommerce? = No. The free plugin runs on any WordPress site and can reward visitors with a message. WooCommerce coupon rewards are part of Pro and need WooCommerce installed and active. = Can I control who wins and how often? = Yes. Each prize has its own winning chance, and the chances must add up to 100%. The result is decided on the server. Free also waits before the same email can spin again. Limits per IP and per email, coupon caps, and reCAPTCHA v3 are in Pro. = How do visitors know what they won? = They see the result when the wheel stops. You can also email them and send yourself an admin alert for every spin. = Can I export my leads? = Yes. Open **Winner List**, filter by wheel if you want, and export to CSV. = Does it integrate with Mailchimp? = Yes. Connect Mailchimp under **Settings → Email Marketing**, then turn on **Sync responses with CMS/Email** on the wheel's General tab. If the consent checkbox is on, only visitors who tick it are sent. = Does it work with Klaviyo, HubSpot, or Brevo? = Those providers are in Pro, along with Omnisend and MailerLite. Free includes Mailchimp. = Can I limit spins per person? = Free has a retry wait for the same email. Pro adds spin limits per IP and per email, a cap on coupons per email, and Google reCAPTCHA v3. = Can I show more than one wheel on a page? = No. Only one `[wsww-spin]` shortcode can run on a page. You can create as many wheels as you like and place each on a different page. = Are Elementor or Gutenberg blocks included? = No. Embed a wheel with the shortcode `[wsww-spin id="N"]`. = Can I show the wheel inside the page content? = Yes. Set **When load** to **Display in page**. The wheel renders where you place the shortcode. = Will it slow down my site? = The wheel scripts load only on pages that show a wheel. = How do I find a wheel's ID? = Go to **All Wheels**. The shortcode column shows each ID, for example `[wsww-spin id="3"]`. You can also see the ID in the edit URL: `admin.php?page=wsww-wheels&action=edit&id=1`. = How do I upgrade to Pro? = Install and activate the **WebEquipe Spin & Win Wheel Pro** plugin. A Freemius license on its own does not unlock Pro features inside this free plugin. Pro features stay visible, and locked, until that plugin is active. [View Pro plans](https://webequipe.com/spin-win-wheel/#pricing) = Where is the documentation? = Open **WebEquipe Spin & Win Wheel → Help**. The same guide is online at [webequipe.com/spin-win-wheel/doc](https://webequipe.com/spin-win-wheel/doc/). = Why isn't my wheel appearing? = Confirm the wheel is **Active**, the shortcode ID is correct, and only one `[wsww-spin]` shortcode is on the page. Under **General → Audience devices**, tick the device you are using. In Popup mode the wheel waits for **First display delay**, and after it is closed it stays hidden until **Reopen after** has passed. Clear any page cache after you change settings. = Why aren't emails being sent? = In the **Messages** tab, set **Send email after submit** to **Yes** and use a **From Address** on your own domain. Many hosts need an SMTP plugin to deliver mail. Check the spam folder as well. = Why aren't leads reaching Mailchimp? = Confirm Mailchimp shows **Connected** under **Settings → Email Marketing**, then turn on **Sync responses with CMS/Email** for that wheel. If the consent checkbox is on, the visitor must tick it. **Integration Logs** on the Settings page lists failed API calls. = Why wasn't a WooCommerce coupon created? = Coupon rewards need the Pro plugin and WooCommerce, both active. **Settings → WooCommerce** should show that WooCommerce is active. On the **Prizes** tab, set that segment's **Reward Type** to **WooCommerce Coupon** and **Win?** to **Yes**. Check that **Maximum Win Time** has not already been reached, then review the WooCommerce integration logs. == Screenshots == 1. **Frontend Spin Experience** – Visitor form, wheel interaction, and result message shown after spin. 2. **General Settings** – Set wheel title, status, display mode (popup, button, or in page), devices, and CMS/Email sync (Mailchimp provider + capture mode). 3. **Prizes Tab** – Add prize labels/values, define win/lose segments, set reward type (message or WooCommerce coupon), and balance total probability. 4. **Theme Picker & Design** – Choose a starter theme, then customize templates, wheel styling, win/spin effects, and form appearance with live preview. 5. **Settings** – Connect email providers via cards, manage consent, check WooCommerce coupon status, and review integration logs. 6. **Wheel List & Winner List** – Manage wheels, copy shortcode, review responses, export CSV, and track claim status. 7. **Messages Tab** – Configure win/loss messages, user email content (including `{coupon_code}`), and admin notification options. 8. **Help** – In-plugin user guide covering every setting. == Changelog == = 2.1.0 = * Tested up to WordPress 7.1. Requires PHP 8.1. * Prize results are chosen on the server and confirmed with a one-time spin token. * Added an in-plugin Help page with a plain-language guide to every setting. * Added Previous and Next buttons in the wheel builder, and info tips on setting labels. * Renamed the builder tabs to General, Prizes, Design, and Messages. * Email Marketing settings now use a card for each provider, with connect, audience, optional tag, and integration logs. * WooCommerce coupon rewards are part of Pro. With Pro and WooCommerce active, coupons are ready without a separate enable checkbox. Pro coupon options include duplicate behavior and expiry by duration or a specific date. * Pro adds win-result reload after a win popup (5 seconds to 1 minute) and win-effect intensity (Subtle, Standard, or Bold). * Dashboard totals stay live on Free. Pro analytics panels show sample figures until the Pro plugin is active. * A Freemius license does not unlock Pro inside the free plugin. Install and activate the separate Pro plugin. * The submit button follows the Left, Center, and Right alignment setting. = 1.1.2 = * Added WooCommerce coupon rewards (new or existing coupons, expiry, usage limits, and auto-apply). * Added per-wheel CMS/Email sync with Mailchimp (extra providers available in Pro). * Added admin Dashboard overview stats and a full Settings page (General, Email Marketing, WooCommerce). * Added optional marketing consent checkbox and Mailchimp connection with integration logs. * Added theme/starter picker on create (Blank free; eight Pro themes) and Design-tab theme grid. * Added win/spin effects (confetti and suspense free; extra styles and sound options in Pro). * Added Display in page mode alongside popup and button. * Added Pro-ready modules: spin limits, abuse prevention/reCAPTCHA, custom pointer/arrow, extra ESP integrations, advanced coupon controls, and analytics board. * Improved popup/modal layout, mobile responsiveness, and pointer placement. * Aligned Stable Tag with plugin Version 1.1.2. = 1.1.1 = * Improved wheel layout, mobile responsiveness, and pointer placement. * Bumped tested-up-to compatibility to WordPress 7.0. = 1.1.0 = * Admin UX refresh, CMS/Email API settings (Mailchimp), modal and popup stacking fixes, template/layout sync improvements, and general maintenance. = 1.0.7 = * UI and CSS improvements for the spin wheel display. * Added Windows PowerShell build script for easier packaging on Windows. * Updated internal version references and build metadata. = 1.0.6 = * Initial public release. * Create unlimited spin-to-win wheels with configurable prizes and probabilities. * Lead capture with email notifications and CSV export. * Popup and button display modes. * Fully customizable wheel and form design. * Secure data handling and privacy policy integration. * Works as a standalone spin wheel plugin. == Upgrade Notice == = 2.1.0 = Recommended update for WordPress 7.1 and PHP 8.1. Spins are decided on the server, and the plugin adds a Help page. WooCommerce coupons, themes, and analytics are in the separate Pro plugin. A license alone does not unlock them in this free plugin. = 1.1.2 = Recommended update: WooCommerce coupons, Mailchimp sync, themes/effects, in-page display, dashboard, and Stable Tag aligned with Version 1.1.2. = 1.1.1 = Layout and mobile display improvements. WordPress 7.0 compatibility. = 1.1.0 = Recommended update: admin UX, integrations, and frontend modal/display fixes. = 1.0.7 = Enhancements to UI styling and build tooling. Recommended for all users. = 1.0.6 = Initial public release. == Privacy Policy == This site uses the WebEquipe Spin & Win Wheel plugin to run a spin-to-win campaign. It collects personal data submitted through the spin form, including name, email address, phone number, marketing consent (if enabled), spin result, coupon code (if awarded), and page URL. The data is stored in custom database tables on this site and is used to run the campaign, send winner/admin notifications if enabled, sync consented leads to a connected email-marketing provider (such as Mailchimp), and create or apply WooCommerce coupons if that integration is enabled. Data remains until entries are deleted or the plugin is uninstalled. When optional integrations are enabled by the site owner, the plugin may send limited data to third-party services: - **Mailchimp / Klaviyo / HubSpot / Brevo**: the visitor's email address and optional name/phone fields are sent only when that provider is connected, enabled for the wheel, and allowed by the selected capture mode. If the consent checkbox is enabled, sync happens only after consent is granted. - **Google reCAPTCHA v3**: when enabled, the visitor's browser communicates with Google reCAPTCHA to help detect abuse before a spin is accepted. (Pro) - **Omnisend / MailerLite**: subscriber data may be sent when those Pro integrations are connected and enabled. - **Freemius**: optional license activation and usage opt-in for Pro upgrades. Freemius only contacts its servers after the admin completes the Freemius connect/opt-in screen (or uses Account/Pricing). See https://freemius.com/privacy/ - **WooCommerce**: when coupon rewards are enabled, the plugin may create, store, or apply coupon data inside WooCommerce for winning entries. Why this matters: site owners are responsible for telling visitors what data is collected and how it is used. How to use the suggested text: 1. In WordPress Admin, go to **Settings → Privacy**. 2. Click **"Check for suggested privacy policy text"**. 3. Add the WebEquipe Spin & Win Wheel section to your site's privacy policy page. == Third-Party Libraries == This plugin bundles the following libraries: - Bootstrap v5.3.8 (assets/js/bootstrap.bundle.min.js, assets/css/bootstrap.min.css) - D3.js v3.5.17 (assets/js/d3.v3.min.js) - Chart.js v4.4.3 (assets used by the Pro analytics board) - Freemius SDK (vendor/freemius/) for optional license activation and Pro upgrades License details and source URLs are listed in THIRD-PARTY-LICENSES.txt. == Third-Party Services == This plugin can connect to third-party services when the site owner enables them. No third-party service is required for the wheel display or for storing leads on the site. - **Mailchimp** — sends the visitor's email and optional name or phone to the audience you select, when that wheel's sync is on and the capture mode allows it. If the consent checkbox is on, sync runs only after consent. [Terms](https://mailchimp.com/legal/terms/) · [Privacy](https://mailchimp.com/legal/privacy/) - **Klaviyo** (Pro) — sends the same subscriber fields to the list you select. [Terms](https://www.klaviyo.com/legal/terms-of-service) · [Privacy](https://www.klaviyo.com/legal/privacy-notice) - **HubSpot** (Pro) — sends the same subscriber fields to the list you select. [Terms](https://legal.hubspot.com/terms-of-service) · [Privacy](https://legal.hubspot.com/privacy-policy) - **Brevo** (Pro) — sends the same subscriber fields to the contact list you select. [Terms](https://www.brevo.com/legal/termsofuse/) · [Privacy](https://www.brevo.com/legal/privacypolicy/) - **Omnisend** (Pro) — sends subscriber data when the integration is connected and enabled. [Terms](https://www.omnisend.com/terms/) · [Privacy](https://www.omnisend.com/privacy/) - **MailerLite** (Pro) — sends subscriber data when the integration is connected and enabled. [Terms](https://www.mailerlite.com/legal/terms-of-service) · [Privacy](https://www.mailerlite.com/legal/privacy-policy) - **Google reCAPTCHA v3** (Pro) — the visitor's browser contacts Google so the plugin can reject abusive spins. [Terms](https://policies.google.com/terms) · [Privacy](https://policies.google.com/privacy) - **Freemius** — license, account, and an optional usage opt-in for the site admin. Freemius is contacted only after the admin completes the connect screen or opens Account / Pricing. [Terms](https://freemius.com/terms/) · [Privacy](https://freemius.com/privacy/) Provider APIs are contacted only when you click Connect, Re-Connect, or Refresh Lists, or when a wheel syncs a subscriber after a spin. reCAPTCHA runs only when that Pro setting is on.