如何在 WooCommerce 商品标题下方仅显示父级分类名称-php教程-PHP中文网

如何在 WooCommerce 商品标题下方仅显示父级分类名称

本文介绍如何修改 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 可安全处理空数组。

⚠️ 注意事项：