You need to enable JavaScript to run this app. WooCommerce product_page短码 为产品标题添加详情页跳转链接
优惠活动
大模型
产品
解决方案
定价
更多

WooCommerce product_page短码 为产品标题添加详情页跳转链接

WooCommerce product_page短码实现产品标题可跳转详情页的落地方案

核心实现思路

  • 不直接修改WooCommerce核心的短码函数源码,避免后续插件更新覆盖修改内容
  • 依托WooCommerce原生的钩子机制,严格在product_page短码的渲染周期内,临时替换产品标题的渲染逻辑,渲染完成后立刻恢复原生功能,不影响其他页面的产品标题展示
  • 100%兼容原生短码的所有参数(比如show_title控制显隐、SKU/ID传参、变体预选逻辑)

可直接复用的实现代码

将以下代码添加到当前主题的functions.php文件,或者自定义功能插件的代码文件中即可生效:

/**
 * 带详情页跳转链接的短码专用产品标题渲染
 */
function linked_product_page_title() {
    global $product;
    if ( ! $product ) {
        return;
    }

    // 兼容变体产品:自动获取所属父级产品的详情链接
    if ( $product->is_type( 'variation' ) ) {
        $product_link = get_permalink( $product->get_parent_id() );
        $product_name = $product->get_parent_data()['name'];
    } else {
        $product_link = get_permalink( $product->get_id() );
        $product_name = $product->get_name();
    }

    // 输出和原生结构完全一致的标题,仅为文本添加跳转链接,不破坏原有样式
    echo '<h1 class="product_title entry-title">';
    echo '<a href="' . esc_url( $product_link ) . '" rel="bookmark">' . esc_html( $product_name ) . '</a>';
    echo '</h1>';
}

/**
 * 短码渲染前:临时替换标题渲染逻辑
 */
add_action( 'pre_do_shortcode_tag', function( $output, $tag, $attr ) {
    // 仅对product_page短码生效
    if ( 'product_page' !== $tag ) {
        return $output;
    }

    // 兼容原生show_title参数:如果设置了隐藏标题,跳过替换逻辑
    $is_title_hidden = isset( $attr['show_title'] ) && ! $attr['show_title'];
    if ( $is_title_hidden ) {
        return $output;
    }

    // 移除原生标题渲染回调,挂载自定义的带链接标题回调
    remove_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_title', 5 );
    add_action( 'woocommerce_single_product_summary', 'linked_product_page_title', 5 );

    return $output;
}, 10, 3 );

/**
 * 短码渲染完成后:恢复原生标题逻辑,避免全局污染
 */
add_action( 'do_shortcode_tag', function( $output, $tag, $attr ) {
    if ( 'product_page' !== $tag ) {
        return $output;
    }

    // 同样兼容show_title参数的原生逻辑
    $is_title_hidden = isset( $attr['show_title'] ) && ! $attr['show_title'];
    if ( ! $is_title_hidden ) {
        // 恢复原生标题渲染
        add_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_title', 5 );
        // 移除自定义标题回调
        remove_action( 'woocommerce_single_product_summary', 'linked_product_page_title', 5 );
    }

    return $output;
}, 10, 3 );

方案优势

  • 零样式兼容:输出的标题DOM结构、类名和WooCommerce原生完全一致,主题原有针对产品标题的样式不会失效
  • 无全局副作用:自定义的标题渲染逻辑仅在短码运行的时间段内生效,正常产品详情页、商品列表页的标题不会被修改成带链接的状态
  • 兼容全场景:不管短码是通过商品ID还是SKU传参、是简单商品还是变体商品,都能正确跳转到对应的正式详情页
  • 适配后续更新:完全基于WordPress和WooCommerce的公开钩子实现,插件版本更新不会导致修改失效
  • 安全合规:所有输出的链接、文本都做了WordPress标准的转义处理,避免安全风险

验证方式

保留原有短码写法[product_page sku="featured"],在页面前台查看输出的特色商品模块:

  • 产品名称已被超链接包裹,点击可直接跳转到对应商品的正式详情页
  • 短码传入show_title="0"时,仍然会按照要求隐藏产品标题,不出现显示异常

内容的提问来源于stack exchange,提问作者Jan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 23:24:06