WooCommerce产品短码动态参数值：替换单个钥匙扣加购按钮

嘿，这个需求我之前帮客户处理过类似的，给你几个实用的方案，都是基于WordPress/WooCommerce的常规操作，不用折腾复杂的插件：

方案1：代码钩子批量替换（适合技术基础较好，需要批量处理的场景） #

这个方案通过自定义字段关联单个钥匙扣和对应套装，然后用WooCommerce钩子自动替换按钮。步骤如下：

1. 添加自定义字段关联套装ID
   先给所有单个钥匙扣产品加一个自定义字段，用来填写对应的3个装套装产品ID。把下面的代码放到你的子主题functions.php文件里，或者自定义插件中：

// 添加产品自定义字段：对应套装产品ID
add_action('woocommerce_product_options_general_product_data', 'add_keychain_set_association_field');
function add_keychain_set_association_field() {
    woocommerce_wp_text_input(array(
        'id' => '_linked_keychain_set_id',
        'label' => __('对应3个装套装ID', 'your-text-domain'),
        'description' => __('输入该钥匙扣对应的套装产品ID（可在套装产品编辑页URL中找到）', 'your-text-domain'),
        'type' => 'number',
        'custom_attributes' => array(
            'step' => '1',
            'min' => '1'
        )
    ));
}

// 保存自定义字段值
add_action('woocommerce_process_product_meta', 'save_keychain_set_association_field');
function save_keychain_set_association_field($post_id) {
    $set_id = isset($_POST['_linked_keychain_set_id']) ? absint($_POST['_linked_keychain_set_id']) : '';
    update_post_meta($post_id, '_linked_keychain_set_id', $set_id);
}

2. 替换加入购物车按钮
   继续添加代码，判断当前产品是否是钥匙扣（通过分类或标签），如果是，就替换原按钮为套装的加入购物车按钮：

// 替换单个钥匙扣产品的加入购物车按钮
add_action('woocommerce_single_product_summary', 'replace_single_keychain_cart_button', 1);
function replace_single_keychain_cart_button() {
    global $product;
    
    // 替换条件：产品属于「钥匙扣」分类（替换成你实际的分类slug）
    $keychain_cat_slug = 'keychains';
    if (has_term($keychain_cat_slug, 'product_cat', $product->get_id())) {
        $linked_set_id = get_post_meta($product->get_id(), '_linked_keychain_set_id', true);
        
        // 验证套装ID有效
        if ($linked_set_id && get_post_type($linked_set_id) === 'product') {
            // 移除原加入购物车按钮
            remove_action('woocommerce_single_product_summary', 'woocommerce_template_single_add_to_cart', 30);
            
            // 添加套装的加入购物车按钮（使用WooCommerce内置短码）
            add_action('woocommerce_single_product_summary', function() use ($linked_set_id) {
                echo '<div class="woocommerce-add-to-cart">';
                echo do_shortcode('[add_to_cart id="'.$linked_set_id.'"]');
                echo '</div>';
            }, 30);
        }
    }
}

完成后，去每个单个钥匙扣产品的编辑页，在「常规」选项卡下找到新添加的字段，填入对应的套装产品ID即可。

方案2：页面构建器自定义产品模板（适合不会写代码的用户） #

如果你用Elementor、Beaver Builder这类可视化页面构建器，可以直接自定义钥匙扣产品的模板：

• 打开页面构建器的产品模板编辑界面
• 找到原有的「加入购物车按钮」模块，删除它
• 添加WooCommerce的「加入购物车」模块，选择对应的套装产品；或者添加「自定义HTML」模块，插入套装的加入购物车短码：[add_to_cart id="你的套装产品ID"]
• 保存模板，所有钥匙扣产品都会自动使用这个新模板，显示套装的加入购物车按钮

方案3：手动插入短码（适合少量产品的场景） #

如果你的单个钥匙扣产品数量不多，可以直接在产品描述或自定义内容区域插入套装的加入购物车短码：

1. 找到套装产品的ID（可以在套装产品编辑页的URL中获取，比如post=123里的123就是ID）
2. 在单个钥匙扣产品的编辑页，在产品描述里插入短码：[add_to_cart id="123"]（替换成实际的套装ID）
3. 如果你想隐藏原有的加入购物车按钮，可以用CSS：

.single-product .woocommerce-add-to-cart {
    display: none;
}

把这段CSS加到主题的自定义CSS区域即可。

注意事项 #

• 测试前记得清除WordPress缓存和浏览器缓存，避免显示异常
• 如果使用子主题，代码尽量放在子主题的functions.php里，防止主题更新丢失代码
• 确保套装产品处于「发布」状态，并且库存充足

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