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 — 配置选取器字段的空文本值

此外,还支持标准图表字段属性,如namefieldLabelfieldDescription

注意

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

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, sulg, idAndUrlPath, uidAndUrlPath) — 允许选择选取器返回的类别属性(默认值= id)。 idAndUrlPath & uidAndUrlPath是一些特殊选项,用于存储以 |字符,例如1|men/tops。
  • 多个(true, false) — 启用一个或多个类别的选择(default = false)

此外,还支持标准图表字段属性,如namefieldLabelfieldDescription

注意

cifproductfield组件相同,cifcategoryfield组件也需要cif.shell.picker clientlib。 要向对话框中添加clientlib,可以使用extraClientlibs属性。 请参阅AEM核心组件文档的自定义对话框

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

在此页面上