在 woocommerce 商品列表页中，通过钩子动态显示商品所属的顶级分类（即无父级的分类），避免显示子分类，适用于多层级分类结构的电商站点。
在 woocommerce 商品列表页中，通过钩子动态显示商品所属的顶级分类（即无父级的分类），避免显示子分类，适用于多层级分类结构的电商站点。
默认情况下，wp_get_post_terms() 返回的商品分类数组按数据库顺序排列，且通常包含所有关联分类（包括子类），而 array_shift() 仅取首个元素——这往往是最深层的子分类，不符合“仅显示父类”的需求。
要精准获取唯一且顶层的父分类，关键在于识别 WP_Term 对象的 parent 属性：顶级分类的 parent 值恒为 0（整型）。因此，我们遍历所有分类，找到第一个 parent === 0 的项即可终止循环，确保高效且准确。
以下是优化后的完整代码，已适配 WooCommerce 7.x+ 及 PHP 7.4+ 环境：
function wpa89819_wc_single_product() {
$product_id = get_the_ID();
$product_cats = wp_get_post_terms( $product_id, 'product_cat', array( 'fields' => 'all' ) );
if ( is_wp_error( $product_cats ) || empty( $product_cats ) ) {
return;
}
foreach ( $product_cats as $cat ) {
// 仅匹配顶级分类（无父级）
if ( 0 === (int) $cat->parent ) {
echo '<h6 class="woocommerce-loop-product__title">' . esc_html( $cat->name ) . '</h6>';
break; // 找到即退出，避免重复输出
}
}
}
add_action( 'woocommerce_after_shop_loop_item_title', 'wpa89819_wc_single_product', 2 );
✅ 关键改进说明：
- 使用 esc_html() 对分类名进行输出转义，防止 XSS 风险；
- 添加 'fields' => 'all' 参数确保获取完整 WP_Term 对象（含 parent 属性）；
- 显式判断 empty($product_cats) 提升健壮性；
- 强制 (int) $cat->parent 类型转换，避免松散比较潜在问题；
- break 确保每个商品仅显示一个父分类，符合业务预期。
⚠️ 注意事项：
- 若某商品仅分配了子分类（未直接分配父类），该代码将不输出任何内容——这是正确行为。如需兜底显示最近父类，需额外递归查找，但会增加复杂度；
- 请将代码添加至当前子主题的 functions.php 文件中，切勿修改父主题或 WooCommerce 核心文件；
- 启用 WP_DEBUG 模式可辅助排查 is_wp_error() 触发场景（如分类法未注册异常）。
此方案简洁、安全、可维护，是 WooCommerce 主题开发中处理多级分类展示的标准实践。
