Hiểu chi tiết về tiện ích mở rộng của bạn

TL;DR / Tổng quan

Tài liệu tham khảo này giải thích chi tiết từng thiết lập khi cấu hình một Extension trên nền tảng Nilead. Extensions đóng vai trò như các loại nội dung tùy chỉnh, và cấu trúc của chúng xác định cách dữ liệu được lưu trữ, liên kết, cũng như sử dụng trên toàn hệ thống. Hiểu rõ các thiết lập này giúp bạn quản lý dữ liệu hiệu quả và đảm bảo hành vi ổn định cho giao diện người dùng.

Điều kiện cần thiết

• Quyền truy cập Admin hoặc Editor cho trang Nilead của bạn

• Kiến thức cơ bản về cấu trúc trang và mối quan hệ dữ liệu

• Truy cập vào mục CMS > Extensions

Hướng dẫn từng bước

Tên và Đường dẫn Extension

• Tên Extension:

  • Được sử dụng nội bộ để định danh trong giao diện quản trị

  • Bạn có thể đổi tên bất cứ lúc nào mà không ảnh hưởng đến hoạt động của trang

• Đường dẫn Extension:

  • Quan trọng cho việc tạo URL và truy cập dữ liệu backend

  • Tự động tạo dạng số ít và số nhiều (ví dụ: /event, /events)

  • Được dùng để xây dựng URL cho trang danh sách/chi tiết đối tượng

  • Thay đổi đường dẫn sau khi đã xuất bản? Hãy thiết lập chuyển hướng 301 để duy trì SEO và tính toàn vẹn liên kết. Xem: Quản lý chuyển hướng URL

📌 Thực tiễn tốt nhất: Hãy chọn đường dẫn ngắn, mô tả rõ ràng và viết thường (ví dụ: team-member, faq, product).

Các trường trong Extension

Các trường giúp xác định cấu trúc cho mỗi mục nội dung trong Extension. Chúng không phải là thành phần giao diện mà là các vùng chứa dữ liệu, có thể liên kết với các bố cục giao diện về sau.

Các loại trường được hỗ trợ:

• Văn bản (một dòng hoặc nhiều dòng)

• Số

• Hình ảnh

• Tệp

• Boolean (công tắc có/không)

• Ngày/Giờ

• Danh sách chọn / Select

• Tham chiếu (liên kết với một tiện ích mở rộng khác)

• Văn bản Rich Text / Trình soạn thảo HTML

• Slug / Đường dẫn

• Khối JSON hoặc mã (nâng cao)

Đối với mỗi trường, bạn có thể cấu hình:

• Nhãn: Tên hiển thị của trường trên biểu mẫu quản trị

• Văn bản trợ giúp: Hiển thị cho cộng tác viên khi chỉnh sửa nội dung

• Trạng thái bắt buộc: Bảo đảm một số dữ liệu luôn được điền

• Giá trị mặc định / Placeholder: Nội dung hoặc gợi ý tùy chọn

📌 Cảnh báo: Đổi tên hoặc xóa trường có thể gây gián đoạn cho nội dung hoặc liên kết thiết kế hiện có. Nếu không chắc chắn, hãy liên hệ bộ phận hỗ trợ trước khi thực hiện thay đổi.

Trường tham chiếu

Trường tham chiếu cho phép liên kết một tiện ích mở rộng với một tiện ích khác, giúp xây dựng cấu trúc nội dung linh hoạt và có tính liên kết.

Trường hợp sử dụng tiêu biểu:

• Bài đăng Blog liên kết tới Tác giả

• Sản phẩm liên kết tới Thương hiệu hoặc Danh mục

• Sự kiện liên kết tới Địa điểm

Các tính năng chính:

• Thay đổi ở một mục tham chiếu sẽ tự động cập nhật trên các mục liên kết

• Bạn có thể tạo mối quan hệ một-một hoặc một-nhiều

⚠️ Lưu ý hiệu năng:
Tránh sử dụng các trường tham chiếu quá phức tạp hoặc lồng nhiều lớp — điều này có thể làm chậm quá trình hiển thị nội dung và tăng nguy cơ gặp lỗi đồng bộ dữ liệu.

Tiện ích mở rộng riêng tư

Sử dụng tùy chọn Riêng tư để ngăn việc tự động tạo trang hiển thị công khai.

Khi nào nên dùng:

• Các cấu trúc dữ liệu lồng nhau (ví dụ: các phần của bài viết, câu trả lời cho FAQ)

• Dữ liệu chỉ sử dụng ở backend để xử lý logic hoặc phản hồi API

• Nội dung động được chèn vào các mẫu khác mà không cần tạo một trang riêng biệt

Đánh dấu một phần mở rộng là riêng tư:

• Ẩn khỏi hệ thống định tuyến tự động

• Vẫn cho phép tham chiếu nội dung trong thiết kế và logic

• Giữ giao diện quản trị gọn gàng, dễ quản lý cho biên tập viên

FAQs

1. Điều gì sẽ xảy ra nếu tôi thay đổi đường dẫn extension sau khi đã xuất bản trang web?
Bạn nên thiết lập chuyển hướng 301 để đảm bảo các liên kết cũ vẫn hoạt động. Kiểm tra phần cài đặt chuyển hướng trong CMS > Chuyển hướng.

2. Tôi có thể xóa trường dữ liệu sau khi đã sử dụng không?
Có, nhưng xóa trường có thể làm hỏng liên kết thiết kế hoặc bộ lọc. Hãy cẩn trọng và cân nhắc sao lưu dữ liệu trước khi thực hiện.

3. Các extension riêng tư có bị ẩn khỏi giao diện CMS không?
Không — chế độ riêng tư chỉ ảnh hưởng đến việc tạo trang ở frontend. Bạn vẫn có thể quản lý và tham chiếu chúng trong hệ thống.

4. Mỗi extension nên có bao nhiêu trường hoặc tham chiếu?
Không có giới hạn cụ thể, nhưng để đảm bảo hiệu suất và dễ bảo trì, hãy xây dựng cấu trúc rõ ràng, hạn chế lồng nhau phức tạp.

5. Tôi có thể tạo trường tham chiếu đến nhiều extension không?
Không, mỗi trường tham chiếu chỉ có thể liên kết với một extension. Nếu cần, hãy tạo nhiều trường hoặc điều chỉnh lại logic của bạn.