AEM Content & Commerce创作选取器 cif-pickers

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

产品选取器 product-picker

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

<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字段,您可以导航到用户希望通过不同视图选择的产品。 默认情况下, product字段会返回产品的ID,但可以使用进行配置 selectionId 属性。

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

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

此外,标准对话框字段属性,如 namefieldLabel,或 fieldDescription,受支持。

CAUTION
cifproductfield 组件需要 cif.shell.picker clientlib。 要将clientlib添加到对话框,您可以使用extraClientlibs属性。
CAUTION
从CIF核心组件版本2.0.0开始,支持 id 已移除并替换为 uid. Adobe建议使用 skuslug 作为产品标识符。 Adobe继续支持 id 仅适用于使用CIF核心组件1.x版的项目。

的完整工作示例 cifproductfield 可在以下位置找到: CIF核心组件 项目。 另请参阅 自定义对话框 AEM核心组件文档的FTP站点。

类别选取器 category-picker

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

以下代码片段可以在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)。
  • multiple (true, false) — 启用一个或多个类别的选择(默认值= false)

此外,标准对话框字段属性,如 namefieldLabel,或 fieldDescription,受支持。

CAUTION
cifproductfield 组成 cifcategoryfield 组件还需要 cif.shell.picker clientlib。 要将clientlib添加到对话框,您可以使用 extraClientlibs 属性。 请参阅 自定义对话框 AEM核心组件文档的FTP站点。
CAUTION
从CIF核心组件版本2.0.0开始,支持 id 已移除并替换为 uid. Adobe建议使用 uidurlPath 作为类别标识符。 Adobe继续支持 ididAndUrlPath 仅适用于使用CIF核心组件1.x版的项目。

的完整工作示例 cifcategoryfield 可在以下位置找到: CIF核心组件 项目。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab