Vendure电商系统中的集合(Collections)功能详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01096/article/details/148487215

Vendure电商系统中的集合(Collections)功能详解

vendure A headless GraphQL commerce platform for the modern web 项目地址: https://gitcode.com/gh_mirrors/ve/vendure

什么是集合(Collections)

在Vendure电商系统中，集合(Collections)是用于分类和组织产品目录的核心功能。它类似于传统电商系统中的"分类"或"类别"概念，但功能更为强大和灵活。

集合允许你将多个产品变体(Product Variants)分组在一起，而一个产品变体也可以同时属于多个集合。这种多对多的关系设计为电商运营提供了极大的灵活性。

集合的核心特性

1. 层级结构

集合支持嵌套结构，可以创建多级分类层次。这种特性非常适合用于构建：

网站导航菜单
面包屑导航
多级产品分类展示

2. 多种应用场景

集合不仅仅是用于导航分类，还可以用于：

创建"新品上市"专区，展示在首页
建立"畅销商品"集合，展示热门产品
设置"促销商品"集合，便于统一应用促销规则

集合过滤器(Collection Filters)详解

集合的核心功能在于其强大的过滤系统，它决定了哪些产品变体会被包含在集合中。

内置过滤器类型

Vendure提供了多种开箱即用的过滤器：

按属性值过滤：基于产品变体的属性值(如颜色、尺寸等)进行筛选
按产品变体名称过滤：通过名称关键词匹配产品
手动选择产品变体：精确选择特定变体
手动选择产品：选择整个产品及其所有变体

过滤器继承机制

当子集合继承父集合的过滤器时，会形成一种"与"逻辑关系：

子集合中的产品变体必须同时满足父集合和自身的过滤条件
这种机制确保了分类结构的逻辑一致性

如果需要创建与父集合无关的子分类，可以关闭继承功能。

自定义过滤器开发指南

Vendure允许开发者创建自定义过滤器来满足特定业务需求。

开发步骤

创建CollectionFilter实例
定义可配置参数(args)
实现apply()方法中的过滤逻辑
将自定义过滤器添加到系统配置中

示例：SKU过滤器

import { CollectionFilter, LanguageCode } from '@vendure/core';

export const skuCollectionFilter = new CollectionFilter({
    args: {
        sku: {
            type: 'string',
            label: [{ languageCode: LanguageCode.en, value: 'SKU' }],
            description: [
                {
                    languageCode: LanguageCode.en,
                    value: 'Matches any product variants with an SKU containing this value',
                },
            ],
        },
    },
    code: 'variant-sku-filter',
    description: [{ languageCode: LanguageCode.en, value: 'Filter by matching SKU' }],
    apply: (qb, args) => {
        const LIKE = qb.connection.options.type === 'postgres' ? 'ILIKE' : 'LIKE';
        return qb.andWhere(`productVariant.sku ${LIKE} :sku`, {
            sku: `%${args.sku}%`
        });
    },
});