WooCommerce教程：构建动态产品分类导航，含同级与一级子分类

<?php
/**
 * WooCommerce动态分类菜单：显示同级分类及其直接子分类
 *
 * 此函数根据当前产品分类，生成一个包含其同级分类和每个同级分类下
 * 第一级子分类的HTML列表。
 */
function wc_cat_menu() {
    // 获取当前查询的对象，通常是当前正在查看的产品分类
    $queried_object = get_queried_object();
    $taxonomy       = 'product_cat'; // 指定分类法为产品分类

    // 检查当前查询对象是否为产品分类，并且存在父级ID
    if ( ! $queried_object instanceof WP_Term || $queried_object->taxonomy !== $taxonomy || ! isset( $queried_object->parent ) ) {
        // 如果不是有效的产品分类或没有父级，则不显示菜单
        return;
    }

    // 获取当前分类的所有同级分类。
    // 'parent' 参数设置为当前分类的父级ID，即可获取其所有兄弟（同级）分类。
    $sibling_terms = get_terms( array(
        'taxonomy'   => $taxonomy,
        'hide_empty' => false, // 显示即使没有产品的分类
        'parent'     => $queried_object->parent // 关键：获取父级下的所有子项（即当前项的同级）
    ) );

    // 如果没有同级分类，则不显示菜单
    if ( empty( $sibling_terms ) ) {
        return;
    }

    echo '<ul class="woocommerce-dynamic-category-list">';

    foreach ( $sibling_terms as $sibling ) {
        // 确保只处理有父级的分类，避免显示顶级分类的兄弟（除非这是你的意图）
        // 如果需要显示顶级分类的兄弟（即所有顶级分类），可以移除此条件或调整逻辑
        if ( $sibling->parent >= 0 ) { // 修正：0表示顶级分类，大于0表示有父级
            $sibling_id = $sibling->term_id;

            // 获取当前同级分类的第一级子分类
            $siblingChildren = get_terms( $taxonomy, array(
                'parent'     => $sibling_id, // 关键：获取当前同级分类的直接子分类
                'hide_empty' => false
            ) );

            // 输出同级分类链接
            echo '<li class="' . ( $sibling_id === $queried_object->term_id ? 'current-cat' : '' ) . '">';
            echo '<a href="' . esc_url( get_term_link( $sibling ) ) . '">' . esc_html( $sibling->name ) . '<span> (' . esc_html( $sibling->count ) . ')</span></a>';

            // 如果存在子分类，则输出子分类列表
            if ( $siblingChildren ) {
                echo '<ul class="children">';
                foreach ( $siblingChildren as $child ) {
                    echo '<li class="' . ( $child->term_id === $queried_object->term_id ? 'current-cat-child' : '' ) . '">';
                    echo '<a href="' . esc_url( get_term_link( $child, $taxonomy ) ) . '">' . esc_html( $child->name ) . '<span> (' . esc_html( $child->count ) . ')</span></a>';
                    echo '</li>';
                }
                echo '</ul>';
            }
            echo '</li>';
        }
    }
    echo '</ul>';
}