元字段定义的组成部分
在创建元字段前,您需要先定义其结构与应用范围。每条元字段定义指定该字段适用于哪个模块(如产品、规格或客户),并设置字段值的类型、验证规则等。
一个完整的元字段定义包含以下部分:
字段名称 | 是否必填 | 描述 |
---|---|---|
名称 | 是 | 元字段在 Genstore 后台中显示的名称,例如 Color 。仅用于界面展示,无需唯一。 |
命名空间和密钥 | 是 | - 元字段的唯一识别码,格式为 namespace.key ,如 custom.color 。- 您可用命名空间将相关字段分组,每个组合必须全平台唯一。 - 仅支持字母、数字、下划线 ( _ ) 和连字符 (- ),如 products.expiration_date |
类型 | 是 | 字段值的数据类型,如文本、日期、URL、布尔值等。定义后将决定字段的输入控件和数据格式。更多信息,可阅读 元字段数据类型 |
描述 | 否 | 用于引导商户正确输入字段值。例如说明填写格式、用途或示例。该内容将显示在后台页面中。 |
验证 | 否 | 对字段值设置格式或范围限制。支持字符长度、正则表达式或预设选项。仅适用于特定数据类型。部分选项互斥,例如“预设选项”不能与“最小/最大字符数”同时启用。 |
值列表 | 否 | 是否支持为该字段输入多个值(如多个标签、颜色或文件)。启用后将以列表形式展示,字段类型必须支持多值输入。 |
选项(访问权限) | 否 | 控制该字段是否允许通过 Liquid 模板或 Storefront API 被读取: - 读取:可用于前台展示 - 无访问权限:仅用于后台管理,无法被前台获取 |
示例
以 产品到期日期
为例,其元字段定义可能为:
- 命名空间与密钥:
products.expiration_date
- 类型: 日期
- 描述: 按
YYYY/MM/DD
格式填写 - 验证规则: 仅允许
2025/01/01
到2030/12/31
之间的日期
如需了解每种字段类型的格式和用途,请阅读 元字段的开发人员文档。