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

聖光之護

发布时间：2025-11-17 13:59:30

336人浏览过

来源于php中文网

原创

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

本文详细介绍了如何在woocommerce中实现一个动态的产品分类导航菜单。该菜单能根据当前产品分类，智能地显示其所有同级分类以及每个同级分类下的一级子分类，从而提升用户在网站上的浏览体验和产品发现效率。教程提供了完整的php代码实现和使用说明，帮助开发者轻松集成此功能。

在WooCommerce商店中，提供直观的分类导航对于用户体验至关重要。一个常见的需求是，当用户浏览某个产品分类时，侧边栏或导航区域能动态显示当前分类的同级分类（兄弟分类）以及这些同级分类下的第一级子分类。这种展示方式有助于用户快速了解当前层级的其他选项，并探索相关子分类，而不会因显示所有深层子分类而造成信息过载。

实现动态分类导航的PHP代码

要实现这一功能，我们需要编写一个自定义的PHP函数，该函数将利用WordPress和WooCommerce提供的API来获取当前分类信息，并据此查询相关的同级和子级分类。

以下是实现此功能的完整PHP代码：

MagickPen

在线AI英语写作助手，像魔术师一样在几秒钟内写出任何东西。

下载

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 '';

    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 '';
            echo '' . esc_html( $sibling->name ) . ' (' . esc_html( $sibling->count ) . ')';

            // 如果存在子分类，则输出子分类列表
            if ( $siblingChildren ) {
                echo '';
                foreach ( $siblingChildren as $child ) {
                    echo '';
                    echo '' . esc_html( $child->name ) . ' (' . esc_html( $child->count ) . ')';
                    echo '';
                }
                echo '';
            }
            echo '';
        }
    }
    echo '';
}

代码解析

获取当前查询对象 (get_queried_object()): 这是获取当前页面所关联的WordPress对象（例如，当你在一个分类归档页时，它会返回该分类的WP_Term对象）的关键。我们从中提取当前分类的ID和父级ID。
获取同级分类 (get_terms()):
- 我们使用get_terms()函数来查询产品分类。
- 'taxonomy' => 'product_cat' 指定了我们要查询的是WooCommerce产品分类。
- 'hide_empty' => false 确保即使某个分类下没有产品，它也会被显示。
- 'parent' => $queried_object->parent 是核心所在。通过设置父级ID为当前分类的父级ID，我们有效地获取了当前分类的所有兄弟分类（包括它自己）。
遍历同级分类并获取其直接子分类:
- 代码通过一个foreach循环遍历所有获取到的同级分类。
- 对于每个同级分类 $sibling，我们再次调用 get_terms()。
- 这次，'parent' => $sibling_id 用于获取当前同级分类的直接子分类（即第一级子分类）。
构建HTML输出:
- 函数生成一个嵌套的
  - 结构，以展示分类层级关系。
  - 每个分类链接都使用 get_term_link() 生成，确保链接的正确性。
  - 分类名称和产品数量 ($sibling->count) 也被显示。
  - 为了增强可读性和样式控制，为当前分类及其子分类添加了 current-cat 和 current-cat-child 类。

集成与使用

要将此功能集成到您的WooCommerce商店中，请遵循以下步骤：

将代码添加到您的主题或插件中:
- 推荐方式： 将上述PHP代码添加到您主题的 functions.php 文件中。
- 更佳实践： 如果您正在开发一个自定义插件，可以将其放入插件的主文件中。
在需要显示菜单的位置调用函数:
- 您可以在任何WooCommerce模板文件（如 archive-product.php、sidebar.php 或自定义的侧边栏模板）中，使用 wc_cat_menu(); 来调用此函数。
- 例如，如果您想在所有产品分类归档页面的侧边栏显示此菜单，可以编辑您的主题或子主题中的 sidebar.php 文件，并在适当的位置添加。

注意事项与优化建议

性能考量: 在一个大型网站上，频繁调用 get_terms() 可能会对性能产生轻微影响。对于极高性能要求的场景，可以考虑使用WordPress的转瞬缓存（Transients API）来缓存分类列表，减少数据库查询。
样式定制: 生成的HTML结构包含
- 标签，以及 woocommerce-dynamic-category-list、current-cat 和 children 等类。您可以使用CSS对这些元素进行样式设计，以匹配您网站的主题风格。
- 顶级分类处理: 当前代码在获取同级分类时，是基于当前分类的父级。如果当前分类是顶级分类（$queried_object->parent 为 0），那么 get_terms 将返回所有顶级分类。如果您的需求是只在非顶级分类页面显示同级和子分类，或者需要特殊处理顶级分类的显示逻辑，您可能需要调整 if ( $sibling->parent >= 0 ) 这部分的条件。
- 错误处理: 代码中已增加了对 get_queried_object() 返回值的基本检查，确保只有在有效的产品分类页面才尝试生成菜单。
- 可扩展性: 如果未来需要更复杂的过滤或显示逻辑（例如，排除特定分类、按自定义字段排序），可以进一步扩展 get_terms() 的参数。
总结

通过上述PHP函数，您可以为您的WooCommerce商店创建一个高度动态且用户友好的产品分类导航菜单。这个菜单能够根据用户当前浏览的分类，智能地展示相关的同级分类及其直接子分类，极大地提升了网站的导航效率和用户体验。通过简单的集成和CSS样式定制，即可将此功能完美融入您的网站设计。