Lucky Wheel CS-CART addon

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
Perfect For: E-commerce stores looking to increase conversions, collect leads, promote special offers, and create an engaging shopping experience that encourages repeat visits.

Installation & Setup

Quick Start: The Lucky Wheel addon is easy to install and comes with sample items pre-configured. You can start using it immediately after installation!

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.

The addon will automatically create sample wheel items that you can customize or replace with your own.

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
Important: Make sure you have at least one wheel item created before customers can use the wheel. The addon creates sample items automatically, but you should customize them to match your promotions.

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.

Manage Lucky 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.

Manage Leads and Customers 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.

Lucky Wheel Form Data

3. Floating Button

Customizable Floating Button

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

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

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

Report Chart

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.

Customize Spin Page Description

  • 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.

Customize Privacy Policy

  • 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:

  1. Form Page: Customer fills out the form (or it auto-fills for registered users)
  2. Spinning Page: Customer spins the wheel and sees the result
  3. Result Page: Customer sees what they won and receives their promotion code (if applicable)

Frontend Spinning

Frontend Result

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.

Frontend Restriction

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.

Mobile Spinning

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 Lucky Wheel Items

Manage Leads and Customers Fields

Manage Leads and Customers Fields

Floating Button Configuration

Floating Button

Spins Report

Spins Report

Report Chart

Report Chart

Customize Spin Page Description

Customize Spin Page Description

Customize Privacy Policy

Customize Privacy Policy

Frontend Experience

Interactive Spinning Wheel

Frontend Spinning

Win Result Display

Frontend Result

Mobile Experience

Mobile Spinning

Access Control

Frontend Restriction

Form Data Collection

Lucky Wheel Form Data

Did you find this article useful?