如何在WooCommerce中自动将商品相册首图设置为商品主图

你使用的woocommerce_placeholder_img_src钩子仅用于替换前端无主图时加载的占位图片URL，不会修改商品的主图数据，因此后台商品编辑页的图片metabox不会生效。

方案一：保存商品时自动写入主图（推荐） #

该方案会直接将图库第一张图写入商品主图字段，永久存储到数据库，后台、前端所有场景均生效。

add_action('woocommerce_admin_process_product_object', 'auto_set_first_gallery_as_main_image', 10, 1);
function auto_set_first_gallery_as_main_image( $product ) {
    // 仅在未设置主图时执行替换
    if ( ! $product->get_image_id() ) {
        $gallery_ids = $product->get_gallery_image_ids();
        if ( is_array($gallery_ids) && ! empty($gallery_ids) ) {
            // 将图库第一张设置为主图
            $product->set_image_id( $gallery_ids[0] );
        }
    }
}

方案二：动态替换主图（不修改数据库） #

该方案仅在渲染时动态替换主图ID，不会修改数据库存储的商品数据，后台编辑页的主图metabox仍会显示为空，但前端和商品列表预览会正常展示图片。

add_filter('woocommerce_product_get_image_id', 'dynamic_replace_main_image_with_first_gallery', 10, 2);
function dynamic_replace_main_image_with_first_gallery( $image_id, $product ) {
    if ( empty($image_id) ) {
        $gallery_ids = $product->get_gallery_image_ids();
        if ( is_array($gallery_ids) && ! empty($gallery_ids) ) {
            return $gallery_ids[0];
        }
    }
    return $image_id;
}

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