本文介绍如何修改 woocommerce 主题代码，使商品列表页中每个商品标题下方只显示其所属的顶级（父级）商品分类，而非默认的最深层子分类。
本文介绍如何修改 woocommerce 主题代码，使商品列表页中每个商品标题下方只显示其所属的顶级（父级）商品分类，而非默认的最深层子分类。
在 WooCommerce 中，商品可能隶属于多层嵌套的分类结构（例如：服装 → 女装 → 连衣裙）。默认情况下，wp_get_post_terms() 返回的分类数组按数据库顺序排列，且 array_shift() 会取第一个（通常是层级最深的子分类），这往往不符合展示需求——我们通常希望统一显示更宽泛、更具导航意义的父级分类（如“女装”而非“连衣裙”）。
要精准获取唯一父级分类（即顶级分类，无上级分类），关键在于判断 $cat->parent === 0。WooCommerce 的产品分类（product_cat）沿用 WordPress 分类体系：顶级分类的 parent 字段值恒为 0，而子分类则指向其直接父分类的 ID。
以下是优化后的完整实现代码，推荐添加至当前子主题的 functions.php 文件中：
function wpa89819_wc_single_product() {
$product_id = get_the_ID();
$product_cats = wp_get_post_terms($product_id, 'product_cat');
// 安全检查：确保未返回 WP_Error
if (is_wp_error($product_cats)) {
return;
}
// 遍历所有关联分类，找到第一个顶级分类（parent == 0）
foreach ($product_cats as $cat) {
if ((int) $cat->parent === 0) {
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);✅ 关键改进说明：
- 使用 foreach 替代 array_shift()，主动筛选 parent === 0 的分类；
- 添加 esc_html() 对输出内容进行转义，防止 XSS 漏洞，提升安全性；
- 显式类型转换 (int) $cat->parent 确保严格比较；
- break 保证即使商品属于多个顶级分类（极少见），也仅显示第一个，避免重复渲染；
- 移除冗余的空数组判断（$product_cats && !is_wp_error），因 wp_get_post_terms 在无结果时返回空数组，而非 false，而 foreach 可安全处理空数组。
⚠️ 注意事项：
- 若某商品仅归属子分类（未直接分配给任何顶级分类），此代码将不输出任何分类名——这是预期行为，建议在后台为商品同时勾选父级与子级分类以确保一致性；
- 如需支持多父级分类显示（如“女装, 配饰”），可移除 break 并累积输出，但需自行处理分隔符与样式；
- 修改前请务必备份 functions.php，并在子主题中操作，避免更新主题时丢失代码。
通过这一小段精炼可靠的 PHP 逻辑，即可让商品列表页的分类展示更清晰、更符合电商导航逻辑。
