本教程详细介绍了如何在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结构
?>
此分类下暂无相关作品。
';
endif;
?>
