Hướng dẫn Market: chợ plugin flatbb của V4U và cách đấu nối cho forum khác

Market là chợ plugin chạy ngay trên diễn đàn: mọi plugin flatbb mà team V4U đang dùng được đóng gói, kiểm tra và phát miễn phí tại Chợ plugin — hiện có 66 plugin trong 15 danh mục, kèm phiên bản, changelog và ảnh chụp.

Market gồm hai phần, có thể nằm trên hai forum khác nhau:

1. Cài plugin từ chợ trên V4U.VN

1. Đăng nhập tài khoản quản trị → Admin → Plugins → Chợ plugin.
2. Tìm theo tên hoặc mô tả, lọc theo danh mục, xem tab Đã cài đặt và Bản cập nhật.
3. Bấm Cài đặt hay Cập nhật. Diễn đàn tự tải gói zip, kiểm checksum SHA-256 mà chợ công bố, giải nén vào plugins/<id>/ rồi bật lên.
4. Danh sách được lưu 15 phút; bấm Làm mới để lấy bản mới nhất.

Không phải quản trị thì không thấy gì: khu Chợ plugin chỉ nằm trong Admin. Nếu server bị chặn truy cập ra ngoài, tải thủ công https://v4u.vn/market/download/<tên-plugin> rồi Admin → Plugins → Tải lên file zip.

2. Đấu nối forum flatbb khác vào chợ

Chỉ hai bước, làm trên forum của bạn.

Bước 1 — bật plugin Market. Gói flatbb luôn kèm sẵn plugins/market/. Vào Admin → Plugins, tìm Plugin Market rồi bật. Forum nào xoá mất thì copy thư mục đó từ một forum khác sang.

Bước 2 — trỏ về chợ. Thêm một dòng vào data/config.php:

'market_endpoint' => 'https://ddvn.me/api/market',

ddvn.me là tên cũ của chợ, cùng một nơi với https://v4u.vn/api/market, dùng địa chỉ nào cũng được. Một forum chỉ trỏ một chợ tại một thời điểm; đổi endpoint nghĩa là đổi luôn danh sách plugin.

Xong, vào Admin → Plugins → Chợ plugin → Làm mới: danh sách plugin của chợ hiện ra và bạn cài như ở mục 1. Từ đây, mỗi lần chợ có bản mới, forum của bạn thấy ở tab Bản cập nhật.

3. Kết nối tài khoản

Cần khi chợ có plugin tính bằng điểm, và bắt buộc khi bạn muốn đăng plugin của mình. Tab Tài khoản có hai cách lấy token:

• Kết nối (khuyên dùng): bấm nút, trình duyệt mở trang chợ, quản trị bên chợ thấy yêu cầu và bấm Chấp thuận. Forum của bạn nhận token ngay mà không phải copy/dán gì cả.
• Token: tạo tại /market/developer của chợ rồi dán vào ô Token. Token dạng ddvn_…; chạy lệnh thì đặt biến môi trường DDVN_MARKET_TOKEN.

Token là mật khẩu API: giữ bí mật và thu hồi bất cứ lúc nào ở /market/developer.

4. Đăng plugin của bạn lên chợ

php flatbb plugin:check <id>
export FLATBB_TOKEN=ddvn_xxxxxxxx
php flatbb plugin:publish <id> --changelog="Thay đổi ở bản này" --images=anh1.png,anh2.png

Hoặc làm trên trình duyệt: Admin → Plugins → Publish. Điều kiện:

• Manifest trong plugin.php đủ id, name, version, description, author, url; version phải khác version đã có trên chợ.
• README.md — nội dung này trở thành trang giới thiệu plugin trên chợ.
• Tài khoản đứng tên token phải là quản trị của chợ mới được đăng.
• Plugin mới mang nhãn Community, thành Certified sau khi có người kiểm; cài plugin Community thì quản trị được hỏi lại một lần.

5. An toàn

• Gói bị từ chối khi đăng nếu: nhiều hơn một thư mục con, thiếu <id>/plugin.php, plugin.php không khai đúng id, có file thực thi (.exe .dll .so .sh .bat .phar), zip lớn hơn 20 MB hoặc giải nén ra hơn 50 MB, đường dẫn chứa ...
• Khi cài, forum so khớp X-Content-Sha256 của gói; lệch checksum là bỏ, không giải nén.
• Toàn bộ đi HTTPS và kiểm chứng certificate.
• Plugin là code chạy trên forum của bạn: đọc README trước, thử ở forum phụ trước, và chỉ giao quyền Cài cho quản trị.

6. API để tự viết công cụ

Địa chỉ gốc https://ddvn.me/api/market, token dùng làm Authorization: Bearer ….

Hay gặp lỗi?

Không thấy plugin nào / Làm mới báo lỗi — thường là server bị chặn HTTPS đi ra ngoài, hoặc dòng market_endpoint gõ sai. Mở trực tiếp https://ddvn.me/api/market/plugins trên trình duyệt để kiểm tra: thấy JSON nghĩa là chợ vẫn ổn, lỗi nằm ở đường truyền từ forum của bạn.

Cài xong plugin không hiện — vào Admin → Plugins bật lên, rồi xoá cache ở Tools → Clear cache nếu giao diện không đổi.

Gặp lỗi khác thì phản hồi ngay dưới bài này, kèm tên plugin và phiên bản flatbb bạn đang chạy.