在WordPress中筛选自定义文章类型时显示分类法描述-php教程-PHP中文网

在WordPress中筛选自定义文章类型时显示分类法描述

聖光之護

发布： 2025-11-28 13:34:38

原创

195人浏览过

在WordPress中筛选自定义文章类型时显示分类法描述

本教程详细介绍如何在wordpress中，当用户根据自定义分类法（如作品集类别）筛选自定义文章类型时，有效地显示所选分类法的描述信息。通过采用先遍历分类法术语，再针对每个术语执行文章查询的策略，我们能够确保在列出相关文章之前，准确地展示分类法的名称和描述，从而提升内容呈现的结构性和用户体验。

在WordPress开发中，经常需要展示自定义文章类型（Custom Post Type, CPT）及其关联的自定义分类法（Custom Taxonomy）。当用户希望根据某个分类法进行筛选，并同时显示该分类法的详细描述时，传统的文章循环方法可能无法直接满足需求。本教程将介绍一种结构化且高效的方法，实现筛选自定义文章类型时显示对应分类法描述的功能。

理解核心挑战

通常，我们在WordPress页面中会直接进行文章循环（WP_Query），然后在循环内部通过 get_the_terms() 获取当前文章所属的分类法信息。然而，这种方法的问题在于，它是在文章层面获取分类法，而不是在分类法层面进行展示。如果我们的目标是先显示某个分类法的描述，然后列出该分类法下的所有文章，那么我们需要改变查询的逻辑。

推荐方法：以分类法为中心的查询

为了实现在显示文章之前先展示分类法描述，我们需要调整查询策略，使其以分类法术语（Term）为中心进行。具体步骤如下：

首先获取所有目标分类法术语：不再直接查询文章，而是先获取指定自定义分类法下的所有术语。
遍历每个分类法术语：在遍历过程中，我们可以直接访问并显示当前术语的名称和描述。
为每个术语执行独立的文章查询：在每个术语的循环内部，使用 WP_Query 构建一个新的查询，该查询将根据当前术语的ID来筛选文章。

这种方法确保了我们能够先获取并展示分类法的元数据（如描述），然后再列出属于该分类法的所有文章。

详细实现步骤与代码示例

假设我们有一个名为 portfolio 的自定义文章类型，以及一个名为 portfolio_category 的自定义分类法。

步骤 1: 获取所有分类法术语

使用 get_terms() 函数来获取指定分类法下的所有术语。这是一个非常灵活的函数，可以接受各种参数来过滤和排序术语。

摩笔天书

摩笔天书AI绘本创作平台

135

查看详情

<?php
// 获取 'portfolio_category' 分类法下的所有术语
$terms = get_terms('portfolio_category', array(
    'hide_empty' => true, // 只显示有文章关联的术语
    'orderby'    => 'name',
    'order'      => 'ASC'
));

// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
    // 接下来将遍历这些术语
?>

登录后复制

步骤 2: 遍历术语并显示描述

在获取到术语数组后，我们可以使用 foreach 循环遍历每个术语。在循环内部，$term 对象将包含术语的所有信息，包括 name（名称）和 description（描述）。

<?php foreach ($terms as $term) : ?>
    <div class="category-section">
        <div class="category-header">
            <h2><?php echo esc_html($term->name); ?></h2>
            <?php if (!empty($term->description)) : ?>
                <p><?php echo esc_html($term->description); ?></p>
            <?php endif; ?>
        </div>

        <div class="row portfolio-items">
            <?php
            // 步骤 3: 为当前术语执行文章查询
            // ... (代码将在下一步骤中添加)
            ?>
        </div>
    </div>
<?php endforeach; ?>
<?php endif; // 结束对 $terms 的检查 ?>

登录后复制

步骤 3: 为每个术语执行文章查询

在每个术语的循环内部，我们将创建一个新的 WP_Query 实例，利用 tax_query 参数来筛选属于当前 $term 的文章。

<?php
// ... (之前的代码)

foreach ($terms as $term) : ?>
    <div class="category-section">
        <div class="category-header">
            <h2><?php echo esc_html($term->name); ?></h2>
            <?php if (!empty($term->description)) : ?>
                <p><?php echo esc_html($term->description); ?></p>
            <?php endif; ?>
        </div>

        <div class="row portfolio-items">
            <?php
            $args = [
                'post_type'      => '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 '<p class="col-12">该分类下暂无文章。</p>';
            endif;
            ?>
        </div>
    </div>
<?php endforeach; ?>

// ... (之后的代码)

登录后复制

步骤 4: 显示关联文章

在 WP_Query 的文章循环中，我们可以像往常一样使用 WordPress 模板标签（如 the_title()、the_permalink() 等）来显示文章信息。

<?php
// ... (之前的代码)

if ($query->have_posts()) :
    while ($query->have_posts()) : $query->the_post(); ?>
        <div class="col-lg-4 col-md-6 portfolio-item">
            <div class="item-content">
                <a href="<?php the_permalink(); ?>">
                    <?php if (has_post_thumbnail()) : ?>
                        <?php the_post_thumbnail('thumbnail', array('class' => 'img-fluid')); ?>
                    <?php endif; ?>
                    <h3 class="item-title"><?php the_title(); ?></h3>
                </a>
            </div>
        </div>
    <?php
    endwhile;
    wp_reset_postdata();
else :
    echo '<p class="col-12">该分类下暂无文章。</p>';
endif;

// ... (之后的代码)
?>

登录后复制

完整代码示例

将上述所有步骤整合，得到一个完整的实现代码：

<?php
// 获取 'portfolio_category' 分类法下的所有术语
$terms = get_terms('portfolio_category', array(
    'hide_empty' => true, // 只显示有文章关联的术语
    'orderby'    => 'name',
    'order'      => 'ASC'
));

// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
    foreach ($terms as $term) : ?>

        <div class="category-section">
            <div class="category-header">
                <h2><?php echo esc_html($term->name); ?></h2>
                <?php if (!empty($term->description)) : ?>
                    <p><?php echo esc_html($term->description); ?></p>
                <?php endif; ?>
            </div>

            <div class="row portfolio-items">
                <?php
                $args = [
                    'post_type'      => '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(); ?>

                        <div class="col-lg-4 col-md-6 portfolio-item">
                            <div class="item-content">
                                <a href="<?php the_permalink(); ?>">
                                    <?php if (has_post_thumbnail()) : ?>
                                        <?php the_post_thumbnail('thumbnail', array('class' => 'img-fluid')); ?>
                                    <?php endif; ?>
                                    <h3 class="item-title"><?php the_title(); ?></h3>
                                </a>
                            </div>
                        </div>

                    <?php
                    endwhile;
                    wp_reset_postdata(); // 重置全局 $post 数据，非常重要！
                else :
                    echo '<p class="col-12">该分类下暂无文章。</p>';
                endif; ?>

            </div><!-- .row .portfolio-items -->
        </div><!-- .category-section -->

    <?php
    endforeach;
else :
    echo '<p>暂无分类数据。</p>';
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 =youjiankuohaophpcn -1 会获取所有匹配的文章。如果某个分类下的文章数量非常大，这可能会影响页面加载性能。在这种情况下，可以考虑实现分页功能，或者限制 posts_per_page 的数量。
HTML 结构和样式：示例代码提供了一个基本的 HTML 结构。在实际项目中，你需要根据设计需求添加更多的 CSS 类和样式，以确保页面美观和响应式布局。
esc_html()：在输出分类法名称和描述时，使用 esc_html() 进行转义可以有效防止 XSS 攻击，提高安全性。

总结

通过采用“先遍历分类法术语，再为每个术语执行文章查询”的策略，我们能够优雅地解决在WordPress中筛选自定义文章类型时显示分类法描述的需求。这种方法不仅结构清晰、易于维护，而且能够为用户提供更丰富、更有条理的内容呈现，从而提升整体的用户体验。遵循本教程的指导和最佳实践，你将能够灵活地在你的WordPress项目中实现类似的功能。

以上就是在WordPress中筛选自定义文章类型时显示分类法描述的详细内容，更多请关注php中文网其它相关文章！