WooCommerce：移除产品页面图库中的特色产品图片

你之前的代码问题在于：woocommerce_single_product_image_thumbnail_html是针对每一张图库缩略图的HTML输出做修改，把主图的HTML设为空后，部分主题或WooCommerce默认模板会因为这个空值破坏图库的渲染结构，导致整个图库被隐藏。

要从根源上移除图库中的主图，应该直接修改WooCommerce的图库图片ID数组，排除主图ID即可，这样图库只会加载额外添加的产品图片，同时不会影响产品页面顶部的主图展示（如果需要保留的话）。

替换成以下代码：

add_filter( 'woocommerce_product_get_gallery_image_ids', 'exclude_featured_image_from_gallery' );
function exclude_featured_image_from_gallery( $gallery_ids ) {
    global $product;
    
    // 如果当前没有产品对象，直接返回原数组
    if ( ! $product ) return $gallery_ids;
    
    // 获取产品主图ID
    $featured_image_id = $product->get_image_id();
    
    // 在图库数组中找到主图ID并移除
    if ( ( $key = array_search( $featured_image_id, $gallery_ids ) ) !== false ) {
        unset( $gallery_ids[$key] );
    }
    
    // 重新索引数组，避免空键导致的渲染问题
    return array_values( $gallery_ids );
}

代码说明 #

• 使用woocommerce_product_get_gallery_image_ids过滤器直接修改图库的图片ID集合，从根源上排除主图
• 先判断产品对象是否存在，避免报错
• 用array_search找到主图在图库数组中的位置，移除后重新索引数组，保证图库结构正常

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