AEM Content & Commerce创作选取器

AEM Content & Commerce Authoring提供了一套创作工具,可帮助AEM作者和营销人员高效地处理商务产品数据和目录。 产品选取器和类别选取器是CIF附加组件的一部分,供CIF核心组件使用。 项目可以在任何组件对话框中使用这些选取器来选择产品或类别。

产品选取器

要在项目组件中使用产品选取器,开发人员必须添加 commerce/gui/components/common/cifproductfield 对话框。 例如,对cq使用以下内容:dialog:

<product jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifproductfield"
    fieldDescription="The product or product variant displayed by the teaser"
    fieldLabel="Select Product"
    filter="folderOrProductOrVariant"
    name="./selection"
    selectionId="sku"/>

产品字段允许通过不同视图导航到用户要选择的产品。 默认情况下,product字段会返回产品的ID,但可以使用 selectionId 属性。

产品选取器字段支持以下可选属性:

  • selectionId(id、uid、sku、sug、combinedSlug、combinedSku) — 允许选择选取器返回的产品属性(默认= id)。 使用sku可返回选定产品的SKU,使用combinedSku时,将返回诸如base#variant之类的字符串(其中包含基本产品和所选变体的SKU);或者,如果选择了基本产品,则返回单个SKU。
  • filter(folderOrProduct、folderOrProductOrVariant) — 在导航产品树时筛选器要呈现的内容。 folderOrProduct — 渲染文件夹和产品。 folderOrProductOrVariant — 渲染文件夹、产品和产品变体。 如果某个产品或产品变体已呈现,则它也会在选取器中变为可选。 (默认值= folderOrProduct)
  • 多个(true, false) — 启用对一个或多个产品的选择(default = false)
  • emptyText — 配置选取器字段的空文本值

此外,标准的图表字段属性,如 name, fieldLabelfieldDescription 也受支持。

注意

cifproductfield 组件需要 cif.shell.picker clientlib。 要向对话框中添加clientlib,您可以使用extraClientlibs属性。

注意

从CIF核心组件版本2.0.0开始,支持 id 已删除,替换为 uid. 我们强烈建议使用 skuslug 作为产品标识符。 我们继续支持 id 仅适用于使用CIF核心组件版本1.x的项目。

的完整工作示例 cifproductfield 可在 CIF核心组件 项目。 另请参阅 自定义对话框 AEM核心组件文档的“受众”部分。

类别选取器

类别选取器也可在组件对话框中使用,其方式与产品选取器类似。

以下代码片段可在cq:dialog配置中使用:

<category jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifcategoryfield"
    fieldLabel="Category"
    name="./categoryId"
    selectionId="uid" />

类别选取器字段支持以下可选属性:

  • selectionId(id, uid, slug, urlPath, idAndUrlPath) (已弃用), uidAndUrlPath (已弃用)) — 用于选择选取器要返回的类别属性(默认值= id)。
  • 多个(true, false) — 启用一个或多个类别的选择(default = false)

此外,标准的图表字段属性,如 name, fieldLabelfieldDescription 也受支持。

注意

cifproductfield 组件 cifcategoryfield 组件还要求 cif.shell.picker clientlib。 要向对话框中添加clientlib,您可以使用 extraClientlibs 属性。 请参阅 自定义对话框 AEM核心组件文档的“受众”部分。

注意

从CIF核心组件版本2.0.0开始,支持 id 已删除,替换为 uid. 我们强烈建议使用 uidurlPath 作为类别标识符。 我们继续支持 id & idAndUrlPath 仅适用于使用CIF核心组件版本1.x的项目。

的完整工作示例 cifcategoryfield 可在 CIF核心组件 项目。

在此页面上