[VNXF] Point Manager

VNXF Point Manager là một Add-on dành cho XenForo 2.3.x, cung cấp hệ thống tích lũy, quản lý và giao dịch Điểm thưởng (Points) thông qua các hoạt động tương tác của người dùng trên diễn đàn.

Tính Năng Chính (Features)

Tích Lũy Điểm (Earn Points):
Cộng điểm khi tạo Chủ đề (Thread) mới.
Cộng điểm khi Trả lời (Reply) bài viết.
Cộng điểm khi tải lên (Upload) Tài liệu đính kèm.
Trừ Điểm & Giới Hạn Tải File:
Trừ điểm khi người dùng tải xuống (Download) tài liệu đính kèm.
Hỗ trợ cấu hình mức trừ điểm riêng biệt cho từng Chuyên mục (Forum), hoặc dùng mức mặc định chung.
Chức năng Box Tài liệu: Ép buộc người dùng phải có file đính kèm (không phải ảnh) khi tạo chủ đề trong các box này.
Giới hạn số lượt tải file trong ngày của từng nhóm người dùng (Daily Limit).
Nhóm VIP:
Thiết lập các nhóm VIP được tải file miễn phí (không bị trừ điểm) và không bị giới hạn số lượt tải.
Quản Lý & Thu Hồi Điểm:
Tự động trừ lại điểm nếu Chủ đề / Bài trả lời bị Xóa.
Tự động hoàn lại (Cộng) điểm nếu Chủ đề / Bài trả lời được Khôi phục (Undeleted) hoặc Duyệt (Approved).
Giao Dịch (Transfer):
Người dùng có thể Chuyển điểm cho thành viên khác (dựa trên phân quyền User Group).
Thống Kê & Lịch Sử (Stats & Logs):
Trang "Điểm thưởng" dành cho người dùng theo dõi số dư hiện tại, tổng điểm đã kiếm, số thread/reply đã đóng góp.
Thống kê phân loại Bài viết SC (nhóm chuyên mục tính điểm SC riêng biệt).
Xem Lịch sử giao dịch chi tiết (Cộng/Trừ điểm từ lý do gì, khi nào, từ ai).
Widget hiển thị Top Thành viên tích lũy điểm (hỗ trợ lọc theo tháng hoặc mọi thời đại, hiển thị dạng sidebar hoặc dàn ngang).

Cài Đặt (Installation)

Tải bản Release ZIP mới nhất.
Giải nén và tải thư mục src đè ngang cấp với thư mục src trên Hosting/Server của mã nguồn XenForo.
Đăng nhập vào Admin CP -> Add-ons.
Tìm [VNXF] Point Manager trong danh sách Installable Add-ons và nhấn Install.

Cấu Hình (Configuration)

1. Options (Thiết lập chung)

Truy cập Admin CP -> Setup -> Options -> [VNXF] Point Manager:

Thiết lập số điểm cộng mặc định cho Thread, Reply, Document.
Thiết lập điểm trừ mặc định khi tải file.
Chọn các Box Tài liệu và Box SC.
Nhập ID các Nhóm VIP.

2. Permissions (Phân quyền nhóm)

Truy cập Admin CP -> Groups & permissions -> User group permissions:

Kéo xuống mục VNXF Point Manager để cấu hình:

Bắt buộc đính kèm tài liệu để nhận điểm đăng Thread/Reply.
Giới hạn tải file mỗi ngày.
Điểm trừ khi tải file (nếu muốn set riêng cho group).
Cho phép chuyển điểm.

3. Node Configuration (Cấu hình riêng theo Box)

Truy cập Admin CP -> Forums -> Nodes và sửa một chuyên mục bất kỳ:

Mục Điểm tải file từ box này:

-1: Dùng giá trị mặc định hệ thống.
0: Tải miễn phí.
>0: Mức trừ điểm cụ thể của box.

Cấu Trúc Thư Mục Build

Add-on hỗ trợ tiêu chuẩn build của XenForo Development Mode. Tất cả Template, Phrase, Route, Widget Definition... được lưu trữ dưới dạng .json/.html bên trong thư mục _output.

Để biên dịch Add-on sau khi chỉnh sửa qua Development Mode:
`bash
php cmd.php xf-addon:build-release VNXF/PointManager
`