Metadata giúp bạn lưu thêm các thông tin không thuộc những trường mặc định như tiêu đề, nội dung, mô tả hoặc ảnh đại diện. Ví dụ: mã chiến dịch, tên tác giả hiển thị, nội dung tài trợ hoặc một cờ bật/tắt tính năng riêng cho bài viết.

Khai báo metadata trong trang quản trị

Đăng nhập trang quản trị bằng tài khoản có quyền quản lý cài đặt, sau đó truy cập:
EzyArticle → Cài đặt
Bạn cũng có thể mở trực tiếp đường dẫn:
/ezyarticle/settings
Tìm trường Các siêu dữ liệu bài viết bổ sung. Trường này nhận một đối tượng JSON, trong đó:
  • Mỗi thuộc tính cấp cao nhất là tên của một metadata.
  • type quy định loại ô nhập liệu.
  • defaultValue là giá trị mặc định được khai báo cho metadata.
Ví dụ: 
{
  "action_banner_image": {
    "type": "HTML",
    "defaultValue": ""
  },
  "action_banner_link": {
    "type": "BOOLEAN",
    "defaultValue": "false"
  },
  "product_url": {
    "type": "TEXT",
    "defaultValue": ""
  }
}
Screenshot 2026-09-08 at 22.50.12.png
Sau khi nhập xong, nhấn Lưu ở cuối trang. Bạn cũng có thể dùng Ctrl + S trên Windows/Linux hoặc Command + S trên macOS.
JSON phải đúng cú pháp. Nếu dữ liệu không hợp lệ, hệ thống sẽ báo lỗi và không lưu cấu hình.

Các kiểu dữ liệu được hỗ trợ

Giao diện chỉnh sửa được tạo theo giá trị của type:
KiểuThành phần nhập liệuPhù hợp với
TEXTÔ nhập một dòngMã, tên, URL hoặc dữ liệu ngắn
HTMLÔ nhập nhiều dòngNội dung HTML hoặc văn bản dài
BOOLEANDanh sách chọn true/falseCác tùy chọn bật/tắt
Nếu khai báo một kiểu khác HTML hoặc BOOLEAN, giao diện hiện tại sẽ hiển thị một ô nhập văn bản thông thường.
Tên metadata nên:
  • Viết liền và không chứa khoảng trắng.
  • Dùng chữ cái, chữ số và dấu gạch dưới hoặc camelCase.
  • Không thay đổi sau khi đã có dữ liệu.
  • Thể hiện rõ mục đích, chẳng hạn campaignCode, externalUrl hoặc featured.

Nhập metadata cho bài viết

Sau khi lưu cấu hình:
  1. Mở EzyArticle → Bài viết.
  2. Tạo bài viết mới hoặc mở một bài viết để chỉnh sửa.
  3. Di chuyển đến phần Siêu dữ liệu.
  4. Nhập giá trị cho các trường vừa khai báo.
  5. Nhấn Lưu, Xuất bản hoặc Cập nhật bài viết.
Tên kỹ thuật của metadata được hiển thị trong ngoặc bên cạnh nhãn, giúp bạn xác định chính xác trường đang chỉnh sửa.
Screenshot 2026-09-08 at 22.50.54.png
Ví dụ, với cấu hình trên, phần Siêu dữ liệu sẽ có:
  • Action Banner Image: Ảnh banner quảng cáo.
  • Action Banner Link: Link quảng cáo.
  • Đường dẫn sản phẩm (product_url): Link sản phẩm.
Khi lưu bài viết, các giá trị này được lưu cùng metadata của bài viết. Khi mở lại màn hình chỉnh sửa, hệ thống tự động điền các giá trị đã lưu vào biểu mẫu.

Phân biệt với metadata có thể truy xuất

Ngay bên dưới phần cấu hình metadata còn có trường Các siêu dữ liệu bài viết có thể truy xuất.
Hai trường có mục đích khác nhau:
  • Các siêu dữ liệu bài viết bổ sung: tạo trường nhập liệu trong giao diện biên tập.
  • Các siêu dữ liệu bài viết có thể truy xuất: cho phép những metadata nhất định được lấy qua chức năng truy xuất phía web.
Việc thêm một metadata vào biểu mẫu không đồng nghĩa metadata đó tự động được công khai. Nếu cần cho phía web truy xuất, hãy nhập danh sách tên metadata được cho phép, phân tách bằng dấu phẩy, chẳng hạn: 
campaignCode,featured
Chỉ công khai những metadata thực sự cần thiết. Không nên đưa thông tin bí mật, khóa truy cập hoặc dữ liệu nội bộ vào danh sách này.

Thay đổi hoặc xóa cấu hình

Bạn có thể quay lại EzyArticle → Cài đặt để sửa JSON bất kỳ lúc nào.
Cần lưu ý:
  • Đổi tên một metadata sẽ tạo ra một trường mới; dữ liệu đã lưu dưới tên cũ không tự động được chuyển sang.
  • Xóa metadata khỏi cấu hình chỉ làm trường đó biến mất khỏi biểu mẫu nhập liệu.
  • Dữ liệu metadata cũ đã lưu trên bài viết không nhất thiết bị xóa theo.
  • Các metadata mặc định của hệ thống vẫn có thể xuất hiện cùng metadata do bạn khai báo.

Lưu ý về Trang

Qua đối chiếu mã nguồn hiện tại, cấu hình Các siêu dữ liệu bài viết bổ sung đã được nối đầy đủ vào màn hình tạo và chỉnh sửa Bài viết.
Màn hình tạo/chỉnh sửa Trang hiện chưa hiển thị khối nhập metadata này. Vì vậy, sau khi cấu hình, bạn sẽ thấy các trường mới ở phần chỉnh sửa bài viết nhưng chưa thấy chúng trong phần chỉnh sửa trang. Để hỗ trợ Trang, giao diện chỉnh sửa Trang cần được bổ sung khối metadata và luồng khởi tạo tương ứng.