如何仅针对部分产品覆盖WooCommerce的single-product区块模板？

方法1：利用WordPress模板优先级规则 #

如果针对特定产品ID，直接将自定义模板重命名为 single-product-{产品ID}.php（比如产品ID为123，就命名为single-product-123.php），WordPress会自动优先加载该模板，无需额外代码。

方法2：通过主题functions.php添加条件判断逻辑 #

如果要针对特定产品分类或批量产品应用模板，在当前主题的functions.php文件中添加以下代码：

function custom_single_product_template($template) {
    global $post;
    
    // 条件1：匹配指定产品分类（替换为你的分类别名）
    if (has_term('your-category-slug', 'product_cat', $post->ID)) {
        $custom_template = locate_template('single-product-custom.php');
        if ($custom_template) {
            return $custom_template;
        }
    }
    
    // 条件2：匹配指定产品ID数组（替换为你的目标产品ID）
    $target_product_ids = array(123, 456, 789);
    if (in_array($post->ID, $target_product_ids)) {
        $custom_template = locate_template('single-product-custom.php');
        if ($custom_template) {
            return $custom_template;
        }
    }
    
    // 未匹配条件时返回默认模板
    return $template;
}
add_filter('template_include', 'custom_single_product_template');

代码说明： #

• 将your-category-slug替换为需要应用模板的产品分类别名（可在分类编辑页面查看）
• $target_product_ids数组中可添加任意需要使用自定义模板的产品ID，多个ID用逗号分隔
• 确保single-product-custom.php文件放在当前主题根目录，或WooCommerce模板子目录（子主题下为your-theme/woocommerce/single-product-custom.php）

方法3：自定义字段实现手动控制 #

如果需要更灵活的单产品控制，可通过自定义字段切换模板：

1. 在产品编辑页面添加自定义字段，字段名设为use_custom_template，值设为yes
2. 修改functions.php中的代码，添加自定义字段判断：

function custom_single_product_template($template) {
    global $post;
    
    $use_custom = get_post_meta($post->ID, 'use_custom_template', true);
    if ($use_custom === 'yes') {
        $custom_template = locate_template('single-product-custom.php');
        if ($custom_template) {
            return $custom_template;
        }
    }
    
    return $template;
}
add_filter('template_include', 'custom_single_product_template');

注意：WooCommerce模板通常使用.php后缀，建议将single-product-custom.html改为single-product-custom.php，避免出现兼容性问题。

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