Zuta Lucky Wheel

설명

Zuta Lucky Wheel is a powerful marketing tool designed to turn visitors into subscribers and customers. It allows you to create interactive “Spin to Win” wheel popups for your WordPress site, where users can 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

• Multi-Campaign Support (NEW): Create and manage multiple lucky wheel campaigns simultaneously. Set different designs, prizes, and display rules for different pages or target audiences.
• 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 a specific campaign wheel manually or inside a post/page content:

[zutalw_lucky_spin id="CAMPAIGN_ID"]

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.