元字段功能模块能够让您在 SHOPLINE后台中存储拓展字段，以此来实现店铺外观定制、功能定制的效果。通过使用元字段，您能够实现对店铺设计和商品页面的个性化配置或多样化展示效果，例如：
- 在商品详情页中为您的多款商品添加不同的使用说明书
- 在不同的商品列表页中，添加不同的折扣优惠信息
- 为服饰商品添加不同的材质说明、洗涤建议等
- 为首饰类商品，添加「克拉数」展示信息
- 为不同的商品，添加不同的发货公告
您也可以点击元字段博客文章查看功能的详细介绍。
此篇文章将分为5个部分：
1.元字段使用步骤概览
2.元字段简介
2.1元字段的组成
2.2元字段的数据类型
3.创建元字段
4.给元字段赋值
5.如何在主题设计中配置元字段
5.1在编辑器中插入元字段动态源
5.2在Layout Engine代码中插入调用代码
每个元字段将只对单独的”资源类型“生效，因此要使用元字段，您将需要先确定您要创建元字段的资源类型，
1.元字段使用步骤概览
第一步：选择资源类型：每个元字段将只对单独的”资源类型“生效，因此要使用元字段，您将需要先确定您要创建元字段的资源类型
- 目前元字段的功能支持「商品」「商品款式」「商品分类」「自定义页面」「客户」「博客」「博客集合」资源类型
第二步：输入元字段的基本信息
第三步：在您的店铺Admin后台为元字段赋值
第四步：在页面编辑器中插入动态源或者在SHOPLINE Layout Engine里插入调用代码
2.元字段简介
2.1元字段的组成
输入元字段的基本信息元字段由「名称」「资源对象」「命名空间(Namespace)」「键(key)」「描述(Description)」以及「数据类型」组成
- 名称（Name）：元字段的名称。例如：商品材料。
- 资源对象（OwnerResource）：元字段所归属的资源类型，或称为"所有者资源类型"。例如：商品（products）、自定义页面（pages）等。
- 所有者资源ID（OwnerId）：元字段所归属的资源对象ID。例如：商品A的ID 1605898661。
- 命名空间(Namespace)：一组元字段的容器。通过命名空间对元字段进行分组，可防止商家的元字段与具有相同键名的其他元字段发生冲突。例如：my_fields。
- 键(Key)：元字段的名称，用以指向某元字段，通俗理解为此元字段的代码标识。例如：materials。
- 数据类型(Content_type)：元字段存储的数据类型，例如：单行文本、URL、整数等。
- 描述(Description)：该元字段定义的描述信息，用于帮助您在赋值时输入正确的值。例如：输入该首饰的材料信息。
- 值(Value)：要存储在元字段中的数据。例如：925 silver。
2.2元字段的数据类型
以下为元字段功能的
|
数据类型 |
子类 |
是否支持值列表 |
特性 |
使用场景举例 |
|
文本 |
单行文本 |
是 |
支持单行纯文本输入。 |
添加您的商品的发货公告 |
|
多行文本 |
是 |
支持多行纯文本输入。 |
为您的产品添加产品成分介绍表表 |
|
|
颜色 |
无 |
是 |
支持 #RRGGBB 格式的 RGB 值。 |
为您的页面添加底色 |
|
Json |
无 |
否 |
支持用于高级用例的原始 JSON 数据。 |
在店铺页面中添加自定义模块 |
|
数字 |
整数 |
是 |
仅支持输入整数。 |
添加书籍商品的特定页数说明 |
|
小数 |
是 |
支持输入整数+小数。 |
在商品详情页中添加珠宝的克拉数信息 |
|
|
URL |
无 |
是 |
支持 添加HTTP、HTTPS 和 mailto: |
在您的商品详情页添加url链接 |
|
日期和时间
|
日期 |
是 |
支持采用 ISO 8601 格式且不包含时区的日期值。 |
添加产品到期日期、订单配送日期或客户出生日期例：2022-05-28 |
|
日期和时间 |
是 |
支持采用 ISO 8601 格式的日期值和采用 UTC 时间的时间值。 |
2022-01-01T12:30:00 |
|
|
true 或 false |
无 |
否 |
布尔类型 ，创建一个复选框，用于选择条件是 true 还是 false。 |
添加是否提供某个选项，例如产品是否可以雕刻 例： true |
|
度量
|
重量 |
是 |
支持整数和小数值。重量使用公制或英制度量单位，kg, g, lb,oz |
添加产品或配料的重量，例如糖的克数 例：{\"value\":3.0,\"unit\":\"oz\"} |
|
尺寸 |
是 |
支持整数和小数值。尺寸使用公制或英制度量单位。mm,cm,m,inch,foot,code |
尺寸：添加包装箱高度或产品长度，例如围巾的长度 例：{\"value\":2.0,\"unit\":\"in\"} |
|
|
体积 |
是 |
支持整数和小数值。体积使用公制或英制度量单位 一个值和一个体积单位。有效单位值：ml, cl, l, m3(立方米), us_fl_oz, us_pt, us_qt, us_gal, imp_fl_oz, imp_pt, imp_qt, imp_gal |
体积：添加水杯的体积容量 例：{\"value\":1.0,\"unit\":\"us_fl_oz\"} |
|
|
评分 |
无 |
是 |
支持配置评分或星级。 |
为产品添加用户评分或星级评分 例：{\"value\":\"5\"} |
|
参考
|
商品 |
是 |
支持对在线商店中的商品进行引用。 |
在在线商店的产品页面或产品系列页面上，设置显示特色产品 例：gid://shopline/Product/160589866 |
|
商品款式 |
是 |
支持对在线商店中的商品款式进行引用。 |
在在线商店的产品页面上，设置显示具有相同颜色的其他服装商品 例：gid://shopline/ProductVariant/1805951613 |
|
|
商品分类 |
是 |
支持对在线商店中的商品分类进行引用。 |
例：gid://shopline/collections/1225615767 |
|
|
页面 |
是 |
支持对在线商店中的自定义页面进行引用。 |
在在线商店中插入政策页面或针对产品的详细保养指南 例：gid://shopline/Page/59592784 |
|
|
文件 |
是 |
图片：引用店铺文件库，或者上传大小为10MB以内JPG,JEPG,PNG,GIF格式的图片；
PDF：引用店铺文件库，或者上传大小为10MB以内的pdf文件。 |
gid://shopline/MediaImage/59301914
gid://shopline/GenericFile/596207872 |
|
|
资金 |
无 |
否 |
一个数字金额，具有与商店货币相匹配的货币代码。 |
{\"amount\":\"2\",\"currency_code\":\"USD\"} |
3.创建元字段
下面将以「创建商品资源类型元字段」为例进行介绍。
第一步：打开SHOPLINE店铺后台，点击「设置」，在设置中点击「元字段」模块
第二步：选择您要创建元字段的资源类型，目前支持创建「商品」「商品分类」「商品款式」「页面」「客户」「博客」「博客集合」「订单」资源类型的元字段。
在此流程中，我们选则商品资源类型进行元字段的创建
第三步：点击「创建字段定义」
第四步：填写字段名称、命名空间、密钥、以及描述，并选择您需要的数据类型，完毕后点击创建
第五步：创建完毕
元字段创建完毕后，您可以对元字段进行赋值
4.给元字段赋值
第一步：选择您要赋值的资源类型，上一流程中我们创建的元字段的资源类型是「商品」，因此我们将前往SHOPLINE Admin的商品页面进行赋值。选择您要赋值的具体商品，在此流程中。我们将选择第一个商品
第二步：在页面底部找到「元字段」模块，选定元字段进行赋值。您可以输入的值的类型取决于元字段的数据类型。
完成对元字段的赋值流程。
5.如何在主题设计中配置元字段
5.1在编辑器中插入元字段动态源
请点击查看具体操作指引：
元字段 (Metafields) | 如何在主题设计中配置元字段
5.2在Layout Engine代码中插入调用代码
元字段创建并赋值完毕后，您可以在店铺后台-设置-元字段中找到对应字段的调用代码，复制后可在Layout Engine在线代码编辑器中应用以实现您的定制化需求。
注：若要访问在线代码编辑器，请联系SHOPLINE在线客服或建站顾问。
* 如有SHOPLINE功能使用感受或需求建议，快点击【功能反馈】告诉我们吧！
评论