WordPress 获取文章所属分类名称与别名的完整指南

2020-11-28 · Ryan · 发表评论

引言

在 WordPress 主题或插件开发中，经常需要获取文章所属的分类信息，例如分类名称或别名（slug）。本文将详细介绍几种标准方法，帮助你在不同场景下准确获取所需数据。

获取分类链接与名称

WordPress 核心提供了一个便捷函数 the_category()，它会输出文章所属分类的链接列表（通常以 HTML 超链接形式）。

<?php the_category(); ?>

此函数适用于需要直接显示带链接的分类标签的场景。但有时我们只需要纯文本的分类名称。

在分类归档页获取当前分类名称

如果你正在分类归档页面（如 category.php），可以使用 single_cat_title() 函数来获取当前正在浏览的分类名称。

<?php single_cat_title(); ?>

在文章页获取所属分类名称

在单篇文章页面（如 single.php），文章可能属于多个分类。要获取所有分类的名称，可以使用 get_the_category() 函数循环输出。

<?php
$categories = get_the_category();
if ( ! empty( $categories ) ) {
    foreach( $categories as $category ) {
        echo esc_html( $category->name ) . ' ';
    }
}
?>

代码说明：

get_the_category() 返回一个包含分类对象的数组。
每个分类对象的 name 属性即为分类名称。
使用 esc_html() 对输出进行转义，是安全编码的最佳实践。

获取第一个分类的名称

如果只需要文章的第一个（或主要）分类名称，可以这样写：

<?php
$categories = get_the_category();
if ( ! empty( $categories ) ) {
    $first_category = $categories[0];
    echo esc_html( $first_category->name );
}
?>

获取分类别名（Slug）

分类别名（Slug）是分类 URL 中的标识符，常用于构建链接或进行条件判断。

在文章页获取分类别名

<?php
$categories = get_the_category();
if ( ! empty( $categories ) ) {
    foreach( $categories as $category ) {
        echo esc_html( $category->slug ) . ' '; // 输出别名
    }
}
?>

在分类归档页获取当前分类别名

<?php
if ( is_category() ) {
    $current_cat = get_queried_object(); // 获取当前查询的分类对象
    if ( $current_cat ) {
        echo esc_html( $current_cat->slug );
    }
}
?>

修正与优化说明： 原文中在分类页获取别名的代码使用了 get_query_var('cat') 和 get_category()，虽然可行，但 get_queried_object() 是更直接、更现代的标准方法，能直接返回当前分类的对象。

总结与最佳实践

获取 WordPress 分类信息的关键在于明确你所在的环境（文章页还是分类页）以及你需要的数据（名称、别名还是链接）。

名称： 使用分类对象的 ->name 属性。
别名： 使用分类对象的 ->slug 属性。
安全输出： 始终使用 esc_html() 对从数据库获取的文本进行转义，以防止 XSS 攻击。
环境判断： 善用 is_category()、is_single() 等条件标签。

掌握这些核心函数和方法，你就能在 WordPress 开发中灵活地处理和展示分类信息。

引言