本教程详细阐述了如何在wordpress中，当按自定义分类法（如作品集类别）过滤或展示自定义文章类型时，同时显示该分类法的描述。核心方法是首先遍历所有分类法术语，然后针对每个术语执行一个独立的wp_query来获取相关文章，从而在显示文章列表的同时，展示对应分类的详细描述信息。
在WordPress开发中，我们经常会创建自定义文章类型（Custom Post Types, CPT）并为其关联自定义分类法（Custom Taxonomies）。一个常见的需求是，当用户浏览或过滤特定分类下的文章时，不仅要显示该分类下的文章列表，还需要同时展示该分类法的描述信息，以提供更丰富的上下文。本文将详细介绍如何通过遍历分类法术语并结合WP_Query来实现这一功能。
核心策略：术语驱动的文章查询
要实现为每个分类显示其描述以及该分类下的文章，最直接且有效的方法是采用“术语驱动的查询”策略。这意味着我们将不再仅仅查询文章，而是首先获取所有目标分类法中的术语（term），然后针对每一个术语，执行一个独立的Wor
dPress查询（WP_Query）来获取与其关联的自定义文章。这种方法确保了在显示文章之前，我们已经拥有了当前术语的所有详细信息，包括其描述。
实现步骤
以下是实现此功能的具体步骤：
1. 获取所有目标分类法术语
首先，我们需要使用 get_terms() 函数来获取特定自定义分类法下的所有术语。这个函数返回一个包含所有术语对象的数组，每个对象都包含了术语的名称、描述、slug等信息。
true // 只获取有文章关联的术语
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
// 后续步骤将在循环内部进行
else :
echo '未找到任何分类术语或发生错误。
';
endif;
?>2. 遍历术语并执行文章查询
获取到术语列表后，我们需要遍历这些术语。在每次循环中，我们将：
- 显示当前术语的名称和描述。
- 构建一个 WP_Query 参数数组，其中包含 tax_query 参数，用于根据当前术语的ID来过滤文章。
- 执行 WP_Query 来获取与当前术语关联的自定义文章。
- 遍历查询结果，显示每篇文章的标题或其他所需信息。
- 在每次内部文章循环结束后，调用 wp_reset_postdata() 重置全局文章数据，以避免对后续查询产生影响。
name); ?>
description)) : ?>
description); ?>
'your_custom_post_type', // 替换为你的自定义文章类型 slug
'post_status' => 'publish',
'posts_per_page' => -1, // 显示所有文章
'tax_query' => [
[
'taxonomy' => $taxonomy_slug,
'field' => 'term_id',
'terms' => $term->term_id,
],
],
];
$query = new WP_Query($args);
if ($query->have_posts()) :
while ($query->have_posts()) : $query->the_post();
// 显示每篇文章的标题、链接等信息
?>
">
">
'img-fluid')); ?>
此分类下暂无文章。';
endif;
?>
完整示例代码
将以上步骤整合，一个完整的实现代码示例如下。请根据你的实际情况替换 your_custom_post_type 和 portfolio_category。
true, // 只显示包含文章的术语
'orderby' => 'name',
'order' => 'ASC',
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
?>
name); ?>
description)) : ?>
description); ?>
$custom_post_type,
'post_status' => 'publish',
'posts_per_page' => -1, // 显示所有文章
'tax_query' => [
[
'taxonomy' => $taxonomy_slug,
'field' => 'term_id',
'terms' => $term->term_id,
],
],
'orderby' => 'date', // 按日期排序
'order' => 'DESC', // 降序
];
$query = new WP_Query($args);
if ($query->have_posts()) :
while ($query->have_posts()) : $query->the_post();
?>
" >
">
'img-fluid rounded')); ?>
">
" class="read-more btn btn-sm btn-primary mt-2">阅读更多
此分类“name); ?>”下暂无相关文章。
抱歉，未找到任何自定义分类术语或发生错误。
注意事项与最佳实践
- 替换占位符： 务必将代码中的 your_custom_post_type 替换为你实际的自定义文章类型 slug，将 portfolio_category 替换为你实际的自定义分类法 slug。
- 性能考量： 每次遍历术语都会执行一个新的 WP_Query。对于拥有大量术语和文章的网站，这可能会导致多次数据库查询。在大多数情况下，这种性能开销是可接受的。如果遇到性能瓶颈，可以考虑使用缓存插件或更高级的查询优化技术（例如，一次性获取所有文章，然后在PHP中按分类法进行分组，但这会增加代码复杂性）。
- wp_reset_postdata() 的重要性： 在每次 WP_Query 的文章循环结束后，调用 wp_reset_postdata() 至关重要。它会将全局 $post 对象和相关数据恢复到主查询（main query）的状态，防止对页面其他部分的WordPress函数（如 the_title()、the_permalink() 等）产生意外影响。
- 错误处理和空状态： 代码中包含了 is_wp_error() 和 !empty($terms) 的检查，以优雅地处理没有术语或获取术语失败的情况。同时，也处理了特定分类下没有文章的空状态。
- 样式和布局： 示例代码中的 HTML 结构仅为演示目的，你可以根据自己的主题和设计需求进行调整，例如使用 Bootstrap 或其他 CSS 框架来美化输出。
- hide_empty 参数： 在 get_terms() 中使用 hide_empty => true 可以确保只显示那些至少关联了一篇文章的分类术语，避免显示空分类。
总结
通过上述方法，我们可以有效地在WordPress中为自定义文章类型实现按分类法分组显示，并同时展示每个分类法的描述信息。这种结构化的展示方式不仅提升了内容的可读性，也为访问者提供了更全面的信息，是构建专业WordPress网站的常用技巧。遵循本文的指导和最佳实践，你将能够轻松地将此功能集成到你的项目中。
