WooCommerce 商品显示父级分类名称方法

本文详解了如何通过一段安全可靠的 PHP 代码优化 WooCommerce 商品列表页的分类显示逻辑——不再默认展示最深层的子分类（如“连衣裙”），而是精准提取并仅显示商品所属的顶级父级分类（如“女装”），从而提升页面导航清晰度与用户体验；代码采用严格判断（$cat->parent === 0）、输出转义、类型强制转换和提前终止等最佳实践，兼顾功能性、安全性与可维护性，特别适合希望优化电商站点信息架构的 WordPress 开发者和店主快速落地实施。

本文介绍如何修改 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 逻辑，即可让商品列表页的分类展示更清晰、更符合电商导航逻辑。

好了，本文到此结束，带大家了解了《WooCommerce 商品显示父级分类名称方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！