VNXF User Upgrade Manual là addon dành cho XenForo 2.x, cho phép quản trị viên nâng cấp nhóm người dùng thủ công mà không cần thông qua các gói nâng cấp (upgrade packages) có sẵn. Addon đặc biệt hữu ích khi bạn cần thêm người dùng vào một nhóm cụ thể trong một khoảng thời gian nhất định hoặc vĩnh viễn.
Tính năng chính
| Tính năng | Mô tả |
|---|---|
| Nâng cấp nhóm thủ công | Thêm người dùng vào bất kỳ nhóm nào trực tiếp từ Admin CP |
| Hỗ trợ 3 kiểu thời hạn: khoảng thời gian, ngày cụ thể, hoặc vĩnh viễn | |
| Tự động hết hạn | Cron job tự động gỡ nhóm khi hết thời hạn |
| Tích hợp sẵn | Nút thêm nhanh ngay trong trang User Upgrades của Admin CP |
| ️ Phân quyền | Chỉ admin có quyền "User Upgrade" mới có thể sử dụng |
Yêu cầu hệ thống
- XenForo 2.x trở lên
- PHP 7.2 trở lên
Cài đặt
Cách 1: Upload qua Admin CP
- Tải file
VNXF-UserUpgradeManual-1.0.0.ziptừ thư mục_releases - Truy cập Admin CP → Add-ons → Install/upgrade from archive
- Upload file zip và nhấn Install
Cách 2: Cài đặt thủ công
- Giải nén và upload thư mục
VNXF/UserUpgradeManualvàosrc/addons/ - Truy cập Admin CP → Add-ons
- Tìm addon "VNXF User Upgrade Manual" và nhấn Install
Hướng dẫn sử dụng
Bước 1: Truy cập trang nâng cấp
Vào Admin CP → Users → User Upgrades. Bạn sẽ thấy nút "Manual group upgrade" bên cạnh nút "Add user upgrade".Bước 2: Điền thông tin nâng cấp
| Trường | Mô tả |
|---|---|
| User | Nhập tên người dùng (hỗ trợ autocomplete) |
| User Group | Chọn nhóm muốn thêm người dùng vào |
| End Date | Chọn kiểu thời hạn (xem bên dưới) |
Bước 3: Chọn kiểu thời hạn
Addon hỗ trợ 3 kiểu thời hạn:- Khoảng thời gian (Time Period): Nhập số lượng + đơn vị thời gian (ngày / tháng / năm). Ví dụ: 3 tháng, 1 năm.
- Ngày cụ thể (Specific Date): Chọn ngày hết hạn cụ thể từ bộ chọn ngày.
Vĩnh viễn (Permanent): Người dùng sẽ nằm trong nhóm vĩnh viễn, không tự động hết hạn.
Bước 4: Lưu
Nhấn Save để áp dụng nâng cấp. Người dùng sẽ được thêm vào nhóm ngay lập tức.Cơ chế hoạt động
Thêm nhóm người dùng
Khi nâng cấp được tạo, addon sử dụng serviceXF:User\UserGroupChange để thêm người dùng vào nhóm phụ (secondary user group). Mỗi nâng cấp được gắn một key duy nhất theo format vnxf_manual_upgrade_{id}.Tự động hết hạn
Addon đăng ký một Cron Entry chạy 3 lần mỗi giờ (phút 10, 30, 50) để kiểm tra và xử lý các nâng cấp đã hết hạn:- Tìm các bản ghi có
end_date > 0vàend_date < thời gian hiện tại - Gỡ nhóm phụ khỏi người dùng
- Xóa bản ghi nâng cấp
Lưu ý: Nâng cấp vĩnh viễn (end_date = 0) sẽ không bị ảnh hưởng bởi cron job.




