FAIR

Federated and Independent Repositories

Zuta Lucky Wheel

Plugin Banner

Zuta Lucky Wheel

by hatazuwp

Download
Description

Zuta Lucky Wheel is a marketing tool designed to turn visitors into subscribers and customers. It adds a “Spin to Win” wheel popup to your WordPress site, allowing users to enter their information for a chance to win prizes such as coupons, discounts, or free gifts.

Zuta Lucky Wheel utilizes Matter.js and p5.js libraries to create smooth, realistic physics animations for the spinning effect.

⚠️ Important Note for Administrators

The Lucky Wheel popup is designed for visitors only. It will NOT display for logged-in Administrators. To test the wheel, please use an Incognito/Private window or log out of your account.

🚀 Key Features

  • Realistic Physics: Smooth spinning animation based on real physics (Matter.js engine).
  • Fully Customizable Design:
    • Change colors for every slice (background, text).
    • Customize the spin button and popup background.
    • Edit the “Gift Box” trigger icon and winning messages.
  • Flexible Winning Logic:
    • Weighted Probability: Control exactly how often each prize is won (e.g., Prize A: 10%, Prize B: 0.1%).
    • Random Mode: Let fate decide with random outcomes.
  • Security & Anti-Cheat:
    • Google reCAPTCHA v3 Integration: Protect your wheel from bots and spam.
    • Smart Limits: Limit spins per device/IP address (using FingerprintJS).
    • Reset Interval: Allow users to spin again after X days.
  • Data Collection: Capture customer names, emails, and phone numbers before they spin.
  • Mobile Friendly: Responsive design that adapts to iPhone, Android, and Tablets.
  • Optimized Performance: Assets are loaded conditionally only when needed.

⌨️ Shortcodes

Use the following shortcode to embed the wheel trigger manually or inside a post/page content:

[zutalw_lucky_spin]

You can also trigger the wheel via a link anchor:
Click to Spin

External Services

This plugin relies on the following third-party services to function properly:

  1. Google reCAPTCHA v3
    • Used for: Protecting the spin form from spam and bot abuse.
    • Data Sent: Hardware and software information, such as device and application data, is sent to Google for analysis.
    • Privacy Policy: https://policies.google.com/privacy
    • Terms of Service: https://policies.google.com/terms

Third-Party Resources

This plugin bundles the following third-party libraries in the assets/js directory to ensure functionality. All code is open source.

  1. p5.js (Core, DOM, and Sound)

    • Source: https://github.com/processing/p5.js
    • License: LGPL-2.1
    • Files included:
      • assets/js/p5.min.js
      • assets/js/p5.dom.min.js
      • assets/js/p5.sound.min.js

  2. Matter.js

    • Source: https://github.com/liabru/matter-js
    • License: MIT
    • File included: assets/js/matter.js

  3. FingerprintJS

    • Source: https://github.com/fingerprintjs/fingerprintjs
    • License: MIT
    • File included: assets/js/fingerprint.min.js (Browser IIFE build)

  4. Poly Decomp (decomp.js)

    • Source: https://github.com/schteppe/poly-decomp.js
    • License: MIT
    • File included: assets/js/decomp.js
    • Note: Used as a dependency for Matter.js to handle concave polygons.

  5. PathSeg (pathseg.js)

    • Source: https://github.com/progers/pathseg
    • License: MIT
    • File included: assets/js/pathseg.js
    • Note: Polyfill for SVGPathSeg API.
  1. Upload the zuta-lucky-wheel folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Go to Lucky Wheel in the admin sidebar to configure your prizes and design.
  4. (Optional) Go to Display Rules to set up reCAPTCHA keys and spin limits.
I am an Administrator but I don’t see the popup?

For testing purposes, the plugin hides the wheel from logged-in Administrators to prevent skewing your analytics or interfering with site management. Please open your website in an Incognito/Private window to test the popup as a regular visitor.

How do I change the winning probability?

Go to Lucky Wheel > Design Setup. Next to each prize slice, you will see a “Probability” field. Enter a number (weight). The higher the number compared to others, the higher the chance of winning.

Can I limit how many times a user can spin?

Yes. Go to Lucky Wheel > Display Rules. You can set “Max Spins per Device” and the “Reset Limit After (Days)”.

Does this plugin support Google reCAPTCHA?

Yes. We support Google reCAPTCHA v3 (invisible). You just need to enter your Site Key and Secret Key in the Display Rules tab.

1.0.0

  • Initial release.
Back to top