如何在OceanWp+WooCommerce单商品页面标题下方显示副标题

以下是几个可行的排查和解决方向：

1. 验证钩子是否触发并调整优先级 #

先确认ocean_after_single_product_title钩子是否在当前主题环境中生效：

• 在你的函数中添加调试输出，检查函数是否被调用：

function kia_add_subtitle_to_single_product(){
    echo '<p>Hook triggered</p>'; // 调试用，测试后可删除
    if( function_exists( 'the_subtitle' ) ) the_subtitle( '<h4 class="subtitle">', '</h4>' );
}
add_action( 'ocean_after_single_product_title', 'kia_add_subtitle_to_single_product', 10 );

如果看不到Hook triggered的输出，说明该钩子未被主题触发，需要更换钩子。

2. 更换为更可靠的WooCommerce全局钩子 #

如果原钩子无效，改用WooCommerce核心的woocommerce_single_product_summary钩子，它在单商品摘要区域（标题、价格等所在区域）触发，优先级设为15（介于标题（优先级10）和价格（优先级20）之间）：

function kia_add_subtitle_to_single_product(){
    // 先确认函数存在，再获取副标题内容
    if( function_exists( 'get_the_subtitle' ) ){
        $product_subtitle = get_the_subtitle( get_the_ID() );
        // 仅当副标题不为空时输出
        if( !empty( $product_subtitle ) ){
            echo '<h4 class="subtitle">' . esc_html( $product_subtitle ) . '</h4>';
        }
    }
}
add_action( 'woocommerce_single_product_summary', 'kia_add_subtitle_to_single_product', 15 );

这里使用get_the_subtitle()而非直接输出的the_subtitle()，可以更灵活地处理内容，同时添加esc_html()确保输出安全。

3. 检查主题模板是否自定义了标题区域 #

OceanWP允许用户自定义WooCommerce模板，如果你修改过woocommerce/single-product/title.php文件，可能已经移除了ocean_after_single_product_title钩子：

• 找到主题目录下的woocommerce/single-product/title.php，检查是否包含do_action( 'ocean_after_single_product_title' );代码
• 如果没有，你可以直接在该模板文件的标题标签下方添加副标题代码：

// 在标题输出后添加
if( function_exists( 'get_the_subtitle' ) ){
    $subtitle = get_the_subtitle( get_the_ID() );
    if( !empty( $subtitle ) ){
        echo '<h4 class="subtitle">' . esc_html( $subtitle ) . '</h4>';
    }
}

4. 排查主题设置冲突 #

检查OceanWP的主题设置：

• 进入外观 > 自定义 > WooCommerce > 单商品，查看是否有隐藏标题区域相关的选项，确保标题区域的钩子能正常触发
• 暂时禁用其他非必要插件，排除插件冲突导致钩子失效的可能

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