Chuyển tới nội dung chính

Developer Portal Menu Management

Tổng Quan​

Hướng dẫn này sẽ giúp bạn quản lý cấu trúc menu điều hướng của Cổng thông tin Nhà phát triển. Bạn có thể cấu hình các menu nhiều cấp cho thanh điều hướng chính, liên kết từng mục với nội dung hoặc URL, và viết các trang chi tiết dựa trên HTML cho các nút menu cuối. Cấu trúc hỗ trợ lên đến 3 cấp độ sâu.

Điều Kiện Tiên Quyết​

Để truy cập quản lý menu:

  • Bạn phải có quyền truy cập Quản trị viên
  • Đi tới: Quản trị > Quản lý Menu

Hướng Dẫn Từng Bước​

Bước 1. Hiểu Cấu Trúc Menu​

Menu được cấu thành từ nhiều cấp độ:

  • Cấp 1: Điều hướng chính (ví dụ: Sản phẩm, Ứng dụng, Tài liệu, Diễn đàn)
  • Cấp 2: Nhóm menu con (ví dụ: Tất cả API, pentest)
  • Cấp 3: Các nút cuối (ví dụ: Ver.1, Hướng dẫn), nơi có thể thêm nội dung

Chỉ có các menu cấp 3 mới có thể có các trang nội dung có thể chỉnh sửa.

Bước 2. Thêm hoặc Chỉnh Sửa Mục Menu​

A. Để Thêm Một Mục Menu Mới:

  • Nhấp vào biểu tượng + bên cạnh menu cha mong muốn
  • Nhập tiêu đề menu (ví dụ: Hướng dẫn Người dùng)
  • Chọn khả năng hiển thị (Hiển thị / Ẩn)
  • Nhấp Đăng ký

B. Để Chỉnh Sửa Các Mục Hiện Có:

  • Nhấp vào biểu tượng bút chì bên cạnh một menu
  • Thay đổi tên hoặc sắp xếp lại theo nhu cầu
  • Nhấp Lưu để áp dụng

Bước 3. Viết hoặc Chỉnh Sửa Nội Dung Menu (Chỉ Cấp 3)​

Để chỉnh sửa nội dung của một nút cuối:

  • Chọn một menu như Tài liệu > Ver.1
  • Ở khung bên phải, nhập: | Field | Example | | --- | --- | | Tiêu đề | Ver. 1
    | | Hiển thị | Đã chọn | | Nội dung | Văn bản phong phú (trình chỉnh sửa HTML) |

Ví dụ Nội Dung Phong Phú:

# Quy Trình Onboarding API
## 1. Đăng Ký Một Ứng Dụng  
Đăng ký và đăng ký ứng dụng của bạn trong phần **Ứng dụng > Ứng dụng của tôi**.
## 2. Thiết Lập IP Referrer và Yêu Cầu Truy Cập
Cấu hình IP Referrers và gửi yêu cầu sử dụng API của bạn qua **Application > My Applications > API Usage**.
## 3. Kiểm tra và Sử dụng APIs  
Khi được phê duyệt, hãy kiểm tra API của bạn trong tab **Test** hoặc bắt đầu sử dụng thực tế.
## 4. Quản lý Thành viên Nhóm  
Thêm đồng đội vào ứng dụng đã đăng ký của bạn trong **Application > My Applications > Members**.

Thêm Hình ảnh hoặc Tệp:

  • Sử dụng nút Thêm Hình ảnh hoặc Thêm Tệp
  • Các tệp đã tải lên sẽ xuất hiện dưới trình soạn thảo và có thể đính kèm vào nội dung

Trình soạn thảo hỗ trợ tiêu đề, định dạng, liên kết, bảng và HTML nội tuyến.

Bước 4. Lưu Nội dung Menu​

  • Khi việc chỉnh sửa hoàn tất, hãy nhấp vào nút Lưu ở dưới cùng của khung nội dung
  • Xác nhận rằng nội dung hiển thị đúng khi truy cập vào Cổng thông tin Nhà phát triển

Thực tiễn Tốt nhất​

  • Sử dụng cấu trúc rõ ràng, phân cấp để tổ chức APIs và hướng dẫn
  • Nhóm các tham chiếu API theo miền hoặc dòng sản phẩm (ví dụ: /AI, /Security, /OpenAPI)
  • Giữ tiêu đề menu ngắn gọn (dưới 25 ký tự để dễ đọc)
  • Sử dụng trình soạn thảo HTML để nâng cao khả năng đọc với tiêu đề, liên kết và kiểu dáng
  • Định kỳ xem xét các liên kết hỏng hoặc nội dung lỗi thời