本教程详细介绍了如何在wordpress中，当对自定义文章类型进行分类筛选时，显示对应分类（taxonomy）的描述信息。通过先遍历分类术语，然后针对每个术语执行文章查询，可以实现将分类名称和描述与相关文章内容一同一同展示，从而构建结构化且信息丰富的页面布局。
在WordPress开发中，我们经常需要创建自定义文章类型（Custom Post Types, CPT）并为其定义自定义分类法（Custom Taxonomies），例如为“作品集”（Portfolio）文章类型创建“作品分类”（Portfolio Category）。当用户浏览或筛选这些作品时，通常希望在展示作品列表的同时，也能看到当前所选分类的详细描述。本文将指导您如何实现这一功能，通过组织查询逻辑，确保分类描述能与其关联的文章内容一同呈现。
核心思路
实现这一功能的关键在于改变传统的文章查询方式。通常我们直接查询文章，然后获取其分类信息。但为了在文章列表之前或之上显示分类描述，我们需要反向操作：首先遍历所有目标分类术语（terms），然后针对每个术语，执行一次独立的文章查询，以获取属于该术语的所有文章。这样，在每次术语循环中，我们都可以先输出术语的名称和描述，再输出其下的文章。
逐步实现
以下是实现此功能的具体步骤和代码示例：
1. 获取所有目标分类术语
首先，我们需要使用 get_terms() 函数来获取特定自定义分类法下的所有术语。
<?php
// 假设您的自定义分类法是 'portfolio_category'
$terms = get_terms('portfolio_category', array(
'hide_empty' => false // 如果需要显示没有文章的分类，设置为 false
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
// 后续操作将在该循环内部进行
endif;
?>2. 遍历每个分类术语
获取到术语列表后，我们需要遍历它们。在每次循环中，当前 $term 对象将包含该分类术语的所有信息，包括名称 ($term->name) 和描述 ($term->description)。
<?php
// ... (接上一步代码)
if (!is_wp_error($terms) && !empty($terms)) :
foreach ($terms as $term) :
// 每个 $term 都是一个 WP_Term 对象
// 可以在这里输出分类的名称和描述
?>
<div class="category-section">
<h2 class="category-title"><?= esc_html($term->name); ?></h2>
<?php if (!empty($term->description)) : ?>
<p class="category-description"><?= esc_html($term->description); ?></p>
<?php endif; ?>
<div class="row category-posts">
<?php
// 接下来将在这里查询并显示该分类下的文章
?>
</div>
</div>
<?php
endforeach;
endif;
?>3. 为每个术语执行文章查询
在每次术语循环内部，我们将创建一个新的 WP_Query 实例，专门查询属于当前 $term 的文章。这需要使用 tax_query 参数。
<?php
// ... (接上一步代码)
foreach ($terms as $term) :
// ... (输出分类名称和描述)
?>
<div class="row category-posts">
<?php
$args = [
'post_type' => '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();
// 在这里输出每篇文章的内容
?>
<div class="col-lg-4 post-item">
<h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
<?php the_post_thumbnail('thumbnail'); // 显示文章缩略图 ?>
<?php the_excerpt(); // 显示文章摘要 ?>
</div>
<?php
endwhile;
wp_reset_postdata(); // 重置全局文章数据，非常重要！
else :
// 如果该分类下没有文章
echo '<p class="no-posts-found">此分类下暂无文章。</p>';
endif;
?>
</div>
<?php
endforeach;
// ... (结束 if 语句)
?>完整代码示例
将以上片段整合，您将得到一个功能完整的代码块，用于在WordPress页面模板中显示按分类组织的自定义文章类型，并包含分类描述：
<?php
/**
* 模板文件示例：显示按分类组织的自定义文章类型及其描述
* 适用于 'portfolio' 自定义文章类型和 'portfolio_category' 自定义分类法
*/
// 获取 'portfolio_category' 分类法下的所有术语
$terms = get_terms('portfolio_category', array(
'hide_empty' => false // 如果需要显示没有文章的分类，请设置为 false
));
// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
foreach ($terms as $term) :
?>
<div class="category-section mb-5">
<div class="container">
<div class="row">
<div class="col-12">
<h2 class="category-title text-center my-4"><?= esc_html($term->name); ?></h2>
<?php if (!empty($term->description)) : ?>
<p class="category-description text-center text-muted mb-4"><?= esc_html($term->description); ?></p>
<?php endif; ?>
</div>
</div>
<div class="row category-posts">
<?php
// 为当前分类术语构建 WP_Query 参数
$args = [
'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();
// 输出每篇文章的HTML结构
?>
<div class="col-lg-4 col-md-6 mb-4">
<div class="card h-100">
<?php if (has_post_thumbnail()) : ?>
<a href="<?php the_permalink(); ?>">
<?php the_post_thumbnail('medium', array('class' => 'card-img-top')); ?>
</a>
<?php endif; ?>
<div class="card-body">
<h4 class="card-title">
<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
</h4>
<p class="card-text"><?php the_excerpt(); ?></p>
</div>
<div class="card-footer">
<a href="<?php the_permalink(); ?>" class="btn btn-primary">查看详情</a>
</div>
</div>
</div>
<?php
endwhile;
wp_reset_postdata(); // 重置全局文章数据，避免影响后续查询
else :
// 如果当前分类下没有文章
echo '<div class="col-12"><p class="text-center text-muted">此分类下暂无相关作品。</p></div>';
endif;
?>
</div> <!-- .row.category-posts -->
</div> <!-- .container -->
</div> <!-- .category-section -->
<?php
endforeach;
else :
// 如果没有找到任何分类术语
echo '<p class="text-center text-muted">未找到任何作品分类。</p>';
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高级开发中一项非常实用的技能。
