> 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ự.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/san-pham/danh-muc-san-pham.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.