Spin to Win Wheel
for WooCommerce

Welcome to Spin to Win Wheel

Turn a visitor’s interest into a playful discount experience. Visitors enter their email, spin the wheel, and may receive a prize or coupon configured by the store administrator.

The administration interface is available to WordPress administrators under Spin Wheel in the left-hand WordPress menu. The plugin’s settings are organized into tabs; the names below match the interface in version 1.0.10.

Requirements & compatibility

Install and open the plugin

1. Open your WordPress dashboard

   Sign in with an administrator account.

2. Go to Plugins → Add New Plugin

   Click Upload Plugin and choose Spin_to_Win_Wheel_for_WooCommerce-v1_0_10.zip.

3. Install and activate

   Click Install Now, then Activate Plugin. Keep the ZIP intact; upload the ZIP rather than extracting it on your computer.

4. Open Spin Wheel

   Use the new Spin Wheel item in the WordPress admin sidebar. The plugin also adds a Settings shortcut on its Plugins-list row.

5. Configure and preview

   Set your prizes and display rules, then click Preview in the plugin’s top bar to review the front-end experience as an administrator.

Dashboard

The Dashboard summarizes activity and provides shortcuts. The exact numbers depend on traffic and entries recorded on your site.

Dashboard mockups in this guide are explanatory examples, not live screenshots or sample analytics from your website.

General tab: activation, pages and timing

Activation

Where should the wheel appear?

Select one or more page types. You can also add specific page/post IDs to include or exclude individual locations.

• Always show on these page IDs: comma-separated IDs that are additionally allowed.
• Exclude page IDs: comma-separated IDs that must never show the popup. Exclusions take priority over normal page-type targeting.
• Show on desktop / tablet / mobile: controls device-specific visibility.

Popup trigger

Do not show again for: number of days after a visitor closes the popup. Set to 0 to show again on every page load. Show floating launcher enables the reopen button. Keep launcher after spin allows a visitor to reopen the result/prize interface after spinning.

Wheel Slices: prizes and chances

Configure the segments shown on the wheel. The interface supports a minimum of 2 and a maximum of 12 slices. Each slice can be enabled, labeled, assigned a prize type and styled with its own background and text color.

Available prize types

• Fixed amount coupon (auto-generated): creates a WooCommerce fixed-cart discount coupon.
• Percentage coupon (auto-generated): creates a percentage discount coupon.
• Free shipping coupon (auto-generated): creates a coupon with free shipping enabled.
• Existing WooCommerce coupon: returns a selected existing coupon code.
• Custom code (plain text): displays a code you supply; make sure it is valid and explain any manual redemption process.
• No prize: a “better luck next time” result without a coupon.

Texts & Content

This tab controls the text shown to visitors: the initial popup, result messages, validation errors and floating launcher. You can localize the visible copy by replacing the English defaults with your preferred language.

Launcher positions: bottom-left, bottom-right, middle-left and middle-right. Attach to the screen edge removes the gap between the launcher and screen edge; the side-tab style always sits on the edge.

Design: layout, colors and effects

Use the Design tab to make the popup match your store. Change a few settings at a time and preview on desktop and mobile so text remains readable.

Form & Security

Coupons

Coupon settings apply to automatically generated WooCommerce coupons. Existing WooCommerce coupons continue to use their own configured rules, while custom plain-text codes are not automatically created as WooCommerce coupons.

Further restrictions can be set on the coupon itself in WooCommerce, such as product/category eligibility or sale-item rules, depending on the selected prize and your WooCommerce configuration. Always test coupon behavior with a test account and representative cart.

Emails

The Emails tab configures the winner email and administrator notification. Confirm your WordPress email delivery setup before relying on transactional messages.

Leads

The Leads tab lists records captured by the wheel. Use the search field to find entries, review the associated prize/coupon and export records when the export control is available.

• Search leads using the provided search control.
• Review the email, optional name, prize, coupon code and entry date where shown.
• Use CSV export to work with the data in a spreadsheet.
• Delete individual records or clear all records only after checking the selection carefully; deletion is permanent.

Tools

The Tools tab’s exact controls may vary if the plugin is updated after version 1.0.10. Use the labels visible in your installed version as the final reference.

Shortcode: place a spin button anywhere

The plugin registers this shortcode to display a button that can open the wheel:

[ideaplcrksp134970_button text="Spin now"]

To add it, edit a WordPress page or post and insert a Shortcode block, then paste the shortcode. Replace Spin now with your preferred button label. The popup trigger should be set to Only when clicked if you want the wheel to open exclusively through a click-based launcher/button.

Privacy, storage and uninstall behavior

• Leads are stored in a plugin-managed database table. The plugin creates/updates the table when activated and upgrades its schema additively.
• Daily cleanup is scheduled for retention settings; deactivation clears the plugin’s scheduled purge hook.
• Updates are designed not to remove existing lead data.
• Deactivation is not the same as deleting the plugin and does not, by itself, trigger the uninstall cleanup.
• On uninstall, data is removed only if the plugin’s delete on uninstall setting is enabled. When enabled, the plugin removes its lead table and its settings/statistics options.

Troubleshooting