VIG Lucky Wheel — Vòng Quay May Mắn

Plugin WordPress tạo nhiều vòng quay độc lập (rút tên / quay thưởng) cho sự kiện, truyền thông. Tái sử dụng cho mọi site khách VIG.

Tính năng

• Nhiều vòng quay trên cùng site, mỗi cái 1 shortcode [lucky_wheel id="X"].
• Nhập nhãn 2–50, chia đều vòng tròn; tuỳ chỉnh trọng số & màu.
• Kịch bản xác suất theo lượt (lượt 1 ép A, lượt 2 B 20% + còn lại chia đều, ...).
• Toggle cho / không cho người đã trúng trúng lại.
• Hiển thị thích ứng: ≤ ngưỡng (mặc định 30) → vòng quay hiện tên; nhiều hơn → reveal bung tên.
• Kết quả quyết định server-side (không sửa được qua DevTools) + log người trúng + nút Reset.
• Phân quyền: chỉ admin / công khai.

Cài đặt

1. Upload thư mục vig-lucky-wheel vào wp-content/plugins/ (hoặc cài file zip qua WP Admin → Plugins → Add New → Upload).
2. Kích hoạt.
3. WP Admin → Vòng Quay May Mắn → Thêm vòng quay.

Cấu hình (ví dụ sự kiện 13/6 — 21 người)

Danh sách nhãn (mỗi dòng 1 tên, tuỳ chọn | trọng số | #màu):

Nguyễn Văn An
Trần Thị Bình
Lê Cường | 2
... (21 dòng)

Kịch bản theo lượt (tuỳ chọn — để trống = bốc theo trọng số):

1: Nguyễn Văn An=100
2: Trần Thị Bình=20, *=đều
3: An=30, Bình=30, Cường=30, Dũng=10

• *=đều → chia đều % còn lại cho các nhãn chưa nêu.
• Tên trong kịch bản phải khớp danh sách.

Cài đặt: Cho trúng lại = Không (loại người đã trúng); Hiển thị = Tự động; Ai được quay = Chỉ quản trị viên.

Lưu (Publish) → copy shortcode → dán vào trang bất kỳ.

Cấu trúc

vig-lucky-wheel/
├── vig-lucky-wheel.php           # bootstrap + AJAX (spin/reset)
├── includes/
│   ├── class-vlw-cpt.php         # CPT lucky_wheel
│   ├── class-vlw-engine.php      # engine xác suất (server-side)
│   ├── class-vlw-admin.php       # meta box cấu hình + parse + log
│   └── class-vlw-frontend.php    # shortcode + nhúng assets
└── assets/ wheel.js, wheel.css

Cập nhật

Khi có phiên bản mới, WordPress sẽ tự báo — bạn chỉ cần bấm Cập nhật như mọi plugin khác.

Roadmap (chưa làm — phase sau)

• Thu lead trước khi quay (phương án 1): bắt nhập SĐT/tên rồi mới cho quay → gắn vào lead.
• Trình tạo kịch bản trực quan (kéo-thả thay vì text).
• Xuất log người trúng ra CSV.
• Hiệu ứng âm thanh + confetti khi trúng.

📚 Về sau, tài liệu kỹ thuật đầy đủ sẽ chuyển lên vigdigital.com — khi đó mục này rút gọn thành một liên kết.

• Cấu trúc: vig-lucky-wheel.php (bootstrap + AJAX spin/reset + template Canvas); includes/class-vlw-cpt.php (CPT lucky_wheel), class-vlw-engine.php (engine xác suất server-side), class-vlw-admin.php (meta box + parse + log + tab Hướng dẫn), class-vlw-frontend.php (shortcode + assets); templates/canvas.php.
• Gotcha: lưu JSON vào post meta phải wp_slash( wp_json_encode( ... ) ) — nếu không update_post_meta chạy wp_unslash ăn mất \ trong \uXXXX → hỏng tiếng Việt.
• Tự cập nhật: Plugin Update Checker đọc GitHub Releases (vig_setup_updates). Repo private → cấu hình theo VIG internal ops notes.
• Phát hành: bump Version: (header) + VLW_VER cho khớp → commit → git tag v1.0.8 && git push origin v1.0.8. GitHub Action tự build zip sạch + đính vào Release.

GPL-2.0-or-later © VIG Digital