如何移除WooCommerce商品特色图并替换为图库首张图片？

我之前帮客户处理过完全相同的需求，分两种场景给你可行的代码方案，都是纯PHP实现，不需要额外插件：

一、批量处理现有商品 #

这个代码会遍历所有已发布的WooCommerce产品，将它们的特色图片替换为产品图库中的第一张图片（如果图库有图片的话）。

注意：执行前一定要备份数据库，建议先在测试环境验证效果，避免影响线上数据。

function replace_featured_image_with_gallery_first() {
    // 只允许管理员执行这个功能
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }

    // 查询所有已发布的WooCommerce产品
    $args = array(
        'post_type'      => 'product',
        'post_status'    => 'publish',
        'posts_per_page' => -1, // 处理所有产品，大型站点建议改成50分批次处理
        'fields'         => 'ids', // 只获取ID，提升性能
    );

    $products = get_posts( $args );
    $processed_count = 0;

    foreach ( $products as $product_id ) {
        // 获取产品的图库图片ID数组（WooCommerce存储为逗号分隔的字符串）
        $gallery_ids = get_post_meta( $product_id, '_product_image_gallery', true );
        
        if ( empty( $gallery_ids ) ) {
            continue; // 没有图库图片，跳过
        }

        $gallery_ids_array = explode( ',', $gallery_ids );
        $first_gallery_id = trim( $gallery_ids_array[0] );

        if ( empty( $first_gallery_id ) ) {
            continue;
        }

        // 移除原特色图片关联，再设置新的特色图
        delete_post_meta( $product_id, '_thumbnail_id' );
        set_post_thumbnail( $product_id, $first_gallery_id );

        $processed_count++;
    }

    // 输出处理结果（仅后台可见）
    echo "已处理 {$processed_count} 个商品，成功替换特色图片为图库第一张图。";
}

// 触发方式：取消注释后访问一次后台，完成后重新注释避免重复执行
// add_action( 'admin_init', 'replace_featured_image_with_gallery_first' );

使用方法： #

1. 把代码添加到主题functions.php末尾，或创建自定义插件（推荐，避免主题更新丢失代码）。
2. 取消最后一行钩子的注释，访问一次WordPress后台。
3. 看到处理结果后，立即重新注释那行钩子代码。

二、自动处理新发布/更新的商品 #

如果你希望以后发布或修改商品时，自动用图库第一张图替换特色图片，用这个钩子代码：

function auto_replace_featured_image_on_save( $post_id ) {
    // 跳过自动保存和修订版本
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }

    // 确保是产品类型且当前用户有权限编辑
    if ( get_post_type( $post_id ) !== 'product' || ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }

    $gallery_ids = get_post_meta( $post_id, '_product_image_gallery', true );
    
    if ( empty( $gallery_ids ) ) {
        return;
    }

    $gallery_ids_array = explode( ',', $gallery_ids );
    $first_gallery_id = trim( $gallery_ids_array[0] );

    if ( empty( $first_gallery_id ) ) {
        return;
    }

    // 替换特色图片（如果需要保留用户手动设置的特色图，可加判断：!get_post_thumbnail_id($post_id)）
    delete_post_meta( $post_id, '_thumbnail_id' );
    set_post_thumbnail( $post_id, $first_gallery_id );
}
add_action( 'save_post_product', 'auto_replace_featured_image_on_save' );

可选调整： #

如果想保留用户手动设置的特色图，只在无特色图时自动替换，把替换逻辑改成：

if ( ! get_post_thumbnail_id( $post_id ) ) {
    delete_post_meta( $post_id, '_thumbnail_id' );
    set_post_thumbnail( $post_id, $first_gallery_id );
}

额外注意事项 #

• 变量产品的父产品特色图会被处理，若需处理子产品，可将post_type改为product_variation。
• 产品数超过1000时，批量代码建议分批次执行（修改posts_per_page为50，多次触发直到完成），避免PHP超时。

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