如何在WordPress博客页(文章页)显示文章分类名称
WordPress列表页展示文章分类的实现方案
核心实现逻辑
分类信息的获取代码必须放在WordPress主循环 while ( have_posts() ) : the_post(); 内部执行,否则无法匹配到对应文章的分类数据。WordPress 原生提供了内置函数,不需要手动编写数据库查询就能直接调用:
- 直接输出带跳转链接的分类名称:使用内置函数
the_category(),支持自定义多个分类之间的分隔符,调用后会自动渲染当前文章绑定的所有分类的跳转链接 - 自定义渲染分类样式:使用
get_the_category()获取当前文章的分类对象数组,可以按需提取分类ID、分类名称、分类链接等字段,自主拼接前端展示结构 - 仅展示单主分类:如果文章绑定了多个分类,只需要展示第一个绑定分类的话,可以在
get_the_category()返回的数组中取下标为0的元素值即可
适配现有代码的修改示例
你当前的列表循环代码存在未使用变量、结构不规范的小问题,修改后加入分类展示模块的完整代码如下:
<div class="common_wrapper"> <div class="wrapper_100"> <?php $current_year = null; while ( have_posts() ) : the_post(); $this_year = get_the_date( 'Y' ); if ( $this_year !== $current_year ) { echo '<h2>' . $this_year . '</h2>'; } $current_year = $this_year; ?> <div class="post-item"> <a href="<?php echo get_permalink(); ?>"> <span class="post-date"><?php the_date('Y/m/d')?></span> <!-- 分类展示块,可通过CSS调整位置匹配设计效果 --> <span class="post-category"> <?php // 方案1:直接输出带链接的全部分类,分隔符可自定义 the_category( ' / ' ); // 方案2:仅展示首个分类、自定义结构时使用,替换上面的the_category即可 // $post_cats = get_the_category(); // if ( ! empty( $post_cats ) ) { // echo '<a href="' . esc_url( get_category_link( $post_cats[0]->term_id ) ) . '">' . esc_html( $post_cats[0]->name ) . '</a>'; // } ?> </span> </a> <div class="post-content"> <?php the_content()?> </div> </div> <?php endwhile;?> </div> </div>
常见注意事项
- 如果站点使用自定义文章类型(CPT)、绑定的是自定义分类法(并非WordPress默认的
category体系),需要将分类获取逻辑替换为get_the_terms( get_the_ID(), '你的自定义分类法名称' )来匹配对应数据 - 手动拼接分类输出结构时,要对分类名称、链接做安全转义,用
esc_html()、esc_url()包裹输出内容,避免XSS安全风险 - 可给分类模块添加自定义类名,通过调整CSS的定位、颜色、字号匹配设计要求,比如将分类模块放在文章条目的右上角位置
原代码中将
the_content()直接嵌套在<a>标签内部,长内容会导致全文被链接包裹,实际展示时建议将正文块移出链接层级,仅保留标题、日期、分类的跳转入口,优化交互体验。
内容的提问来源于stack exchange,提问作者jricc russel
相关产品推荐
相关产品推荐

