Arya Lucky Wheel – Spin to Win & Coupon Generator for Botble CMS

Lucky Wheel Plugin for Botble CMS | Spin to Win & Coupons

Arya Lucky Wheel is a complete spin-to-win plugin for Botble CMS. Build as many wheels as you like, give each segment its own prize and probability, and let Botble Ecommerce generate real, single-use coupons automatically when a visitor wins. It ships with eight ready-made designs, a live admin preview, full LTR/RTL support and demo wheels you can create in one click.

Key Features

Prizes: coupons and products on every segment

• Reward types per segment: No prize, Coupon code, Product, or Product + coupon.
• Coupon modes: generate a unique code for each winner, or use an existing Botble coupon.
• Discount types: percentage, fixed amount, or free shipping; optional minimum order amount, validity in days and custom code prefix.
• Product prizes with live search: type a product name, SKU or ID, pick it from a list with image and price, and the winner receives a unique coupon valid only for that product. Set the discount to 100% to give the product away for free.
• Custom win message, segment image, segment and text colours for every item.

Fair and controllable odds

• Weighted probabilities with the winning chance shown per item.
• Maximum winners per prize, so rare prizes run out.
• Winner is chosen server-side inside a locked database transaction, so results cannot be manipulated from the browser and prizes are never over-awarded.
• Active/inactive switch per item, drag-free reordering, duplicate item, 2 to 24 segments per wheel.

Abuse protection and spin limits

• Spins limited per visitor per day, week, month, or once only.
• Maximum spins per IP address.
• Optional logged-in customers only mode.
• Optional mobile number capture before spinning, with limits applied per number. Persian/Arabic digits are normalised automatically.
• Start and end dates for campaigns; public endpoints are rate-limited.

Eight designs plus a custom theme

• Royal (gold), Candy, Neon, Ocean, Yalda, Black Friday, Minimal light, and Custom with your own colours.
• Animated canvas wheel, LED bulbs, pointer, confetti and optional sound, configurable spin duration.
• Result ticket showing the prize, coupon code with copy button, expiry and the won product.
• Optional prizes list and rules section below the wheel.

Display options

• Insert anywhere with the shortcode (a wheel picker is built into the shortcode form).
• Floating button + popup with configurable delay.
• Responsive on mobile, tablet and desktop; automatic RTL/LTR following the site language.

Admin experience

• Wheels list and a detailed spin log (who spun, from which IP, prize, code, date) with delete.
• Live wheel preview while editing items.
• Create demo wheels button: one ready demo per design, with product and coupon prizes, generated in the site language (Persian or English).
• Granular permissions: view, create, edit, delete, spin log.
• Translations included: English and Persian.

Requirements

• Botble CMS (Laravel).
• Botble Ecommerce plugin for coupon/product prizes (the wheel itself works without it using no-prize segments).

Installation

1. Upload the plugin to platform/plugins/arya-lucky-wheel.
2. Activate it from Admin → Plugins; the database tables and demo wheels are created automatically.
3. Go to Lucky Wheel → Wheels, edit a wheel or create one, then place the shortcode on any page or enable the floating button.

Why Arya Lucky Wheel?

Higher email/phone collection, more first orders, and a fun reason for visitors to come back, all with coupons that are real, unique and trackable in your Botble store.