Overview
The Lucky Wheel addon is an interactive gamification tool designed to engage customers and boost sales through promotions and discounts. Transform your store into an exciting shopping experience where customers can spin to win prizes, discounts, and special offers!
Why Use Lucky Wheel?
- Increase Customer Engagement: Gamify the shopping experience to keep customers interested and coming back
- Generate Leads: Collect valuable customer information (name, email, phone) through interactive forms
- Distribute Promotions: Easily share coupon codes and special offers with your customers
- Track Performance: Monitor spins, leads, and customer behavior with comprehensive analytics and reports
- Fully Customizable: Customize wheel items, colors, positions, and messaging to match your brand
- Mobile Friendly: Works seamlessly on all devices - desktop, tablet, and mobile
- Multi-language: Support for multiple languages and translations
Installation & Setup
Step 1: Install the Addon
Navigate to Administration → Add-ons in your CS-Cart admin panel. Find "Lucky Wheel" in the list and click "Install" to activate it.
Step 2: Configure Basic Settings
Go to Add-ons → Lucky Wheel → Settings to configure:
- Enable or disable the lucky wheel
- Choose who can use it (registered users or everyone)
- Set time restrictions between spins (prevent abuse)
- Customize wheel appearance (size, colors, fonts)
Step 3: Customize Wheel Items
Navigate to Marketing → Lucky Wheel Items to:
- Edit or delete the sample items
- Create new items with your promotions
- Set item colors and types
- Link items to your CS-Cart promotions
Step 4: Set Up Floating Button (Optional)
Go to Marketing → Lucky Wheel Items → Floating Button to:
- Enable the floating button on your storefront
- Choose button position and appearance
- Customize button text and colors
- Select an icon for the button
Step 5: Test Your Setup
Visit your storefront and test the lucky wheel:
- Fill out the form (or verify it's auto-filled for logged-in users)
- Spin the wheel
- Check that results display correctly
- Verify promotions are working
Settings Configuration
General Settings
Access settings at Add-ons → Lucky Wheel → Settings
Enable Lucky Wheel
Toggle to enable or disable the lucky wheel functionality. When disabled, the wheel will not be accessible to customers.
Restriction Type
- Registered user: Only logged-in customers can use the lucky wheel
- Public visitor: Anyone can use the lucky wheel, including guests
When set to "Registered user", guests will see a message prompting them to log in or register.
Allow Spin After (Hours)
Set the minimum number of hours a user must wait before they can spin the wheel again. This prevents abuse and encourages return visits.
- Default: 24 hours
- Minimum: 1 hour
- Recommended: 24-48 hours for optimal engagement
Auto Save Leads as Customer
When enabled, guest leads collected through the form will be automatically converted to customer accounts in CS-Cart. This is useful for building your customer database.
Wheel Settings
Wheel Size
The overall size of the spinning wheel in pixels. Default: 600px
Wheel Radius
The radius of the wheel circle. Default: 290px
Wheel Text Radius
The distance from the center where text appears on wheel segments. Default: 90px
Wheel Center Padding
The padding around the center of the wheel. Default: 190px
Wheel Font Size
The font size for text displayed on wheel segments. Default: 11px
Note: Adjust these settings carefully to ensure text fits properly on wheel segments and the wheel displays correctly on all devices.
Features
1. Lucky Wheel Items Management
Create and Manage Wheel Items
Navigate to Marketing → Lucky Wheel Items to manage all wheel items.

Item Types
- Nothing / Text (Type 0): Display a custom message when customer lands on this segment. No promotion code required.
- Promotion (Type 1): Award a promotion code that customers can use. Requires linking to a CS-Cart promotion and entering a promotion code.
- Re-spin Again (Type 2): Give customers another chance to spin. This increases engagement and encourages return visits.
Item Configuration
- Title: The text displayed on the wheel segment
- Type: Select from Nothing/Text, Promotion, or Re-spin Again
- Color: Set a custom hex color for the wheel segment
- Promotion: Link to an existing CS-Cart promotion (for Promotion type items)
- Promotion Code: The code displayed to customers when they win (for Promotion type items)
- Status: Enable or disable individual items
- Storefronts: Assign items to specific storefronts (Multi-Storefronts only)
2. Form Fields Management
Collect Customer Information
Navigate to Marketing → Lucky Wheel Items → Form Fields to manage form fields.

Field Types
- Text: Single-line text input
- Email: Email address input with validation
- Phone: Phone number input
- Textarea: Multi-line text input
- Selectbox: Dropdown selection
- Checkbox: Checkbox input
- Radio: Radio button selection
Field Configuration
- Field Name: Internal field identifier
- Field Label: Text displayed to customers (supports multi-language)
- Field Type: Select the input type
- Required: Make the field mandatory
- Position: Control the order of fields in the form
- Status: Enable or disable individual fields
Auto-fill for Registered Users: For logged-in customers, the form automatically populates with their account information (name, email, etc.), creating a seamless experience.

3. Floating Button
Customizable Floating Button
Navigate to Marketing → Lucky Wheel Items → Floating Button to configure the floating button.

Button Configuration
- Enable Floating Button: Toggle to show/hide the floating button
- Button Position: Choose from top-left, top-right, bottom-left, bottom-right
- Button Text: Customize the button label (supports multi-language)
- Button Color: Set the button background color
- Text Color: Set the button text color
- Icon: Select an icon or upload a custom image
- Size: Adjust button size (small, medium, large)
The floating button appears on all storefront pages, making it easy for customers to access the lucky wheel at any time.
4. Reports & Analytics
Comprehensive Reporting
Navigate to Marketing → Lucky Wheel Items → Spins Report to view detailed analytics.

Spins Report
The spins report provides comprehensive statistics and analytics:
- Total Spins: Total number of spins performed
- Promotions Won: Count of promotion wins (Type 1)
- Type Respin Again: Count of re-spin wins (Type 2)
- Nothing Won: Count of "nothing" outcomes (Type 0)
Interactive Charts
Visual charts show spins over time with the following data:
- Total spins per day
- Promotions won per day
- Re-spin again per day
- Nothing won per day

Date Filtering
Filter reports by date range to analyze performance over specific periods. Use the date picker to select start and end dates.
Win Values Distribution
See which prizes are most popular with a pie chart showing the distribution of win values.
Recent Spins List
View detailed information about each spin, including:
- Date and time of spin
- User information (name, email, or guest status)
- Win value (prize won)
- Type (Promotion, Re-spin, or Nothing)
- Promotion code (if applicable)
Export to Excel
Export spin data to Excel for further analysis or reporting. The export includes all spin details for the selected date range.
5. Customization Options
Spin Page Description
Navigate to Marketing → Lucky Wheel Items → Spin Page Description to customize the description shown on the spin page.

- Enable Description: Toggle to show/hide the description
- Description Content: Enter custom text (supports HTML and multi-language)
- Description Image: Upload an image to display with the description
Privacy Policy
Navigate to Marketing → Lucky Wheel Items → Privacy Policy to configure privacy policy content.

- Enable Privacy Policy: Toggle to show/hide privacy policy
- Privacy Policy Content: Enter privacy policy text (supports HTML and multi-language)
- GDPR Compliance: Ensure your privacy policy complies with GDPR and other privacy regulations
How to Use
Three-Page Flow
User Experience Flow
The lucky wheel follows a three-page flow for optimal user experience:
- Form Page: Customer fills out the form (or it auto-fills for registered users)
- Spinning Page: Customer spins the wheel and sees the result
- Result Page: Customer sees what they won and receives their promotion code (if applicable)


Access Control
Restriction Handling
When the lucky wheel is restricted to registered users only, guests will see a message prompting them to log in or register.

Mobile Experience
Responsive Design
The lucky wheel is fully responsive and works perfectly on mobile devices. The interface adapts to smaller screens for optimal user experience.

Best Practices
- Create Balanced Items: Mix promotion items with "nothing" and "re-spin" items for realistic expectations
- Set Appropriate Time Restrictions: 24-48 hours between spins is recommended to balance engagement and preventing abuse
- Use Clear Promotion Codes: Make promotion codes easy to remember and use
- Monitor Reports: Regularly check the spins report to understand customer behavior and optimize your wheel items
- Test Before Launch: Always test the wheel as both a registered user and guest before making it live
- Customize Branding: Match colors, fonts, and messaging to your brand for a cohesive experience
Screenshots
Backend Administration
Manage Lucky Wheel Items

Manage Leads and Customers Fields

Floating Button Configuration

Spins Report

Report Chart

Customize Spin Page Description

Customize Privacy Policy

Frontend Experience
Interactive Spinning Wheel

Win Result Display

Mobile Experience

Access Control

Form Data Collection
