本文详解如何在 woocommerce 商品分类归档页中精准获取并展示当前分类的直接子分类，同时安全输出截取后的分类描述，避免误显全站分类或出现未定义变量错误。
本文详解如何在 woocommerce 商品分类归档页中精准获取并展示当前分类的直接子分类，同时安全输出截取后的分类描述，避免误显全站分类或出现未定义变量错误。
在 WooCommerce 主题开发中，常需在父级商品分类（如“Electronics”）页面展示其直属子分类（如“Smartphones”、“Laptops”），而非遍历全部分类。原始代码使用 get_terms( 'product_cat' ) 无条件拉取所有分类，且错误地调用 category_description($category_id)（变量 $category_id 未定义），导致逻辑失效与潜在 PHP 警告。
正确做法是：
基于当前查询对象（get_queried_object()）动态获取其子分类 ID 列表，再逐个构建输出
。WooCommerce（底层为 WordPress 分类系统）提供了专用函数 get_term_children()，它接收父级 term ID 和分类法名称，返回子项 ID 数组，高效且语义明确。
以下是优化后的完整实现（建议置于 taxonomy-product_cat.php 或子主题对应模板中）：
关键注意事项：
✅
勿混淆 parent 参数
：get_term_children( $parent_id, 'product_cat' ) 中的 $parent_id 应为
当前分类自身的 ID
（即 $queried_object->term_id），而非 $queried_object->parent——后者是其父级 ID，用于获取“兄弟分类”而非子分类。
✅
描述截取安全处理
：category_description() 接收 term ID 或对象均可，但必须确保变量已定义；空描述需判空，避免输出冗余
taxonomy !== 'product_cat' ) {
return; // 非商品分类页，提前退出
}
// ✅ 正确获取当前分类的直接子分类 ID 列表
// 注意：get_term_children() 的第一个参数是父级 term ID；若当前为顶级分类，$queried_object->parent === 0，仍可正常返回其子项
$child_ids = get_term_children( $queried_object->term_id, 'product_cat' );
if ( ! empty( $child_ids ) && ! is_wp_error( $child_ids ) ) {
echo '';
foreach ( $child_ids as $child_id ) {
$child_term = get_term_by( 'id', $child_id, 'product_cat' );
if ( ! $child_term || is_wp_error( $child_term ) || ! $child_term->count ) {
continue; // 跳过无效或无商品的子分类
}
$term_link = esc_url( get_term_link( $child_term ) );
$thumbnail_id = get_term_meta( $child_term->term_id, 'thumbnail_id', true );
$thumbnail_html = '';
if ( $thumbnail_id ) {
$thumbnail_html = wp_get_attachment_image( $thumbnail_id, 'full', false, [
'class' => 'attachment-full size-full',
'alt' => esc_attr( $child_term->name )
]);
} else {
$placeholder_url = wc_placeholder_img_src('full');
$thumbnail_html = 'name ) . '" />';
}
// ✅ 安全截取分类描述：使用 category_description() 时传入 term 对象或 ID，再用 wp_trim_words 处理
$desc = category_description( $child_term->term_id );
$trimmed_desc = $desc ? wp_trim_words( $desc, 20, '…' ) : '';
echo '';
echo '';
echo '' . $thumbnail_html . '';
echo '';
echo '' . esc_html( $child_term->name ) . '
';
echo '' . $trimmed_desc . '
';
echo '';
echo '';
}
echo '';
} else {
// 可选：无子分类时的友好提示
echo 'No subcategories found.
';
}
?>…
。 ✅ 图片适配 ：WooCommerce 商品分类支持自定义缩略图（通过 woocommerce_product_category_thumbnail 钩子或插件），应优先使用 get_term_meta( $term_id, 'thumbnail_id', true ) 获取， fallback 到占位图。 ⚠️ 性能提示 ：若子分类数量庞大，建议配合缓存（如 wp_cache_set/get）减少重复数据库查询。 此方案结构清晰、容错性强，符合 WordPress/WooCommerce 最佳实践，可直接集成至生产环境。