构建动态WooCommerce产品分类导航：显示同级与一级子分类-php教程-PHP中文网

构建动态WooCommerce产品分类导航：显示同级与一级子分类

聖光之護

发布： 2025-11-18 12:30:02

原创

546人浏览过

构建动态woocommerce产品分类导航：显示同级与一级子分类

本教程详细指导如何在WooCommerce中实现一个动态产品分类列表，该列表能根据当前访问的产品分类，智能地展示其所有同级分类及其各自的一级子分类。通过PHP代码获取当前分类信息，并结合WordPress的分类查询功能，构建一个层级清晰、自适应的导航菜单，有效提升用户在网站中的浏览体验。

引言：动态分类导航的重要性

在电子商务网站中，提供直观且响应式的导航是提升用户体验的关键。当用户浏览特定产品分类时，展示与其当前位置紧密相关的分类（例如同级分类及其直接子分类），能够极大地帮助他们发现更多相关产品，从而促进销售。传统的静态导航往往无法满足这种动态需求，因此，实现一个能够根据用户当前所处分类自动调整显示内容的导航功能显得尤为重要。

本教程将介绍如何通过自定义PHP函数，在WooCommerce中构建这样一个动态分类列表。该列表不仅能显示当前分类的所有同级分类，还会进一步展示这些同级分类各自的第一级子分类，从而为用户提供一个既聚焦又具有探索性的导航体验。

核心逻辑解析

要实现动态显示当前分类的同级分类及其一级子分类，我们需要遵循以下核心逻辑：

获取当前分类信息：首先，需要确定用户当前正在查看的是哪个产品分类。这可以通过WordPress的全局查询对象来实现。
确定同级分类：一旦获取了当前分类，就可以通过其父级ID来查询所有与它共享同一父级的分类。这些就是当前分类的同级分类（包括当前分类本身）。
获取一级子分类：遍历上一步获得的每个同级分类。对于每个同级分类，查询其直接的子分类。关键在于只获取“第一级”子分类，避免显示更深层次的嵌套。
构建HTML结构：将查询到的分类数据组织成标准的HTML列表结构（zuojiankuohaophpcnul>和<li>），并生成对应的分类链接。

实现步骤：PHP代码详解

以下是实现上述功能的PHP代码。您可以将此代码添加到您的WooCommerce主题的 functions.php 文件中。

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

查看详情

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

    // 检查当前查询对象是否为产品分类，并且是否有父级ID
    // 如果当前对象不是分类，或者没有父级（即是顶级分类），则不显示菜单
    if ( ! is_a( $queried_object, 'WP_Term' ) || $queried_object->taxonomy !== $taxonomy || $queried_object->parent === 0 ) {
        // 对于顶级分类，如果需要显示所有顶级分类及其子分类，则需要修改此处的逻辑
        // 当前代码设计为只在有父级分类的情况下工作
        return; 
    }

    // 获取当前分类的所有同级分类
    // 通过查询与当前分类共享相同父级ID的分类来实现
    $sibling_terms = get_terms( array(
        'taxonomy'   => $taxonomy,
        'hide_empty' => false, // 显示即使没有产品的分类
        'parent'     => $queried_object->parent // 关键：查询与当前分类父级相同的分类
    ) );

    // 如果没有找到同级分类，则直接返回
    if ( empty( $sibling_terms ) ) {
        return;
    }

    echo '<ul class="wc-dynamic-category-menu">';

    foreach ( $sibling_terms as $sibling ) {
        // 确保当前处理的同级分类不是顶级分类 (因为 get_terms 可能返回父级为0的分类，如果 $queried_object->parent 为0)
        // 此条件在当前逻辑下确保只处理非顶级分类的同级关系
        if ( $sibling->parent > 0 ) { 
            $sibling_id = $sibling->term_id;

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

            // 输出同级分类的列表项
            echo '<li>';
            echo '<a href="' . esc_url( get_term_link( $sibling ) ) . '">' . esc_html( $sibling->name ) . '<span> (' . absint( $sibling->count ) . ')</span></a>';        

            // 如果存在一级子分类，则嵌套输出子分类列表
            if ( $sibling_children ) {
                echo '<ul class="wc-dynamic-category-submenu">';
                foreach ( $sibling_children as $child ) {
                    echo '<li><a href="' . esc_url( get_term_link( $child, $taxonomy ) ) . '">' . esc_html( $child->name ) . '<span> (' . absint( $child->count ) . ')</span></a></li>';
                }
                echo '</ul>';
            }

            echo '</li>';
        }
    }

    echo '</ul>';
}

登录后复制

代码逐行解释：

$queried_object = get_queried_object();：获取当前页面所查询的对象。在产品分类页面，它会返回一个 WP_Term 对象，代表当前的产品分类。
$taxonomy = 'product_cat';：定义我们关注的分类法为WooCommerce的产品分类。
if ( ! is_a( $queried_object, 'WP_Term' ) || $queried_object->taxonomy !== $taxonomy || $queried_object->parent === 0 ) { return; }：这是一个重要的前置条件检查。它确保只有当当前查询对象是一个有效的 product_cat 类型的分类，并且该分类不是顶级分类（即 parent 不为 0）时，函数才会继续执行。这意味着如果用户当前在浏览一个顶级分类页面，此函数将不会显示任何内容。
$sibling_terms = get_terms(...)：这是获取同级分类的关键。我们使用 get_terms 函数，并设置 parent 参数为 $queried_object->parent。这样，它将返回所有与当前分类共享同一父级ID的分类。
foreach ( $sibling_terms as $sibling )：遍历所有获取到的同级分类。
if ( $sibling->parent > 0 )：再次检查，确保当前循环的同级分类不是顶级分类。这与函数开头的检查相呼应，进一步过滤可能因 get_terms 查询而包含的顶级分类。
$sibling_children = get_terms(...)：在同级分类的循环内部，我们再次调用 get_terms 来获取每个同级分类的直接子分类。这次，parent 参数被设置为 $sibling_id，即当前同级分类的ID。
echo '<li>...</li>'：生成HTML列表项，包含分类链接、名称和产品数量。
if ( $sibling_children ) { echo '<ul>...</ul>'; }：如果某个同级分类存在子分类，则在其下方嵌套一个 <ul> 列表来显示这些子分类。

如何集成到您的WooCommerce主题

添加代码到 functions.php：将上述PHP代码块复制并粘贴到您的WordPress主题（或子主题）的 functions.php 文件的末尾。
在模板文件中调用函数：在您希望显示此动态分类菜单的任何WooCommerce模板文件（例如 sidebar.php、archive-product.php、single-product.php 或任何自定义模板文件）中，使用以下代码调用该函数：
```
<?php wc_cat_menu(); ?>
```
登录后复制
例如，您可能想将其放置在侧边栏中，以便用户在浏览产品时始终看到相关分类。

注意事项与最佳实践

顶级分类的处理：当前提供的代码设计为只在当前分类有父级时才显示菜单。这意味着如果您访问一个顶级产品分类（例如“服装”），该菜单将不会显示任何内容。如果您的需求是当用户访问顶级分类时，显示所有顶级分类及其一级子分类，您需要修改代码开头的条件判断：

// 修改前的条件：
// if ( ! is_a( $queried_object, 'WP_Term' ) || $queried_object->taxonomy !== $taxonomy || $queried_object->parent === 0 ) { return; }

// 修改后的逻辑示例 (如果当前是顶级分类，则获取所有顶级分类作为“同级”):
$parent_id = $queried_object->parent;
if ( $parent_id === 0 ) {
    // 如果当前是顶级分类，则将父级ID设为0，以便获取所有顶级分类作为同级
    $parent_for_siblings = 0; 
} else {
    $parent_for_siblings = $parent_id;
}
// 然后在 get_terms 查询同级分类时使用 $parent_for_siblings
// ...

登录后复制

以及调整 if ( $sibling->parent > 0 ) 的判断逻辑。

性能考量：对于拥有极大量分类的网站，多次调用 get_terms 可能会对性能产生轻微影响。在大多数情况下，由于分类层级和数量有限，这通常不是问题。但如果遇到性能瓶颈，可以考虑使用WordPress的转瞬缓存（Transients API）来缓存菜单的HTML输出，减少数据库查询。
CSS样式：此函数输出的是纯HTML列表结构。为了使其在您的网站上美观展示，您需要编写自定义CSS样式。代码中已经添加了 wc-dynamic-category-menu 和 wc-dynamic-category-submenu 类，方便您进行样式定制。
错误处理与健壮性：代码中已包含对 get_queried_object() 返回值的基本检查。在实际项目中，您可能还需要考虑其他边缘情况，例如当 get_term_link() 失败时的处理。
分类计数：代码中使用了 <span> (' . $sibling->count . ')</span> 来显示每个分类下的产品数量。如果您不希望显示这个数量，可以移除这部分代码。