WooCommerce静态页面产品标题换行失效，求助排查

云上老周

2026-8-5

问题原因及解决方案

问题根源

你使用的the_title过滤器仅在WordPress原生标题渲染逻辑中生效，但WooCommerce的产品列表Widget并没有遵循这个逻辑——它通常直接调用产品对象的名称方法，或是在输出时对HTML做了转义，导致你的换行替换规则无法生效。

解决方法

方法1：针对产品Widget单独适配

保留原有代码以支持分类页等场景，同时添加专门针对WooCommerce产品Widget标题的过滤器：

// 保留原有分类页等场景的换行处理
add_filter( 'the_title', 'custom_the_title', 10, 2 );
function custom_the_title( $title, $post_id ) {
    $post_type = get_post_field( 'post_type', $post_id, true ); 
    if( $post_type == 'product' || $post_type == 'product_variation' ) {
        $title = str_replace( '|', '<br/>', $title ); 
    }
    return $title;
}

// 新增产品Widget的标题换行处理
add_filter( 'woocommerce_widget_product_item_title', 'custom_widget_product_title_break', 10, 2 );
function custom_widget_product_title_break( $title, $product ) {
    return str_replace( '|', '<br/>', $title );
}

方法2：全局统一处理（更推荐）

改用WooCommerce产品名称的核心过滤器，覆盖所有产品标题渲染场景（分类页、Widget、详情页等），直接替换原有代码即可：

// 全局替换产品标题中的|为换行
add_filter( 'woocommerce_product_get_name', 'custom_product_title_break', 10, 2 );
function custom_product_title_break( $name, $product ) {
    return str_replace( '|', '<br/>', $name );
}