WooCommerce产品分类树形导航异常问题：子分类页面无法展示主分类及同级分类

我明白你遇到的痛点了——当用户进入最底层的子分类页面时，原来的自定义导航只会显示当前分类的子分类（如果有的话），导致用户没法快速返回上级分类或者切换同层级的其他分类。核心问题在于你的代码只基于当前分类的直接父级来获取子分类，而我们需要先定位到当前分类所属的顶级父分类，再从顶级分类开始输出完整的树形结构。

下面是修正后的完整解决方案，包含递归获取顶级父分类和树形输出的逻辑：

步骤1：添加辅助函数获取顶级父分类 #

首先我们需要一个工具函数，用来找到任意分类的最顶层父分类：

/**
 * 获取分类的顶级父分类ID
 * @param int $term_id 当前分类ID
 * @param string $taxonomy 分类法，这里是product_cat
 * @return int 顶级父分类ID
 */
function get_top_level_parent($term_id, $taxonomy = 'product_cat') {
    $parent = get_term($term_id, $taxonomy)->parent;
    // 如果当前分类没有父级，说明自己就是顶级分类
    if ($parent == 0) {
        return $term_id;
    }
    // 递归向上找，直到找到顶级父分类
    return get_top_level_parent($parent, $taxonomy);
}

步骤2：修改原函数，基于顶级父分类输出完整树形 #

接下来修改你的原函数，先获取顶级父分类，再递归输出整个分类树，同时标记当前活跃的分类：

/**
 * 显示当前分类所在顶级父分类的完整树形结构
 */
function wiw_subcats_from_parentcat() {
    if (!is_product_category()) {
        return; // 只在产品分类页面执行
    }

    global $wp_query;
    $current_cat = $wp_query->get_queried_object();
    $top_parent_id = get_top_level_parent($current_cat->term_id);
    $top_parent_term = get_term($top_parent_id, 'product_cat');

    echo '<ul class="wiw_cat-parentlist">';
    // 输出顶级父分类
    $active_class = ($current_cat->term_id == $top_parent_id) ? ' class="active"' : '';
    echo '<li'.$active_class.'><a href="'.get_term_link($top_parent_term).'">'.$top_parent_term->name.'</a>';
    
    // 递归输出所有子分类
    display_category_tree($top_parent_id, $current_cat->term_id);
    
    echo '</li></ul>';
}

/**
 * 递归输出分类树形结构
 * @param int $parent_id 父分类ID
 * @param int $current_cat_id 当前访问的分类ID
 */
function display_category_tree($parent_id, $current_cat_id) {
    $args = array(
        'hierarchical' => true,
        'hide_empty' => 0, // 可以根据需求改为1，只显示有产品的分类
        'parent' => $parent_id,
        'taxonomy' => 'product_cat'
    );
    $subcats = get_categories($args);

    if (!empty($subcats)) {
        echo '<ul class="wiw_catlist">';
        foreach ($subcats as $subcat) {
            $active_class = ($subcat->term_id == $current_cat_id) ? ' class="active"' : '';
            echo '<li'.$active_class.'><a href="'.get_term_link($subcat).'">'.$subcat->name.'</a>';
            // 递归输出当前子分类的子分类
            display_category_tree($subcat->term_id, $current_cat_id);
            echo '</li>';
        }
        echo '</ul>';
    }
}

关键改进点说明 #

• 顶级父分类定位：通过get_top_level_parent()函数，无论用户在哪个层级的子分类，都能找到它所属的最顶层主分类，确保始终显示完整的分类树。
• 递归树形输出：display_category_tree()函数递归遍历所有子分类层级，完美还原你需要的树形结构。
• 活跃状态标记：添加了active类，你可以通过CSS为当前访问的分类添加样式，让用户清楚自己所在的位置。
• 兼容性优化：增加了!is_product_category()的判断，确保函数只在产品分类页面执行。

使用方法 #

1. 将上述代码添加到你的主题functions.php文件中（或者自定义插件里）。
2. 在你的产品分类模板（比如taxonomy-product_cat.php）中合适的位置调用函数：

wiw_subcats_from_parentcat();

3. 可以通过CSS调整wiw_cat-parentlist和wiw_catlist的样式，让树形结构更美观，比如添加缩进、折叠效果等。

这样修改后，无论用户进入哪个层级的分类页面，都会显示该分类所属的顶级主分类的完整树形结构，用户可以随时返回上级分类或切换同层级的其他分类，完全符合你想要的导航行为。

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