本教程详细介绍了如何在wordpress中，当对自定义文章类型进行分类筛选时，显示对应分类（taxonomy）的描述信息。通过先遍历分类术语，然后针对每个术语执行文章查询，可以实现将分类名称和描述与相关文章内容一同一同展示，从而构建结构化且信息丰富的页面布局。
在WordPress开发中，我们经常需要创建自定义文章类型（Custom Post Types, CPT）并为其定义自定义分类法（Custom Taxonomies），例如为“作品集”（Portfolio）文章类型创建“作品分类”（Portfolio Category）。当用户浏览或筛选这些作品时，通常希望在展示作品列表的同时，也能看到当前所选分类的详细描述。本文将指导您如何实现这一功能，通过组织查询逻辑，确保分类描述能与其关联的文章内容一同呈现。
核心思路
实现这一功能的关键在于改变传统的文章查询方式。通常我们直接查询文章，然后获取其分类信息。但为了在文章列表之前或之上显示分类描述，我们需要反向操作：首先遍历所有目标分类术语（terms），然后针对每个术语，执行一次独立的文章查询，以获取属于该术语的所有文章。这样，在每次术语循环中，我们都可以先输出术语的名称和描述，再输出其下的文章。
逐步实现
以下是实现此功能的具体步骤和代码示例：
1. 获取所有目标分类术语
首先，我们需要使用 get_terms() 函数来获取特定自定义分类法下的所有术语。
false // 如果需要显示没有文章的分类，设置为 false
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
// 后续操作将在该循环内部进行
endif;
?>2. 遍历每个分类术语
获取到术语列表后，我们需要遍历它们。在每次循环中，当前 $term 对象将包含该分类术语的所有信息，包括名称 ($term->name) 和描述 ($term->description)。
name); ?>
description)) : ?>
description); ?>
3. 为每个术语执行文章查询
在每次术语循环内部，我们将创建一个新的 WP_Query 实例，专门查询属于当前 $term 的文章。这需要使用 tax_query 参数。
'YOUR_CUSTOM_POST_TYPE', // 替换为您的自定义文章类型，例如 'portfolio'
'post_status' => 'publish',
'posts_per_page' => -1, // 显示所有文章，或指定数量
'tax_query' => [
[
'taxonomy' => 'portfolio_category', // 替换为您的自定义分类法
'field' => 'term_id',
'terms' => $term->term_id // 根据当前循环的术语ID进行筛选
]
]
];
$query = new WP_Query($args);
if ($query->have_posts()) :
while ($query->have_posts()) :
$query->the_post();
// 在这里输出每篇文章的内容
?>
">
此分类下暂无文章。';
endif;
?>
完整代码示例
将以上片段整合，您将得到一个功能完整的代码块，用于在WordPress页面模板中显示按分类组织的自定义文章类型，并包含分类描述：
false // 如果需要显示没有文章的分类，请设置为 false
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
foreach ($terms as $term) :
?>
name); ?>
description)) : ?>
description); ?>
'portfolio', // 您的自定义文章类型
'post_status' => 'publish',
'posts_per_page' => -1, // 显示所有文章
'tax_query' => [
[
'taxonomy' => 'portfolio_category', // 您的自定义分类法
'field' => 'term_id',
'terms' => $term->term_id // 根据当前术语ID筛选
]
]
];
$query = new WP_Query($args);
if ($query->have_posts()) :
while ($query->have_posts()) :
$query->the_post();
// 输出每篇文章的HTML结构
?>
">
'card-img-top')); ?>
">
" class="btn btn-primary">查看详情
此分类下暂无相关作品。';
endif;
?>
未找到任何作品分类。';
endif;
?>
此分类下暂无相关作品。';
endif;
?>
未找到任何作品分类。';
endif;
?>注意事项与最佳实践
- 替换占位符： 务必将代码中的 YOUR_CUSTOM_POST_TYPE 和 portfolio_category 替换为您实际使用的自定义文章类型和自定义分类法名称。
- wp_reset_postdata()： 在每次 WP_Query 循环结束后，调用 wp_reset_postdata() 至关重要。它会重置全局的 $post 数据，确保后续的WordPress循环（例如主查询或页面上的其他查询）不会受到当前自定义查询的影响。
- 错误处理： 使用 !is_wp_error($terms) 检查 get_terms() 是否返回了错误，增强代码的健壮性。
- hide_empty 参数： get_terms() 函数的 hide_empty 参数决定是否显示没有关联文章的分类。根据您的需求设置为 true (默认) 或 false。
- 性能考虑： posts_per_page => -1 会获取所有匹配的文章。如果某个分类下的文章数量非常大，这可能会影响页面加载性能。对于大量文章的分类，您可能需要考虑分页或限制显示数量。
- HTML 结构： 示例代码提供了基本的 HTML 结构，您可以根据自己的前端设计和 CSS 框架（如 Bootstrap）进行调整和美化。
- 可访问性： 确保您的 HTML 结构和内容符合可访问性标准。
总结
通过上述方法，您可以有效地在WordPress中展示按自定义分类法组织的自定义文章类型，并为每个分类提供详细的描述。这种结构化的内容展示方式不仅提升了用户体验，也使得页面内容更具信息量和可读性，特别适用于作品集、产品目录或知识库等场景。理解并应用这种“先分类后文章”的查询逻辑，是WordPress高级开发中一项非常实用的技能。
