如何在 WooCommerce 手动发布新产品后自动创建关联商品

如何在 WooCommerce 手动发布新产品后自动创建关联商品

本文介绍如何在管理员手动保存或发布 WooCommerce 商品时，精准触发自定义逻辑（如创建衍生商品），避免递归调用，并提供稳定、可复用的钩子方案与完整示例代码。

在 WooCommerce 开发中，我们常常会遇到这样的需求：当管理员在后台手动创建并发布一个新产品后，系统需要自动执行一些后续操作。比如，为这个主商品生成一个配套的订阅商品、同步库存到外部系统、写入操作日志，或者调用某个特定的 API 接口。

要实现这个功能，关键在于选择一个合适的钩子（Hook）。这个钩子必须满足几个条件：语义明确、触发时机可靠，并且能天然地规避递归调用的风险。很多开发者首先会想到 transition_post_status，这个钩子虽然通用，但用在 WooCommerce 商品发布场景下，其实存在两大硬伤。

首先，它的触发场景太广了。不仅管理员点击“发布”按钮时会触发，后台的批量操作、通过代码程序化更新商品状态，甚至通过 REST API 修改状态时，它都会被调用。这会导致你的逻辑在不该运行的时候意外执行。其次，对于新创建的商品，其初始状态可能是 auto-draft，然后才变为 publish。而钩子中的 old_status 参数并不总是空字符串或可预测的值，这会让你的条件判断变得复杂且不可靠。更棘手的是，如果你在代码中创建了新商品后，又调用了 $product->sa ve()，这很可能会再次触发 woocommerce_process_product_meta 等钩子。如果防护措施不到位，无限递归的噩梦就开始了。

✅ 推荐方案：使用 woocommerce_process_product_meta

那么，有没有更稳妥的方案？答案是肯定的。woocommerce_process_product_meta 这个钩子就是一个绝佳的选择。它的最大优点在于“场景纯粹”：它只在 WooCommerce 商品编辑页面，当管理员点击「更新」或「发布」按钮提交表单时才会被触发。这意味着，它天然地限定在了人工操作的场景内，对于 wp_insert_post() 这类程序化的创建或更新行为，它完全不会响应。从根源上，就杜绝了递归问题的发生。这个钩子自 WooCommerce 3.0 以来一直稳定支持，实测在最新的 6.2+ 版本中也能完美兼容。

下面，我们来看一个可以直接用于生产环境的代码示例。它的功能是：每当管理员手动发布一个普通商品时，就自动为其创建一个价格为 ¥1、订阅周期为 12 个月的配套订阅商品。

/**
 * 在手动保存/发布商品后，创建关联的订阅商品
 * 此钩子仅响应 admin 页面的表单提交，安全无递归
 */
function create_companion_subscription_on_publish($post_id, $post) {
    // 防御：跳过自动保存、AJAX 请求及非主循环调用
    if (defined('DOING_AUTOSA VE') && DOING_AUTOSA VE) return;
    if (!isset($_POST['post_ID']) || intval($_POST['post_ID']) !== $post_id) return;
    if (!current_user_can('edit_post', $post_id)) return;

    // 确保是新建并首次发布（非更新已有已发布商品）
    $post_status = get_post_status($post_id);
    if ($post_status !== 'publish' || get_post_field('post_status', $post_id) !== 'publish') {
        return; // 非发布状态或非最终发布态，跳过
    }

    // 创建订阅商品实例（需确保 WC_Subscription 插件已激活）
    $subscription_data = array(
        'post_title'    => 'Subscription for ' . esc_html($post->post_title),
        'post_name'     => sanitize_title('subscription-for-' . $post->post_title),
        'post_status'   => 'publish',
        'post_type'     => 'product',
        'post_author'   => $post->post_author,
    );
    $sub_product_id = wp_insert_post($subscription_data);
    if (!$sub_product_id || is_wp_error($sub_product_id)) {
        error_log('Failed to create subscription product for post ID: ' . $post_id);
        return;
    }

    // 初始化并配置订阅商品（以 WC_Product_Subscription 为例）
    $subscription = new WC_Product_Subscription($sub_product_id);
    $subscription->set_name('Monthly Plan for ' . $post->post_title);
    $subscription->set_status('publish');
    $subscription->set_price(1.00);
    $subscription->set_regular_price(1.00);
    $subscription->set_subscription_length(12);
    $subscription->set_subscription_period('month');
    $subscription->set_catalog_visibility('visible');
    $subscription->sa ve();

    // 可选：建立父子关系（如需后续查询）
    update_post_meta($sub_product_id, '_parent_product_id', $post_id);
    update_post_meta($post_id, '_has_companion_subscription', $sub_product_id);

    // 记录日志（建议使用 WP 日志系统，而非 file_put_contents）
    error_log(sprintf('[WooCommerce Hook] Created subscription %d for product %d', $sub_product_id, $post_id));
}
add_action('woocommerce_process_product_meta', 'create_companion_subscription_on_publish', 10, 2);

? 重要注意事项

• ✅ 依赖检查：示例中使用了 WC_Product_Subscription 类，这意味着你必须确保 WooCommerce Subscriptions 插件已经启用并激活。更稳妥的做法是，在实例化之前加入 class_exists('WC_Product_Subscription') 判断。
• ✅ 权限与安全性：代码中已经包含了 current_user_can() 和 DOING_AUTOSA VE 校验，这能有效防止越权操作和因自动保存导致的重复执行。这是生产代码的基本素养。
• ⚠️ 避免硬编码路径日志：像 file_put_contents('./log_*.log') 这种写法，很容易因为服务器文件路径权限或 Web 服务器用户配置问题而失败。行业内的最佳实践是统一使用 WordPress 提供的 error_log() 函数，或者 WooCommerce 自带的 wc_get_logger() 方法。
• ? 递归防护：woocommerce_process_product_meta 钩子本身不会因为 wp_insert_post() 而触发，这已经解决了一大半问题。但是，如果你在项目的其他地方还监听了 sa ve_post_product 这类更底层的钩子，那就必须格外小心。一个常见的技巧是，在执行核心逻辑前，临时用 remove_action('sa ve_post_product', ...) 移除自己的函数，执行完后再恢复。或者，使用 doing_action('woocommerce_process_product_meta') 来判断当前执行上下文。
• ? 调试建议：在开发阶段，强烈建议在 wp-config.php 中启用 WP_DEBUG_LOG。同时，可以在函数开头简单加一行 error_log("Hook fired for post {$post_id}");，这样就能在日志里快速确认钩子是否被正确触发，是定位问题的第一步。

采用这套方案，你不仅能精准地响应管理员的人工发布行为，更能在此基础上构建出健壮、清晰且易于维护的 WooCommerce 功能扩展。说到底，选择对的钩子，就等于成功了一半。