Add-on Lucky Wheel

Lucky Wheel tạo vòng quay trúng thưởng tương tác ngay trên trang — khách bấm nút "Quay" để vòng quay xoay và dừng lại ở 1 phần thưởng. Phù hợp cho các chiến dịch khuyến mãi, mini game thu hút khách hàng.

Các bước thực hiện:

1. Kéo thẻ Lucky Wheel (nhóm General) vào canvas.
2. Click chọn add-on, mở bảng Addons Config, ở tab Detail cấu hình:
   • Addon Title: bật (Show) để hiển thị tiêu đề của vòng quay, tắt để ẩn.
   • Addon Description: bật (Show) để hiển thị dòng mô tả ngắn bên dưới tiêu đề.
   • Wheel Background: chọn màu hoặc ảnh nền cho vòng quay.
   • Arrow Background: chọn màu/ảnh nền cho mũi tên chỉ kết quả.
   • Arrow Color: chọn màu cho mũi tên, lấy theo bảng màu đã khai báo sẵn ở Config site (Color 0 → Color 4).
   • Play Button: bật (Show) để hiển thị nút bấm "Quay".
   • Play Button Text: nhập nội dung chữ hiển thị trên nút quay, ví dụ "Quay ngay".
   • Link API: chỉ điền nếu vòng quay cần lấy/gửi dữ liệu tới hệ thống ngoài; nếu chỉ dùng phần thưởng khai báo trực tiếp trong add-on thì có thể để trống.
3. Thêm danh sách phần thưởng: bấm nút Add Item, mỗi lần bấm sẽ thêm 1 dòng phần thưởng mới với các thông tin:
   • Title: tên phần thưởng hiển thị trên ô của vòng quay (vd. "Giảm giá 10%").
   • Quantity: số lượng giới hạn của phần thưởng này. Khi số lượt trúng đã đạt đủ số này, hệ thống tự động không cho trúng phần thưởng đó nữa — đây là cách kiểm soát ngân sách khuyến mãi, thay vì đặt tỉ lệ % cố định.
   • Message: nội dung thông báo hiển thị cho khách khi họ trúng đúng phần thưởng này.
   • Action: cột thao tác để sửa hoặc xoá dòng phần thưởng đã thêm.
4. Lặp lại bước 3 để thêm đủ số ô phần thưởng mong muốn trên vòng quay.
5. Bấm Apply để lưu cấu hình add-on, sau đó bấm Save ở thanh Header để lưu toàn trang.
6. Bấm Preview để tự quay thử, kiểm tra vòng quay hiển thị và trừ số lượng phần thưởng đúng như mong muốn.

Lưu ý: nên đặt Quantity hợp lý cho từng phần thưởng ngay từ đầu — đây là cách duy nhất để kiểm soát số lượng khách có thể trúng, không có ô đặt tỉ lệ % riêng.