WordPress如何显示空分类及实现方法

WordPress 默认隐藏未发布文章的空分类，但通过在 `get_categories()` 或 `wp_list_categories()` 等函数中设置 `hide_empty => false` 参数，即可轻松显示所有已注册分类（包括暂无内容的空分类），满足侧边栏导航、分类索引页等定制化需求；配合 `esc_url()` 和 `esc_html()` 还能确保输出安全，灵活支持排序、排除特定分类等进阶控制——无需复杂修改，一行关键参数就能解锁完整分类展示能力。

在 WordPress 的 posts 页面（如 index.php 或 archive.php）中，默认的 `get_categories()` 仅返回已关联文章的非空分类；若需显示全部分类（包括暂无文章的空分类），只需设置 `hide_empty => false` 参数即可。

WordPress 提供了多个获取分类的函数，其中 get_categories() 是最常用且灵活的选择。默认情况下，该函数会自动过滤掉“空分类”（即尚未分配给任何文章的分类），这在多数场景下是合理的，但在某些定制需求中（例如侧边栏分类导航、分类目录索引页或后台管理辅助视图），你可能需要展示所有注册的分类，无论其是否已有内容。

要强制显示所有分类（含空分类），只需在参数数组中明确指定 'hide_empty' => false：

<?php
$all_categories = get_categories([
    'hide_empty' => false,
    'orderby'    => 'name',
    'order'      => 'ASC',
    'taxonomy'   => 'category' // 可省略，默认即为 category
]);

if (!empty($all_categories)) {
    echo '<ul class="category-list">';
    foreach ($all_categories as $cat) {
        echo '<li><a href="' . esc_url(get_category_link($cat->term_id)) . '">' 
             . esc_html($cat->name) 
             . ' <span class="count">(' . absint($cat->count) . ')</span></a></li>';
    }
    echo '</ul>';
}
?>

✅ 关键说明：

• hide_empty => false 是核心参数，必须显式声明；默认值为 true，因此不传参即等同于隐藏空分类。
• 建议配合 esc_url() 和 esc_html() 使用，确保输出安全，防止 XSS 风险。
• 若需排除特定分类（如 ID 为 1 的默认“未分类”），可追加 'exclude' => array(1)。
• 如需按自定义顺序（如ID或别名）排序，可调整 orderby 参数（支持 'id', 'slug', 'count', 'term_group' 等）。

⚠️ 注意：wp_list_categories() 同样支持 hide_empty 参数，用法一致（如 wp_list_categories('hide_empty=0')），但因其输出为 HTML 列表且定制性较低，推荐在需要精细控制结构时优先使用 get_categories() + 手动循环渲染。

总之，这不是逻辑错误，也无需绕过主循环——只需理解 WordPress 分类查询的默认行为，并通过一个简单参数即可满足“显示全部分类”的需求。

今天关于《WordPress如何显示空分类及实现方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！