WordPress 获取当前分类下的所有子分类
在 WordPress 开发中，获取父分类下的所有子分类是一个常见需求。本文将介绍如何通过代码实现这一功能。
核心思路
主要利用 WordPress 内置函数 wp_list_categories()，并通过一个辅助函数获取当前分类的根分类（顶级父分类）ID，然后将其作为参数传递给 wp_list_categories() 的 child_of 参数，从而列出该根分类下的所有直接子分类。
步骤一：添加辅助函数
首先，将以下函数添加到当前主题的 functions.php 文件中。这个函数的作用是获取任意分类的根分类（顶级父分类）的 ID。
// 获取指定分类的根分类（顶级父分类）ID
function get_category_root_id($cat) {
$this_category = get_category($cat); // 获取当前分类对象
// 循环向上查找，直到找到没有父分类的分类（即根分类）
while($this_category->category_parent) {
$this_category = get_category($this_category->category_parent);
}
return $this_category->term_id; // 返回根分类的ID
}说明： 此函数接收一个分类 ID 或分类对象作为参数，通过循环向上追溯父分类，最终返回其最顶层的分类 ID。
步骤二：在模板中调用
在需要显示子分类列表的模板文件（如 category.php, single.php 或页面模板）中，插入以下代码。通常，你需要先获取当前分类的 ID（$cat）。
<?php
// 获取当前分类ID。在分类存档页或文章页中，通常可以这样获取
$current_cat_id = get_queried_object_id();
// 调用 wp_list_categories 函数，列出根分类下的直接子分类
wp_list_categories(array(
'child_of' => get_category_root_id($current_cat_id), // 关键参数：指定根分类ID
'title_li' => '', // 移除默认的列表标题（如“分类”）
'orderby' => 'name', // 按名称排序
'show_count' => 1, // 显示文章数量（原参数 optioncount 已过时，建议使用 show_count）
'use_desc_for_title' => 1, // 使用分类描述作为链接的 title 属性
'hierarchical' => 1, // 保持层级关系（虽然这里 depth=1，但此参数影响样式类）
'show_option_none' => __('<span style="padding:0 20px;">暂无子分类。</span>'), // 无分类时的提示
'depth' => 1, // 只显示一层（即直接子分类）
'taxonomy' => 'category', // 分类法，默认为“category”
));
?>参数详解与优化
child_of: 这是实现功能的关键参数。它指定一个分类 ID，函数将列出该分类的所有子分类。我们通过辅助函数get_category_root_id()动态获取当前分类的根分类 ID 传入。depth: 设置为1表示只显示直接子分类，不显示孙分类。如果需要显示所有层级子分类，可设置为0。show_count: 替代了已过时的optioncount参数，用于控制是否在分类名后显示该分类下的文章数量。title_li: 设置为空字符串可以移除函数默认生成的<li>列表标题，让列表更干净。
使用场景与注意事项
- 确定当前分类: 在分类存档页，可以直接使用
get_queried_object_id()。在文章页，可以使用get_the_category()获取文章所属的第一个分类。 - 样式控制:
wp_list_categories()输出的 HTML 结构有固定的 CSS 类名（如.cat-item），你可以通过自定义 CSS 来美化列表样式。 - 性能考虑: 如果网站分类层级很深或分类数量庞大，循环查找根分类的函数可能产生多次数据库查询。对于高性能要求的站点，可以考虑对结果进行缓存。
通过以上两步，你就可以在 WordPress 网站的指定位置，动态显示当前所在分类的根分类下的所有子分类列表了。