如何通过CSV批量更新WordPress Alidropship插件商品图库

核心问题定位 #

Alidropship独立商品体系完全不使用WooCommerce默认的图库存储逻辑：

• WooCommerce默认商品图库存在_product_image_gallery自定义字段，存储格式为逗号分隔的媒体附件ID
• Alidropship的商品图库存在自定义字段_product_images中，存储格式为带排序、图片元信息的PHP序列化数组，主图单独存在_thumbnail_id字段中存储附件ID
  直接使用WP All Import默认的WooCommerce图库导入功能，只会写入WooCommerce默认字段，Alidropship无法读取对应数据，就会出现图片已经上传到媒体库但前端不展示的问题。

具体操作步骤 #

• 前置字段确认
  后台打开任意一个前台展示正常的Alidropship商品，编辑页下拉到自定义字段板块，确认两个字段的键名（绝大多数版本Alidropship用的就是前面提到的两个键名，部分定制版本可能有差异，以实际查到的为准），记下来后续配置要用。
• 导入规则配置
  新建WP All Import任务，选择你准备好的CSV文件，导入对象选「更新现有Alidropship商品」，匹配规则选择商品ID对应CSV中的ID列，跳过默认的WooCommerce图片导入配置板块，直接进入自定义字段配置区：
  1. 配置主图：新增自定义字段，键名填你查到的主图字段名（默认是_thumbnail_id），值位置调用WP All Import内置媒体导入函数，写法为[media_import({CSV中主图URL对应的列名})]，该函数会自动拉取对应URL的图片上传到站点媒体库，返回生成的附件ID存入字段。
  2. 配置多图图库：先打开WP All Import的「函数编辑器」，粘贴如下自定义处理函数：

  function format_alidropship_gallery($raw_urls) {
      $url_list = array_filter(array_map('trim', explode(',', $raw_urls)));
      $gallery = [];
      $sort = 0;
      foreach ($url_list as $url) {
          $att_id = media_import($url);
          if (!is_wp_error($att_id)) {
              $gallery[] = [
                  'id' => $att_id,
                  'order' => $sort,
                  'alt' => get_post_meta($att_id, '_wp_attachment_image_alt', true)
              ];
              $sort++;
          }
      }
      return maybe_serialize($gallery);
  }
  

  保存函数后回到自定义字段配置，新增自定义字段，键名填你查到的Alidropship图库字段名（默认是_product_images），值位置填[format_alidropship_gallery({CSV中多图URL对应的列名，列内多图用逗号分隔})]。
• 试跑校验
  先选择3-5个测试商品执行导入，导入完成后两个校验点：
  • 商品编辑页自定义字段中，两个图片字段的值已经正常生成，没有空值或者格式错误
  • 商品前台页面主图、图库轮播、点击放大功能均正常
    校验通过后再执行全量商品导入即可。

注意事项 #

导入配置时不要勾选WP All Import默认的「导入图片到商品图库」选项，避免生成冗余的WooCommerce默认字段数据。如果之前已经导入过错误的图片数据，配置时勾选「覆盖现有自定义字段值」即可直接替换旧数据，不需要手动提前清理。

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