WooCommerce自定义排序：带图商品优先显示的实现问题

问题分析 #

直接设置meta_key = '_thumbnail_id'会自动过滤掉无缩略图的商品，而仅依赖_thumbnail_id的排序规则，会导致共用同一张图的商品因meta值相同被合并显示（本质是查询分组逻辑导致重复结果被去重）。

解决方案代码 #

将以下代码添加到子主题的functions.php文件中：

1. 添加自定义排序选项

// 给分类页排序下拉添加「带缩略图商品优先」选项
add_filter( 'woocommerce_catalog_orderby', 'add_thumbnail_priority_sort' );
function add_thumbnail_priority_sort( $options ) {
    $options['thumbnail_priority'] = '带缩略图商品优先';
    return $options;
}

2. 修改查询逻辑实现排序

// 调整分类页查询，实现带图优先且保留无图商品
add_action( 'pre_get_posts', 'thumbnail_priority_sort_query' );
function thumbnail_priority_sort_query( $query ) {
    // 仅处理前台商品分类页的主查询
    if ( is_admin() || ! $query->is_main_query() || ! is_product_category() ) {
        return;
    }

    $orderby = $query->get( 'orderby' );
    if ( 'thumbnail_priority' !== $orderby ) {
        return;
    }

    // 构建meta查询，同时包含有图和无图商品
    $meta_query = $query->get( 'meta_query', [] );
    $meta_query[] = [
        'relation' => 'OR',
        [
            'key'     => '_thumbnail_id',
            'compare' => 'EXISTS'
        ],
        [
            'key'     => '_thumbnail_id',
            'compare' => 'NOT EXISTS'
        ]
    ];

    $query->set( 'meta_query', $meta_query );

    // 设置排序规则：先按是否有缩略图（有图在前），再按商品ID确保所有商品显示
    $query->set( 'orderby', [
        'meta_value' => 'DESC', // 存在_thumbnail_id的商品排在前面
        'ID'         => 'ASC'   // 按ID排序避免同图商品被合并
    ] );
}

代码说明 #

• 用meta_query的OR条件同时匹配有/无_thumbnail_id的商品，避免过滤无图商品。
• 排序时先以meta_value的存在性排序（有值的商品会被优先展示），再叠加商品ID排序，彻底解决同图商品只显示一个的问题。
• 仅对前台商品分类页的主查询生效，不影响后台或其他页面的查询逻辑。

注意事项 #

1. 确保代码添加到子主题的functions.php，不要修改主题核心文件，防止主题更新丢失代码。
2. 清空WooCommerce和WordPress的缓存后测试效果。
3. 如果之前添加过相关排序代码，请先删除冲突部分（比如单独设置meta_key = '_thumbnail_id'的代码）。

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