Định nghĩa Metafield là các mẫu định nghĩa cho phép bạn xác định rõ ràng loại dữ liệu nào có thể được lưu trữ trong một metafield và nó được áp dụng ở đâu. Điều này giúp đảm bảo tính nhất quán và độ tin cậy của dữ liệu.

I. Định nghĩa Metafield

1. Các tính năng của Định nghĩa Metafield

  1.1. Tạo Định nghĩa mới:

• Tạo các trường dữ liệu tùy chỉnh để lưu trữ thông tin đặc biệt.

• Áp dụng cho nhiều tài nguyên như sản phẩm, phiên bản sản phẩm, đơn hàng

  1.2. Quản lý Định nghĩa:

• Chỉnh sửa các thông tin về định nghĩa như tên, quy tắc áp dụng và mô tả.

• Xóa các định nghĩa không còn cần thiết và các metafield của định nghĩa đó.

  1.3. Thiết lập Quy tắc xác thực:

• Đặt các quy tắc để đảm bảo dữ liệu nhập vào phù hợp với định dạng và giới hạn cho phép.

• Các quy tắc bao gồm giới hạn ký tự, giá trị tối thiểu và tối đa, kiểu dữ liệu (số, văn bản, URL, v.v.).

  1.4. Tích hợp với Giao diện người dùng:

• Kết nối các metafields với giao diện trang sản phẩm hoặc đơn hàng để hiển thị thông tin cho khách hàng.

2. Nghiệp vụ chủ cửa hàng có thể sử dụng

 2.1. Tối ưu hóa Quản lý sản phẩm:

• Lưu trữ thông tin chi tiết về sản phẩm như hướng dẫn sử dụng, thời gian đốt (đối với nến), hạn sử dụng (đối với thực phẩm).

• Tăng cường khả năng tìm kiếm và lọc sản phẩm dựa trên các thông tin chi tiết.

  2.2. Quản lý Đơn hàng hiệu quả:

• Lưu trữ thông tin đặc biệt về đơn hàng như ghi chú của khách hàng, trạng thái vận chuyển chi tiết.

• Hỗ trợ quản lý và theo dõi các đơn hàng phức tạp.

3. Các bước thiết lập định nghĩa Metafield

Bước 1 : Truy cập vào phần quản trị Sapo

• Đăng nhập vào tài khoản Sapo của bạn.

• Từ trang quản trị, chọn Cấu hình .

Bước 2: Truy cập vào Metafields

• Trong menu bên trái, chọn Metafield.

• Chọn tài nguyên bạn muốn tạo định nghĩa Metafield nhằm ghi nhận metafield tại đó(ví dụ: Sản phẩm) để thiết lập định nghĩa metafield cho sản phẩm.

Danh sách các định nghĩa bao gồm : 

• Các định nghĩa: Định nghĩa do chủ cửa hàng chủ động tạo

• Các metafield không có định nghĩa: 

• Các metafield do người dùng tạo trước đây không trùng không gian tên và khoá với định nghĩa nào tại mục “Định nghĩa”

• Các ứng dụng tạo metafield trên hệ thống và không gắn với bất cứ định nghĩa nào hoặc các metafield của bạn, hệ thống sẽ tự động phân loại metafield vào mục “Metafield không có định nghĩa” 

Bước 3: Tạo Định Nghĩa Metafield Mới

• Nhấn vào Thêm định nghĩa

• Điền các thông tin cần thiết như :

• Tên: Đặt tên cho metafield, ví dụ: "Burn Time" (Thời gian đốt).

• Không gian tên và Khoá: Đây là 2 thông tin cần là duy nhất trên hệ thống và dùng để định danh trường thông tin của bạn với Sapo, ví dụ: "custom.burn_time".

• Mô tả: Mô tả ngắn gọn về metafield này, ví dụ: "Thời gian đốt của nến tính bằng giờ" .

• Loại dữ liệu: Chọn loại dữ liệu bạn muốn thiết lập cho metafield. Sapo hỗ trợ nhập một giá trị hoặc danh sách các giá trị theo loại bạn đã chọn, ví dụ: Văn bản một dòng" .

Bước 4: Cấu hình  Các điều kiện áp dụng (Không bắt buộc)

• Thêm các quy tắc xác thực để đảm bảo dữ liệu nhập vào đúng định dạng, ví dụ: giá trị tối thiểu là 1 và tối đa là 100.

Bước 5 : Thiết lập tính năng nâng cao

• Chọn để sử dụng metafield này làm bộ lọc trong trang quản trị danh sách Sản phẩm hoăc Đơn hàng. 

• Đúng/Sai 

• Văn bản một dòng

• Tham chiếu: Sản phẩm, Phiên bản sản phẩm

Bước 6: Lưu Định Nghĩa Metafield

• Sau khi điền đầy đủ thông tin, nhấn Lưu để hoàn tất việc tạo định nghĩa metafield.

• Để đưa metafield lên đầu danh sách, bạn có thể chọn icon ghim lên đầu

4. Tạo định nghĩa metafield cho các metafield đã tạo trước đó

Trong trường hợp bạn đã ghi nhận metafield trước khi tạo định nghĩa, Sapo hỗ trợ bạn chuyển đổi các metafield để gắn với định nghĩa như sau: 

Bước 1 : Truy cập mục “Metafield không có định nghĩa” 

Bước 2 : Tạo Định Nghĩa Metafield Mới

• Nhấn vào Thêm định nghĩa

• Điền các thông tin cần thiết như:

• Tên: Đặt tên cho metafield, ví dụ: "Burn Time" (Thời gian đốt).

• Không gian tên và Khoá: Hai thông tin này không thể đổi và bắt buộc phải trùng với metafield đã tạo trước đó

• Mô tả: Mô tả ngắn gọn về metafield này, ví dụ: "Time in hours the candle burns" (Thời gian đốt của nến tính bằng giờ).

• Loại dữ liệu: Chọn loại dữ liệu bạn muốn thiết lập cho metafield. Sapo hỗ trợ nhập một giá trị hoặc danh sách các giá trị theo loại bạn đã chọn, ví dụ: "Văn bản một dòng" .

Bước 3 : Cấu hình  Các điều kiện áp dụng (Không bắt buộc)

• Thêm các quy tắc xác thực để đảm bảo dữ liệu nhập vào đúng định dạng, ví dụ: giá trị tối thiểu là 1 và tối đa là 100.

Danh sách các loại dữ liệu Định nghĩa Metafield hỗ trợ

II. Thêm Metafield Trong Chi Tiết Sản Phẩm, Lọc Theo Metafield

Bước 1 : Truy cập vào Sản phẩm

• Từ trang quản trị, chọn Danh sách Sản phẩm.

• Chọn sản phẩm bạn muốn thêm metafield.

Bước 2 : Thêm Metafield

• Trong trang chi tiết sản phẩm, cuộn xuống phần Metafields.

• Chọn metafield bạn đã tạo trước đó, ví dụ: "Burn Time".

• Nhập giá trị cho metafield này, ví dụ: "40" (nến này đốt được 40 giờ).

Bước 3 : Lọc Sản Phẩm Theo Metafield

• Trở lại danh sách sản phẩm.

• Ở thanh tìm kiếm, chọn Thêm bộ lọc

• Chọn Metafields và nhập giá trị của metafield bạn muốn lọc, ví dụ: lọc tất cả sản phẩm có "Burn Time" là 10 giờ.