> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/san-pham/danh-muc-san-pham.md).
# Danh mục sản phẩm
Hiển thị danh mục sản phẩm trên Mini App và CMS
**Chức năng chính tại màn hình:**
| Vị trí | Mô tả |
| -------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **1. Danh sách danh mục** | Hiển thị tất cả danh mục chính đã tạo cùng với tên, số lượng danh mục con và thứ tự hiển thị. |
| **2. Bộ lọc & tìm kiếm** | Hỗ trợ tìm kiếm nhanh danh mục theo từ khóa. |
| **3. Sắp xếp hiển thị trên trang chủ** | Kéo thả hoặc chọn thứ tự ưu tiên danh mục hiển thị tại giao diện chính Mini App. |
| **4. Thao tác** | Chỉnh sửa  hoặc xóa  danh mục. |
## Tạo mới danh mục sản phẩm
Tạo mới danh mục
Khi chọn nút , hệ thống hiển thị popup với các trường thông tin như sau:
| Trường nhập | Bắt buộc | Mô tả |
| ------------------- | -------- | ----------------------------------------------------------------- |
| **Tên danh mục** | ✔️ | Tên nhóm sản phẩm, ví dụ: “Điện thoại”, “Đồ gia dụng” |
| **Mô tả danh mục** | ❌ | Ghi chú nội bộ hoặc mô tả ngắn |
| **Thứ tự hiển thị** | ✔️ | Giá trị số xác định vị trí hiển thị trên Mini App (0 là đầu tiên) |
| **Danh mục con** | ❌ | Có thể thêm nhiều danh mục con kèm hình ảnh, mô tả và thứ tự |
🔍 **Lưu ý**:
* Danh mục không có ảnh đại diện vẫn được lưu, nhưng sẽ hiển thị kém hấp dẫn.
* Tên danh mục không được trùng.
## Cập nhật danh mục trên trang chủ
Thứ tự hiển thị danh mục tại trang chủ
Giao diện chọn danh mục hiển thị trên Mini App:
* **Chọn/Loại bỏ** các danh mục từ dropdown.
* Nhấn nút  để áp dụng.
Sau khi lưu thành công, hệ thống hiển thị thông báo xác nhận.
## Chỉnh sửa danh mục
Chỉnh sửa danh mục
Để chỉnh sửa thông tin danh mục đã tạo:
1. Nhấn nút  ở dòng tương ứng.
2. Thực hiện chỉnh sửa nội dung hoặc thêm mới danh mục con.
3. Bấm nút  để lưu.
## Xoá danh mục
Xoá danh mục
Khi nhấn để xóa danh mục, hệ thống sẽ hiển thị thông báo xác nhận:
> **Cảnh báo**: Dữ liệu sẽ không thể phục hồi sau khi xóa.\
> Chỉ nên xóa danh mục nếu chắc chắn không còn sử dụng trong hệ thống.
## Quy định kỹ thuật
* **Thứ tự hiển thị (Mini App)**: Sắp xếp danh mục sản phẩm theo số thứ tự tăng dần.
* **Ảnh danh mục con**: Khuyến nghị kích thước tối thiểu 500x500px, định dạng PNG hoặc JPG.
* **Giới hạn độ dài tên danh mục**: Tối đa 100 ký tự.