WordPress自定义文章类型：按分类筛选并显示分类描述的实现指南-php教程-PHP中文网

WordPress自定义文章类型：按分类筛选并显示分类描述的实现指南

聖光之護

发布： 2025-11-27 13:03:33

原创

236人浏览过

WordPress自定义文章类型：按分类筛选并显示分类描述的实现指南

本教程详细介绍了如何在wordpress中为自定义文章类型实现按分类筛选功能，并同时显示所选分类的描述信息。通过分步指导，演示了如何利用get_terms()获取分类术语，并结合wp_query的tax_query参数来组织内容，确保在展示相关文章之前，能够清晰呈现每个分类的名称和描述，从而提升用户体验和内容组织结构。

在WordPress开发中，我们经常会遇到需要为自定义文章类型（Custom Post Type, CPT）创建分类筛选视图的需求。一个常见的场景是，用户希望在按特定分类（即自定义分类法，Custom Taxonomy）筛选文章时，不仅能看到该分类下的文章列表，还能同时显示该分类的详细描述信息。这有助于用户更好地理解分类内容，提升网站的导航性和信息丰富度。

核心实现思路

要实现这一功能，我们不能仅仅依靠WordPress的主查询（main query）或简单的文章循环。核心思路是：

首先获取所有相关的分类术语（Terms）。 例如，如果您的自定义文章类型是“作品集”（Portfolio），分类法是“作品集分类”（Portfolio Category），那么我们需要获取所有“作品集分类”的术语。
遍历每个分类术语。 在遍历过程中，我们可以访问到每个术语的名称、描述等信息。
为每个分类术语执行一个独立的WP_Query。 这个查询将专门用于获取属于当前遍历到的分类术语的自定义文章。

通过这种“先分类，后文章”的结构，我们就能在显示特定分类下的文章之前，先展示该分类的名称和描述。

详细实现步骤与代码示例

以下是实现上述功能的PHP代码示例，您可以将其放置在主题模板文件（如archive-{post_type}.php, page-templates/your-template.php或任何您希望展示此内容的页面）中。

<?php
// 1. 获取指定自定义分类法的所有术语
// 请将 'portfolio_category' 替换为您的实际分类法名称
$terms = get_terms('portfolio_category', array(
    'hide_empty' => false, // 即使分类下没有文章也显示
));

// 2. 检查是否成功获取术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
  // 3. 遍历每个分类术语
  foreach ($terms as $term) :
    ?>

    <div class="category-section">
      <div class="row category-header">
        <div class="col-lg-12">
          <!-- 显示分类名称 -->
          <h2><?php echo esc_html($term->name); ?></h2>
          <?php
          // 4. 显示分类描述（如果存在）
          if (!empty($term->description)) :
            ?>
            <p class="category-description"><?php echo esc_html($term->description); ?></p>
          <?php endif; ?>
        </div>
      </div>

      <div class="row category-posts">
      <?php
      // 5. 为当前术语构建新的WP_Query查询
      $args = [
        'post_type' => 'YOUR_CUSTOM_POST_TYPE', // **重要：请替换为您的自定义文章类型名称**
        'post_status' => 'publish', // 只查询已发布的文章
        'posts_per_page' => -1, // 显示当前分类下的所有文章，或指定一个正整数
        'tax_query' => [ // 税分类查询参数，用于按分类筛选文章
          [
            'taxonomy' => 'portfolio_category', // **重要：请替换为您的分类法名称**
            'field' => 'term_id', // 根据术语ID进行查询
            'terms' => $term->term_id // 当前遍历到的术语ID
          ]
        ]
      ];

      $query = new WP_Query($args);

      // 6. 检查是否有文章符合当前分类的查询条件
      if ($query->have_posts()) :
        // 7. 循环遍历并显示文章
        while ($query->have_posts()) :
          $query->the_post(); // 设置当前文章数据
          ?>

          <div class="col-lg-4 post-item">
            <a href="<?php the_permalink(); ?>">
              <?php
              // 显示文章特色图片（如果存在）
              if (has_post_thumbnail()) :
                ?>
                <img src="<?php the_post_thumbnail_url('medium'); ?>" alt="<?php the_title_attribute(); ?>" class="img-fluid">
              <?php endif; ?>
              <h3><?php the_title(); ?></h3>
            </a>
          </div>

        <?php
        endwhile;
        // 8. 重置文章数据，确保主查询不受影响
        wp_reset_postdata();
      else :
        // 如果当前分类下没有文章
        ?>
        <div class="col-lg-12">
          <p>当前分类“<?php echo esc_html($term->name); ?>”下暂无文章。</p>
        </div>
      <?php
      endif; // 结束 $query->have_posts() 检查
      ?>
      </div> <!-- .row category-posts -->
    </div> <!-- .category-section -->

  <?php
  endforeach; // 结束 foreach ($terms as $term) 循环
else :
  // 如果没有找到任何分类
  ?>
  <p>未找到任何分类。</p>
<?php
endif; // 结束 !is_wp_error($terms) 检查
?>

登录后复制

代码解析与注意事项

get_terms('portfolio_category', array('hide_empty' => false)):
- get_terms() 是一个WordPress函数，用于获取指定分类法的所有术语。
- 第一个参数 'portfolio_category' 必须替换为您实际使用的自定义分类法（Taxonomy）的名称。
- 'hide_empty' => false 参数确保即使某个分类下目前没有关联的文章，该分类也会被显示出来。如果只想显示有文章的分类，可以将其设置为 true。
foreach ($terms as $term):

腾讯混元文生视频
腾讯发布的AI视频生成大模型技术

266

查看详情
- 此循环遍历 get_terms() 返回的每个分类术语对象。在循环内部，$term 变量代表当前的分类术语，您可以访问其属性，如 $term->name（名称）、$term->description（描述）、$term->term_id（ID）、$term->slug（别名）等。
echo esc_html($term->name); 和 echo esc_html($term->description);:
- esc_html() 是WordPress的安全函数，用于对输出的HTML内容进行转义，防止跨站脚本攻击（XSS）。建议在任何用户输入或数据库中获取的内容输出到页面时使用。
WP_Query 参数 ($args):
- 'post_type' => 'YOUR_CUSTOM_POST_TYPE'：务必将其替换为您注册的自定义文章类型的名称。
- 'posts_per_page' => -1：表示获取所有符合条件的文章。如果您希望限制每个分类下显示的文章数量，可以将其设置为一个正整数，例如 5。
- 'tax_query'：这是实现按分类筛选的关键参数。
  - 'taxonomy' => 'portfolio_category'：再次强调，这里应是您的分类法名称。
  - 'field' => 'term_id'：指定通过术语的哪个字段进行匹配。'term_id' 是最常用和推荐的方式。
  - 'terms' => $term->term_id：将当前循环到的分类术语的ID传递给查询，确保只获取属于该术语的文章。
wp_reset_postdata():
- 在自定义 WP_Query 循环（while ($query->have_posts()) : $query->the_post(); ... endwhile;）结束后，始终调用 wp_reset_postdata()。这会恢复全局 $post 变量到主查询（如果有的话）的状态，防止对页面其他部分的WordPress循环和模板标签产生意外影响。
错误处理与空状态:
- 代码中包含了对 get_terms() 是否返回错误 (!is_wp_error($terms)) 和是否为空 (!empty($terms)) 的检查。
- 同时，也检查了每个 WP_Query 是否有文章 ($query->have_posts())，并在没有文章时显示相应的提示信息，这提升了用户体验。

总结

通过上述方法，您可以在WordPress中为自定义文章类型创建一个清晰、有组织的展示页面，其中文章按照其所属的分类进行分组，并且每个分类的名称和描述都会在文章列表之前呈现。这种结构不仅有助于网站内容的组织和管理，也能显著提升访问者对内容的理解和导航效率。请根据您的实际自定义文章类型和分类法名称，替换代码中的占位符，并根据需要调整HTML结构和CSS样式以匹配您的网站设计。

以上就是WordPress自定义文章类型：按分类筛选并显示分类描述的实现指南的详细内容，更多请关注php中文网其它相关文章！