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
相关产品推荐
相关产品推荐

