本教程详细介绍了如何在wordpress中为自定义文章类型实现按分类筛选功能，并同时显示所选分类的描述信息。通过分步指导，演示了如何利用get_terms()获取分类术语，并结合wp_query的tax_query参数来组织内容，确保在展示相关文章之前，能够清晰呈现每个分类的名称和描述，从而提升用户体验和内容组织结构。
在WordPress开发中，我们经常会遇到需要为自定义文章类型（Custom Post Type, CPT）创建分类筛选视图的需求。一个常见的场景是，用户希望在按特定分类（即自定义分类法，Custom Taxonomy）筛选文章时，不仅能看到该分类下的文章列表，还能同时显示该分类的详细描述信息。这有助于用户更好地理解分类内容，提升网站的导航性和信息丰富度。
核心实现思路
要实现这一功能，我们不能仅仅依靠WordPress的主查询（main query）或简单的文章循环。核心思路是：
- 首先获取所有相关的分类术语（Terms）。 例如，如果您的自定义文章类型是“作品集”（Portfolio），分类法是“作品集分类”（Portfolio Category），那么我们需要获取所有“作品集分类”的术语。
- 遍历每个分类术语。 在遍历过程中，我们可以访问到每个术语的名称、描述等信息。
- 为每个分类术语执行一个独立的WP_Query。 这个查询将专门用于获取属于当前遍历到的分类术语的自定义文章。
通过这种“先分类，后文章”的结构，我们就能在显示特定分类下的文章之前，先展示该分类的名称和描述。
详细实现步骤与代码示例
以下是实现上述功能的PHP代码示例，您可以将其放置在主题模板文件（如archive-{post_type}.php, page-templates/your-template.php或任何您希望展示此内容的页面）中。
<?php
// 1. 获取指定自定义分类法的所有术语
// 请将 'portfolio_category' 替换为您的实际分类法名称
$terms = get_terms('portfolio_category', array(
'hide_empty' => false, // 即使分类下没有文章也显示
));
// 2. 检查是否成功获取术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
// 3. 遍历每个分类术语
foreach ($terms as $term) :
?>
<div class="category-section">
<div class="row category-header">
<div class="col-lg-12">
<!-- 显示分类名称 -->
<h2><?php echo esc_html($term->name); ?></h2>
<?php
// 4. 显示分类描述（如果存在）
if (!empty($term->description)) :
?>
<p class="category-description"><?php echo esc_html($term->description); ?></p>
<?php endif; ?>
</div>
</div>
<div class="row category-posts">
<?php
// 5. 为当前术语构建新的WP_Query查询
$args = [
'post_type' => 'YOUR_CUSTOM_POST_TYPE', // **重要：请替换为您的自定义文章类型名称**
'post_status' => 'publish', // 只查询已发布的文章
'posts_per_page' => -1, // 显示当前分类下的所有文章，或指定一个正整数
'tax_query' => [ // 税分类查询参数，用于按分类筛选文章
[
'taxonomy' => 'portfolio_category', // **重要：请替换为您的分类法名称**
'field' => 'term_id', // 根据术语ID进行查询
'terms' => $term->term_id // 当前遍历到的术语ID
]
]
];
$query = new WP_Query($args);
// 6. 检查是否有文章符合当前分类的查询条件
if ($query->have_posts()) :
// 7. 循环遍历并显示文章
while ($query->have_posts()) :
$query->the_post(); // 设置当前文章数据
?>
<div class="col-lg-4 post-item">
<a href="<?php the_permalink(); ?>">
<?php
// 显示文章特色图片（如果存在）
if (has_post_thumbnail()) :
?>
<img src="<?php the_post_thumbnail_url('medium'); ?>" alt="<?php the_title_attribute(); ?>" class="img-fluid">
<?php endif; ?>
<h3><?php the_title(); ?></h3>
</a>
</div>
<?php
endwhile;
// 8. 重置文章数据，确保主查询不受影响
wp_reset_postdata();
else :
// 如果当前分类下没有文章
?>
<div class="col-lg-12">
<p>当前分类“<?php echo esc_html($term->name); ?>”下暂无文章。</p>
</div>
<?php
endif; // 结束 $query->have_posts() 检查
?>
</div> <!-- .row category-posts -->
</div> <!-- .category-section -->
<?php
endforeach; // 结束 foreach ($terms as $term) 循环
else :
// 如果没有找到任何分类
?>
<p>未找到任何分类。</p>
<?php
endif; // 结束 !is_wp_error($terms) 检查
?>
代码解析与注意事项
-
get_terms(‘portfolio_category’, array(‘hide_empty’ => false)):
- get_terms() 是一个WordPress函数，用于获取指定分类法的所有术语。
- 第一个参数 ‘portfolio_category’ 必须替换为您实际使用的自定义分类法（Taxonomy）的名称。
- ‘hide_empty’ => false 参数确保即使某个分类下目前没有关联的文章，该分类也会被显示出来。如果只想显示有文章的分类，可以将其设置为 true。
-
foreach ($terms as $term):
- 此循环遍历 get_terms() 返回的每个分类术语对象。在循环内部，$term 变量代表当前的分类术语，您可以访问其属性，如 $term->name（名称）、$term->description（描述）、$term->term_id（ID）、$term->slug（别名）等。
-
echo esc_html($term->name); 和 echo esc_html($term->description);:
- esc_html() 是WordPress的安全函数，用于对输出的HTML内容进行转义，防止跨站脚本攻击（XSS）。建议在任何用户输入或数据库中获取的内容输出到页面时使用。
-
WP_Query 参数 ($args):
- ‘post_type’ => ‘YOUR_CUSTOM_POST_TYPE’：务必将其替换为您注册的自定义文章类型的名称。
- ‘posts_per_page’ => -1：表示获取所有符合条件的文章。如果您希望限制每个分类下显示的文章数量，可以将其设置为一个正整数，例如 5。
- ‘tax_query’：这是实现按分类筛选的关键参数。
- ‘taxonomy’ => ‘portfolio_category’：再次强调，这里应是您的分类法名称。
- ‘field’ => ‘term_id’：指定通过术语的哪个字段进行匹配。’term_id’ 是最常用和推荐的方式。
- ‘terms’ => $term->term_id：将当前循环到的分类术语的ID传递给查询，确保只获取属于该术语的文章。
-
wp_reset_postdata():
- 在自定义 WP_Query 循环（while ($query->have_posts()) : $query->the_post(); … endwhile;）结束后，始终调用 wp_reset_postdata()。这会恢复全局 $post 变量到主查询（如果有的话）的状态，防止对页面其他部分的WordPress循环和模板标签产生意外影响。
-
错误处理与空状态:
- 代码中包含了对 get_terms() 是否返回错误 (!is_wp_error($terms)) 和是否为空 (!empty($terms)) 的检查。
- 同时，也检查了每个 WP_Query 是否有文章 ($query->have_posts())，并在没有文章时显示相应的提示信息，这提升了用户体验。
总结
通过上述方法，您可以在WordPress中为自定义文章类型创建一个清晰、有组织的展示页面，其中文章按照其所属的分类进行分组，并且每个分类的名称和描述都会在文章列表之前呈现。这种结构不仅有助于网站内容的组织和管理，也能显著提升访问者对内容的理解和导航效率。请根据您的实际自定义文章类型和分类法名称，替换代码中的占位符，并根据需要调整HTML结构和CSS样式以匹配您的网站设计。
以上就是WordPress自定义文章类型：按分类筛选并显示分类描述的实现指南的详细内容，更多请关注php中文网其它相关文章！