WooCommerce动态产品分类导航：显示同级与直接子分类列表-php教程-PHP中文网

WooCommerce动态产品分类导航：显示同级与直接子分类列表

DDD

发布： 2025-11-17 13:57:01

原创

533人浏览过

WooCommerce动态产品分类导航：显示同级与直接子分类列表

本教程旨在指导开发者如何在woocommerce中实现一个动态的产品分类导航功能。通过一个自定义的php函数，我们将展示如何根据当前访问的产品分类，自动生成其所有同级分类以及这些同级分类下的第一级子分类列表。这对于构建灵活且层次分明的商品导航菜单至关重要，能够显著提升用户体验和网站的可浏览性。

在构建复杂的电子商务网站时，一个直观且动态的分类导航系统是提升用户体验的关键。特别是在WooCommerce中，当产品分类层级较深时，用户可能需要快速浏览当前分类的兄弟分类（同级）以及其直接子分类，以便更好地探索产品。本教程将提供一个高效的解决方案，通过编写自定义PHP函数，实现这一动态导航功能。

核心需求分析

我们的目标是创建一个导航列表，该列表需满足以下条件：

动态性： 列表内容应根据用户当前所在的产品分类页面自动更新。
同级分类显示： 显示当前分类的所有同级分类。
直接子分类显示： 对于每个同级分类，仅显示其第一级的子分类，不涉及更深层级的子分类。
层级支持： 能够应对多达四层的分类深度。

实现原理

实现此功能的关键在于利用WordPress和WooCommerce提供的分类（Term）相关函数。我们将通过以下步骤来构建解决方案：

获取当前查询的产品分类对象。
根据当前分类的父级ID，查询所有同级分类。
遍历每个同级分类，并进一步查询其直接子分类。
将这些分类以嵌套的HTML无序列表（<ul>）形式输出。

代码实现

以下是实现上述功能的PHP代码：

<?php
/**
 * WooCommerce动态产品分类菜单
 * 显示当前分类的同级分类及其直接子分类
 */
function wc_cat_menu() {
    // 获取当前查询的对象，通常是当前分类页面的分类对象
    $queried_object = get_queried_object();
    // 定义分类法，WooCommerce产品分类为 'product_cat'
    $taxonomy       = 'product_cat';

    // 检查是否在产品分类页面，并且 queried_object 是一个有效的分类对象
    if ( ! $queried_object instanceof WP_Term || $queried_object->taxonomy !== $taxonomy ) {
        return; // 如果不是产品分类页面，则不执行
    }

    // 获取当前分类的父级ID，用于查询同级分类
    // 如果当前分类是顶级分类，其 parent 为 0
    $parent_id = $queried_object->parent;

    // 查询所有同级分类
    // 'parent' 参数用于指定父级ID，获取其直接子分类
    // 'hide_empty' => false 确保即使没有产品的分类也会显示
    $sibling_terms = get_terms( array(
        'taxonomy'   => $taxonomy,
        'hide_empty' => false,
        'parent'     => $parent_id,
        'orderby'    => 'name', // 可以根据需要调整排序
        'order'      => 'ASC',
    ) );

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

    echo '<ul class="wc-dynamic-category-menu">'; // 主菜单的 ul 标签

    foreach ( $sibling_terms as $sibling ) {
        // 确保只处理有效的同级分类
        // 这里的 $sibling->parent > 0 条件在获取同级分类时已经由 'parent' 参数处理，
        // 但如果需要额外的逻辑判断，可以保留或根据实际情况调整。
        // 对于顶级分类，其 parent_id 为 0，get_terms 会返回所有顶级分类。
        // 如果我们希望在顶级分类页面显示所有顶级分类及其子分类，那么这个条件就不是必需的。
        // 这里我们假设我们总是希望显示当前分类的兄弟（包括它自己）

        $sibling_id = $sibling->term_id;

        // 查询当前同级分类的直接子分类
        $siblingChildren = get_terms( $taxonomy, array( 
            'parent'     => $sibling_id,
            'hide_empty' => false,
            'orderby'    => 'name',
            'order'      => 'ASC',
        ) );

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

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

        echo '</li>'; // 同级分类的 li 标签结束
    }

    echo '</ul>'; // 主菜单的 ul 标签结束
}

登录后复制

代码解析

get_queried_object(): 这是WordPress的核心函数，用于获取当前页面所查询的对象。在产品分类页面，它将返回一个WP_Term对象，其中包含当前分类的所有信息，如term_id、name、slug和parent等。
$taxonomy = 'product_cat': 定义了我们操作的分类法。WooCommerce的产品分类使用product_cat。
get_terms(): 这是WordPress用于获取分类（term）的主要函数。
- 查询同级分类: 我们使用'parent' => $queried_object->parent来获取与当前分类具有相同父级的所有分类。如果当前分类是顶级分类（parent为0），则get_terms会返回所有顶级分类。
- 查询子分类: 在遍历同级分类时，我们再次调用get_terms()，这次使用'parent' => $sibling_id来获取当前同级分类的直接子分类。
- 'hide_empty' => false: 这个参数确保即使某个分类下目前没有产品，它也会被显示出来。这对于展示完整的分类结构很有用。
循环和条件判断:
- 外部foreach循环遍历所有同级分类。
- 内部if ( ! empty( $siblingChildren ) )判断当前同级分类是否有子分类。
- 内部foreach循环遍历并输出子分类。
get_term_link(): WordPress函数，用于生成分类的URL。esc_url()和esc_html()用于安全输出，防止XSS攻击。
<span> (' . $sibling->count . ')</span>: 显示该分类下产品的数量。

如何使用

要将此功能集成到您的WooCommerce商店中，请按照以下步骤操作：

将代码添加到主题的 functions.php 文件中：将上述完整的PHP代码复制并粘贴到您的WordPress主题（或子主题）的functions.php文件中。
在模板文件中调用函数：您可以在任何WooCommerce模板文件（例如archive-product.php、taxonomy-product_cat.php或侧边栏模板文件）中，您希望显示此菜单的位置，通过以下方式调用该函数：
```
<?php wc_cat_menu(); ?>
```
登录后复制
例如，您可能希望将其放置在产品归档页面的侧边栏或主内容区域的上方。

飞书多维表格
表格形态的AI工作流搭建工具，支持批量化的AI创作与分析任务，接入DeepSeek R1满血版

26

查看详情
通过短代码或小工具调用（可选）：如果您希望通过短代码或小工具来管理此菜单的显示，可以进一步封装：

短代码示例：
```
function wc_cat_menu_shortcode() {
    ob_start(); // 开启输出缓冲
    wc_cat_menu(); // 调用函数
    return ob_get_clean(); // 返回缓冲内容
}
add_shortcode( 'wc_category_nav', 'wc_cat_menu_shortcode' );
```
登录后复制
然后您可以在文章、页面或文本小工具中使用 [wc_category_nav] 短代码。

小工具示例： 这需要创建一个自定义的WordPress小工具类，并在其widget()方法中调用wc_cat_menu()。

注意事项与优化

样式定制（CSS）：生成的菜单是一个标准的HTML无序列表。您可以使用CSS对其进行美化，例如：

.wc-dynamic-category-menu {
    list-style: none;
    padding-left: 0;
}
.wc-dynamic-category-menu li {
    margin-bottom: 5px;
}
.wc-dynamic-category-menu li a {
    text-decoration: none;
    color: #333;
    font-weight: bold;
}
.wc-dynamic-category-menu .children {
    list-style: none;
    padding-left: 20px; /* 子分类缩进 */
    margin-top: 5px;
}
.wc-dynamic-category-menu .children li a {
    font-weight: normal;
    color: #666;
}
.wc-dynamic-category-menu .current-category > a {
    color: #0073aa; /* 当前分类高亮 */
    font-weight: bold;
}

登录后复制

性能考虑：对于拥有成千上万个分类和产品的超大型网站，频繁调用get_terms()可能会对性能产生轻微影响。在这种情况下，可以考虑：
- 缓存机制：使用WordPress的转瞬缓存（Transients API）来缓存菜单的HTML输出，减少数据库查询。
- 优化查询：如果需要更复杂的过滤或排序，可以考虑直接使用WP_Term_Query。
用户体验：
- 清晰的视觉指示：使用CSS高亮显示当前激活的分类，帮助用户了解他们当前所在的位置。
- 可折叠/展开：对于层级较深的菜单，可以考虑使用JavaScript实现子菜单的折叠和展开功能。
健壮性：在代码开头添加了if ( ! $queried_object instanceof WP_Term || $queried_object->taxonomy !== $taxonomy ) { return; }的检查，确保只有在正确的产品分类页面才会执行函数，避免在非分类页面出现错误或不必要的输出。