Giao diện

Cài đặt và sử dụng ​

Cài đặt ​

Plugin @digiforce-nc/plugin-kanban thường được cài sẵn trong bản phân phối chính. Kích hoạt qua trang Plugin Manager.

Plugin hoạt động hoàn toàn ở client — nhóm dữ liệu client-side theo field giá trị.

Thêm Kanban block ​

  1. Mở trang ở chế độ thiết kế (Schema Editor).
  2. Click Add block → chọn Kanban.
  3. Chọn collection muốn hiển thị.
  4. Chọn group field — field kiểu select hoặc radioGroup để phân cột.
  5. Kanban board xuất hiện với các cột tương ứng mỗi option.

Bắt buộc

Collection phải có ít nhất một field kiểu select hoặc radio để làm group field. Không thể tạo Kanban block nếu không có field phù hợp.

Cơ chế phân cột ​

BướcMô tả
1Lấy danh sách options từ group field (VD: To Do, In Progress, Done)
2Mỗi option tạo thành một cột trên board
3Bản ghi được phân vào cột tương ứng với giá trị field
4Khi kéo card sang cột khác → cập nhật giá trị field

Kéo thả card ​

  • Kéo card giữa các cột: Thay đổi giá trị group field (VD: chuyển task từ "To Do" sang "In Progress").
  • Kéo card trong cùng cột: Thay đổi thứ tự sắp xếp.
  • Plugin sử dụng react-beautiful-dnd cho trải nghiệm kéo thả mượt mà.

Mỗi lần kéo thả, hệ thống tự động gửi PATCH request cập nhật giá trị field trên server.

Thiết kế card ​

Mỗi card hiển thị nội dung tùy chỉnh:

  1. Mở Card Designer từ Settings.
  2. Kéo thả field vào card layout: title, description, avatar, tags, date...
  3. Card template áp dụng cho tất cả card trên board.

Tạo nhanh card ​

Mỗi cột có nút + (Card Adder) để tạo nhanh bản ghi:

  1. Click + ở đầu hoặc cuối cột.
  2. Nhập thông tin cơ bản.
  3. Bản ghi mới tự động có giá trị group field = cột hiện tại.

Xem chi tiết ​

Click vào card → popup Card Viewer hiển thị chi tiết bản ghi. Từ đây có thể chỉnh sửa, xem lịch sử, hoặc thực hiện action.

Mẹo

Kanban lý tưởng cho quản lý task, pipeline bán hàng, theo dõi tiến độ — bất kỳ quy trình nào có các giai đoạn rõ ràng.