WooCommerce产品描述页添加对应分类描述问题求助

嘿，我懂你现在的困扰——之前的函数把所有分类的描述都一股脑输出了，完全没区分当前产品到底属于哪些分类，这确实挺闹心的。我来帮你调整代码，精准获取当前产品对应的分类描述，再追加到产品描述末尾。

问题根源 #

你之前的代码应该是直接拉取了所有产品分类的列表，没有和当前产品做关联，所以才会把所有分类的描述都堆出来。我们要做的就是先锁定当前产品的所属分类，再提取这些分类的描述。

解决方案代码 #

把下面的代码添加到你的主题functions.php文件里，或者用自定义代码插件来添加都可以：

add_filter( 'the_content', 'append_product_assigned_category_description', 20 );
function append_product_assigned_category_description( $content ) {
    // 只在单个产品详情页生效，避免其他页面乱输出
    if ( ! is_product() ) {
        return $content;
    }

    global $product;
    // 获取当前产品绑定的所有WooCommerce产品分类（专用分类法product_cat）
    $product_categories = get_the_terms( $product->get_id(), 'product_cat' );

    // 检查是否成功获取到分类，且没有错误
    if ( $product_categories && ! is_wp_error( $product_categories ) ) {
        $category_desc_html = '';

        foreach ( $product_categories as $cat ) {
            // 只处理有实际描述内容的分类
            if ( ! empty( $cat->description ) ) {
                $category_desc_html .= '<div class="product-category-desc">';
                $category_desc_html .= '<h4>' . esc_html( $cat->name ) . ' 分类说明</h4>';
                $category_desc_html .= wpautop( wp_kses_post( $cat->description ) ); // 保留段落格式同时过滤不安全内容
                $category_desc_html .= '</div>';
            }
        }

        // 如果有可用的分类描述，就追加到产品描述末尾
        if ( ! empty( $category_desc_html ) ) {
            $content .= $category_desc_html;
        }
    }

    return $content;
}

代码细节说明 #

1. 页面范围控制：用is_product()确保代码只在单个产品页面运行，不会影响博客、分类列表等其他页面。
2. 精准关联分类：通过get_the_terms()获取当前产品绑定的product_cat分类，这是实现精准输出的核心步骤。
3. 空内容过滤：只处理有描述的分类，避免输出空的区块占位置。
4. 安全输出处理：用esc_html()和wp_kses_post()保证输出内容的安全性，防止恶意代码注入，wpautop()还能保留分类描述里的段落换行格式。

可选个性化调整 #

• 如果你的产品只需要显示主分类的描述，可以把遍历分类的部分改成这样：

  $main_category = reset( $product_categories ); // 获取第一个分类（通常是设置的主分类）
  if ( ! empty( $main_category->description ) ) {
      $category_desc_html .= '<div class="product-category-desc">';
      $category_desc_html .= '<h4>' . esc_html( $main_category->name ) . ' 分类说明</h4>';
      $category_desc_html .= wpautop( wp_kses_post( $main_category->description ) );
      $category_desc_html .= '</div>';
  }
  

• 你可以自定义.product-category-desc这个CSS类的样式，比如加个浅灰色边框、调整上下间距，让分类描述和产品原描述更区分开。

这样修改后，产品描述标签页里就只会显示当前产品所属分类的描述啦，不会再乱输出所有分类的内容了。

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