Thêm trường dữ liệu tùy chỉnh

Trường dữ liệu tùy chỉnh, gọi là Metafield, lưu thêm thông tin cho sản phẩm mà biểu mẫu sản phẩm không có sẵn, ví dụ hướng dẫn giặt hoặc chất liệu. Bạn tạo định nghĩa một lần, rồi điền giá trị ở từng sản phẩm.

Giá trị không tự hiện trên cửa hàng. Giao diện phải đọc trường này, nên phần cuối bài dành cho người sửa code giao diện.

Tạo định nghĩa cho sản phẩm

1. Vào Cài đặt › Dữ liệu tùy chỉnh.
2. Trong mục Định nghĩa Metafield, chọn Sản phẩm.
3. Bấm Thêm định nghĩa.
4. Nhập Tên, ví dụ Hướng dẫn giặt. Mã ngay dưới ô tự điền theo tên, ví dụ custom.huong_dan_giat.
5. Ở Kiểu dữ liệu, chọn một kiểu, ví dụ Văn bản nhiều dòng.
6. Trong mục Tùy chọn, bật Truy cập từ storefront nếu muốn giao diện đọc được giá trị.
7. Bấm Lưu.

Cùng cách này, bạn thêm trường cho biến thể, bộ sưu tập, trang, bài viết và các phần khác trong danh sách Định nghĩa Metafield.

Điền giá trị cho một sản phẩm

1. Vào Sản phẩm và mở một sản phẩm đã lưu.
2. Tìm mục Metafield.
3. Nếu trường chưa có ô nhập, bấm nút mang tên trường, ví dụ Hướng dẫn giặt.
4. Nhập giá trị.
5. Bấm Lưu.

Mục Metafield chỉ có trên sản phẩm đã lưu. Muốn trường luôn có ô nhập ở đầu mục, bấm Ghim trên trang định nghĩa.

Đọc giá trị trong giao diện code

Khi định nghĩa bật Truy cập từ storefront, storefront API trả giá trị kèm sản phẩm trong trường metafields, theo mã vùng tên và khóa. Giao diện code dùng gói @ecomweb/storefront-kit đọc giá trị bằng hàm metafield:

Hàm trả về undefined khi sản phẩm chưa có giá trị, hoặc khi định nghĩa chưa bật Truy cập từ storefront. Với kiểu Văn bản định dạng, hiện giá trị bằng thành phần RichText của cùng gói.

Đặt giá trị bằng CLI

Nếu bạn dùng EcomWeb CLI, bạn xem định nghĩa và đặt giá trị mà không cần mở bảng điều khiển.

# Xem các định nghĩa của sản phẩm
$ ecomweb metafield-definitions list --owner-type product
# Đặt giá trị cho một sản phẩm
$ ecomweb metafields set --owner product:<product-id> --key custom.huong_dan_giat --value '"Giặt nước lạnh"'

Xóa một định nghĩa

1. Vào Cài đặt › Dữ liệu tùy chỉnh và chọn Sản phẩm.
2. Mở định nghĩa cần xóa.
3. Bấm Tác vụ khác › Xóa định nghĩa.
4. Bấm Xóa định nghĩa để xác nhận.