Zuta Lucky Wheel

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.