本教程详细介绍如何在wordpress中，当用户根据自定义分类法（如作品集类别）筛选自定义文章类型时，有效地显示所选分类法的描述信息。通过采用先遍历分类法术语，再针对每个术语执行文章查询的策略，我们能够确保在列出相关文章之前，准确地展示分类法的名称和描述，从而提升内容呈现的结构性和用户体验。
在WordPress开发中，经常需要展示自定义文章类型（Custom Post Type, CPT）及其关联的自定义分类法（Custom Taxonomy）。当用户希望根据某个分类法进行筛选，并同时显示该分类法的详细描述时，传统的文章循环方法可能无法直接满足需求。本教程将介绍一种结构化且高效的方法，实现筛选自定义文章类型时显示对应分类法描述的功能。
理解核心挑战
通常，我们在WordPress页面中会直接进行文章循环（WP_Query），然后在循环内部通过 get_the_terms() 获取当前文章所属的分类法信息。然而，这种方法的问题在于，它是在文章层面获取分类法，而不是在分类法层面进行展示。如果我们的目标是先显示某个分类法的描述，然后列出该分类法下的所有文章，那么我们需要改变查询的逻辑。
推荐方法：以分类法为中心的查询
为了实现在显示文章之前先展示分类法描述，我们需要调整查询策略，使其以分类法术语（Term）为中心进行。具体步骤如下：
- 首先获取所有目标分类法术语：不再直接查询文章，而是先获取指定自定义分类法下的所有术语。
- 遍历每个分类法术语：在遍历过程中，我们可以直接访问并显示当前术语的名称和描述。
- 为每个术语执行独立的文章查询：在每个术语的循环内部，使用 WP_Query 构建一个新的查询，该查询将根据当前术语的ID来筛选文章。
这种方法确保了我们能够先获取并展示分类法的元数据（如描述），然后再列出属于该分类法的所有文章。
详细实现步骤与代码示例
假设我们有一个名为 portfolio 的自定义文章类型，以及一个名为 portfolio_category 的自定义分类法。
步骤 1: 获取所有分类法术语
使用 get_terms() 函数来获取指定分类法下的所有术语。这是一个非常灵活的函数，可以接受各种参数来过滤和排序术语。
true, // 只显示有文章关联的术语
'orderby' => 'name',
'order' => 'ASC'
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
// 接下来将遍历这些术语
?>步骤 2: 遍历术语并显示描述
在获取到术语数组后，我们可以使用 foreach 循环遍历每个术语。在循环内部，$term 对象将包含术语的所有信息，包括 name（名称）和 description（描述）。
步骤 3: 为每个术语执行文章查询
在每个术语的循环内部，我们将创建一个新的 WP_Query 实例，利用 tax_query 参数来筛选属于当前 $term 的文章。
name); ?>
description)) : ?>
description); ?>
'portfolio', // 替换为你的自定义文章类型 slug
'post_status' => 'publish',
'posts_per_page' => -1, // 显示该分类下所有文章，或指定数量
'tax_query' => [
[
'taxonomy' => 'portfolio_category', // 替换为你的自定义分类法 slug
'field' => 'term_id', // 根据术语ID进行匹配
'terms' => $term->term_id // 当前术语的ID
]
]
];
$query = new WP_Query($args);
if ($query->have_posts()) :
while ($query->have_posts()) : $query->the_post();
// 步骤 4: 显示关联文章
// ... (代码将在下一步骤中添加)
endwhile;
wp_reset_postdata(); // 重置全局 $post 数据
else :
echo '该分类下暂无文章。
';
endif;
?>
// ... (之后的代码)步骤 4: 显示关联文章
在 WP_Query 的文章循环中，我们可以像往常一样使用 WordPress 模板标签（如 the_title()、the_permalink() 等）来显示文章信息。
have_posts()) :
while ($query->have_posts()) : $query->the_post(); ?>
该分类下暂无文章。';
endif;
// ... (之后的代码)
?>完整代码示例
将上述所有步骤整合，得到一个完整的实现代码：
true, // 只显示有文章关联的术语
'orderby' => 'name',
'order' => 'ASC'
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
foreach ($terms as $term) : ?>
name); ?>
description)) : ?>
description); ?>
'portfolio', // 替换为你的自定义文章类型 slug
'post_status' => 'publish',
'posts_per_page' => -1, // 显示该分类下所有文章，或指定数量
'tax_query' => [
[
'taxonomy' => 'portfolio_category', // 替换为你的自定义分类法 slug
'field' => 'term_id', // 根据术语ID进行匹配
'terms' => $term->term_id // 当前术语的ID
]
]
];
$query = new WP_Query($args);
if ($query->have_posts()) :
while ($query->have_posts()) : $query->the_post(); ?>
该分类下暂无文章。';
endif; ?>
暂无分类数据。';
endif;
?>注意事项与最佳实践
- 替换占位符：请务必将代码中的 'portfolio' 替换为你的实际自定义文章类型 slug，将 'portfolio_category' 替换为你的实际自定义分类法 slug。
- wp_reset_postdata()：在每个 WP_Query 循环结束后，调用 wp_reset_postdata() 是至关重要的。它会将全局 $post 变量恢复到主查询（main query）之前的状态，避免对后续查询或页面其他部分的显示造成意外影响。
- 错误处理：get_terms() 可能会返回 WP_Error 对象，因此在处理 $terms 之前进行 !is_wp_error($terms) 检查是一个良好的实践。同时，检查 $terms 是否为空 (!empty($terms)) 可以避免不必要的循环。
- 性能优化：posts_per_page => -1 会获取所有匹配的文章。如果某个分类下的文章数量非常大，这可能会影响页面加载性能。在这种情况下，可以考虑实现分页功能，或者限制 posts_per_page 的数量。
- HTML 结构和样式：示例代码提供了一个基本的 HTML 结构。在实际项目中，你需要根据设计需求添加更多的 CSS 类和样式，以确保页面美观和响应式布局。
- esc_html()：在输出分类法名称和描述时，使用 esc_html() 进行转义可以有效防止 XSS 攻击，提高安全性。
总结
通过采用“先遍历分类法术语，再为每个术语执行文章查询”的策略，我们能够优雅地解决在WordPress中筛选自定义文章类型时显示分类法描述的需求。这种方法不仅结构清晰、易于维护，而且能够为用户提供更丰富、更有条理的内容呈现，从而提升整体的用户体验。遵循本教程的指导和最佳实践，你将能够灵活地在你的WordPress项目中实现类似的功能。
