本教程详细介绍了如何在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(); // 在这里输出每篇文章的内容 ?><?php endwhile; wp_reset_postdata(); // 重置全局文章数据，非常重要！ else : // 如果该分类下没有文章 echo '<a href="">
此分类下暂无文章。
'; endif; ?>
完整代码示例
将以上片段整合，您将得到一个功能完整的代码块，用于在WordPress页面模板中显示按分类组织的自定义文章类型，并包含分类描述：
false // 如果需要显示没有文章的分类，请设置为 false));// 检查是否成功获取到术语且没有WordPress错误if (!is_wp_error($terms) && !empty($terms)) : foreach ($terms as $term) :?><?php endforeach;else : // 如果没有找到任何分类术语 echo '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结构 ?><?php endwhile; wp_reset_postdata(); // 重置全局文章数据，避免影响后续查询 else : // 如果当前分类下没有文章 echo '<a href=""> 'card-img-top')); ?><a href="">
'; 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高级开发中一项非常实用的技能。
以上就是获取自定义文章类型分类描述的教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1339915.html
微信扫一扫 
支付宝扫一扫 
