如何在WooCommerce中用wc_get_products按任意列分组产品并按最新排序

WooCommerce的wc_get_products()本身没有直接支持GROUP BY的参数，因为它基于WordPress的WP_Query，而WP_Query原生不支持分组查询。不过可以通过两种方式实现需求：数据库层面修改SQL实现分组，或者PHP层面手动分组。

方法一：通过钩子修改SQL实现数据库层面分组 #

这种方式直接在查询时修改SQL语句，添加GROUP BY和对应的排序逻辑，适合数据量较大的场景，效率更高。

示例：按指定列分组，每组取最新产品 #

假设要按产品发布作者（post_author）分组，并且每组只保留最新发布的产品：

add_filter( 'woocommerce_product_query_sql', 'custom_product_group_by_sort', 10, 2 );
function custom_product_group_by_sort( $sql, $query ) {
    // 仅针对标记了自定义分组参数的查询生效，避免干扰全局查询
    if ( ! isset( $query->query_vars['custom_group_by'] ) ) {
        return $sql;
    }

    $group_column = $query->query_vars['custom_group_by'];
    
    // 修改SELECT子句，获取每组最新发布日期
    $sql['select'] = "SELECT p.*, MAX(p.post_date) AS latest_date";
    // 添加GROUP BY规则
    $sql['group_by'] = "GROUP BY {$group_column}";
    // 按每组最新日期降序排序
    $sql['order_by'] = "ORDER BY latest_date DESC";

    return $sql;
}

// 调用wc_get_products，指定分组字段
$grouped_products = wc_get_products( array(
    'custom_group_by' => 'p.post_author', // 可替换为任意合法列，如p.ID、pm.meta_value（自定义字段）
    'limit' => -1,
) );

// 用完后移除钩子，防止影响其他查询
remove_filter( 'woocommerce_product_query_sql', 'custom_product_group_by_sort', 10 );

自定义字段分组的调整 #

如果要按自定义字段（比如product_group_tag）分组，需要先加入关联postmeta表的JOIN语句：

global $wpdb;

add_filter( 'woocommerce_product_query_join', 'custom_product_join_meta_table', 10, 2 );
function custom_product_join_meta_table( $join, $query ) {
    if ( isset( $query->query_vars['custom_group_by'] ) && $query->query_vars['custom_group_by'] === 'pm.meta_value' ) {
        $join .= " LEFT JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id AND pm.meta_key = 'product_group_tag'";
    }
    return $join;
}

// 调用时指定分组字段为自定义字段的meta_value
$products = wc_get_products( array(
    'custom_group_by' => 'pm.meta_value',
    'limit' => -1,
) );

方法二：PHP层面手动分组（适合小数据量） #

如果产品数量不多，可以先获取所有按最新排序的产品，再手动按指定列分组，每组只保留第一个（即最新的产品）：

// 先获取所有按发布时间降序排列的产品
$all_products = wc_get_products( array(
    'orderby' => 'date',
    'order' => 'DESC',
    'limit' => -1,
) );

// 指定分组依据：产品类型（'type'）、自定义字段（'product_group_tag'）、分类ID（'category_id'）等
$group_basis = 'product_group_tag';

// 手动分组逻辑
$grouped_products = array();
foreach ( $all_products as $product ) {
    // 根据分组依据获取键值
    $group_key = $group_basis === 'product_group_tag' ? $product->get_meta( 'product_group_tag' ) : $product->get( $group_basis );
    
    // 仅保留每组的第一个产品（即最新的）
    if ( ! isset( $grouped_products[ $group_key ] ) ) {
        $grouped_products[ $group_key ] = $product;
    }
}

// 转换为索引数组（可选）
$grouped_products = array_values( $grouped_products );

注意事项 #

• 数据库层面分组时，要确保分组字段是SQL合法列，若字段来自用户输入，必须做安全过滤避免注入风险。
• 自定义字段分组时，要确保字段已存在于postmeta表中，JOIN语句的meta_key要与实际字段名一致。
• PHP层面分组适合产品数量较少的场景，否则会占用较多内存。

内容的提问来源于stack exchange，提问作者forsberg