如何基于商品标签切换WooCommerce单商品模板并调整动作？

嘿，我来帮你搞定这个基于商品标签切换模板的逻辑～ 下面是完整的实现思路和代码，完全贴合你的需求：

核心逻辑就是：在单个商品页面加载前，检测商品是否带有panorama或multi-panel标签，有则执行remove_action和add_action替换模板，没有就保持默认。

完整代码示例（以WooCommerce商品为例） #

/**
 * 根据商品标签切换模板相关操作
 */
function switch_product_template_by_tag() {
    // 只在单个商品页面执行，非商品页面直接返回
    if ( ! is_product() ) {
        return;
    }

    // 获取当前商品对象，做容错处理
    global $product;
    if ( ! $product ) {
        return;
    }

    // 定义我们要检测的目标标签slug
    $target_tags = array( 'panorama', 'multi-panel' );
    $has_target_tag = false;

    // 获取当前商品的所有标签（WooCommerce默认商品标签分类是product_tag）
    $product_tags = get_the_terms( $product->get_id(), 'product_tag' );
    
    // 遍历标签，检查是否包含目标标签
    if ( $product_tags && ! is_wp_error( $product_tags ) ) {
        foreach ( $product_tags as $tag ) {
            if ( in_array( $tag->slug, $target_tags ) ) {
                $has_target_tag = true;
                break; // 找到目标标签就停止遍历，提升效率
            }
        }
    }

    // 如果匹配到目标标签，执行模板替换操作
    if ( $has_target_tag ) {
        // 👇 替换成你实际要移除的钩子和回调
        remove_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_title', 5 );
        // 👇 替换成你的全景/多联商品专属模板回调
        add_action( 'woocommerce_single_product_summary', 'custom_panorama_product_title', 5 );
        
        // 可以在这里添加更多remove/add操作，比如替换价格、描述区域的模板
    }
    // 没有目标标签的普通商品，啥也不做，保持默认模板
}
// 把函数挂载到模板重定向钩子，确保在模板加载前完成判断
add_action( 'template_redirect', 'switch_product_template_by_tag' );

关键细节要注意： #

• 钩子选择：用template_redirect能保证在模板渲染前完成判断，如果你只针对WooCommerce商品页面，也可以换成woocommerce_before_single_product钩子。
• 标签分类适配：如果你的商品标签不是WooCommerce默认的product_tag，而是自定义分类，把get_the_terms里的第二个参数换成你的自定义分类slug就行。
• Action参数匹配：remove_action的三个参数（钩子名、回调函数、优先级）必须和原来的add_action完全一致，不然没法移除成功。比如原来的标题钩子优先级是5，替换时也要用相同优先级才能保证位置正确。
• 容错处理：加了空值和错误判断，避免因为商品标签获取失败导致代码报错。

如果是普通WordPress自定义文章类型，只需要把is_product()换成is_singular( '你的自定义文章类型slug' )就可以啦～

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