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

在WordPress中为自定义文章类型显示分类法描述的教程

花韻仙語

发布： 2025-11-27 12:16:13

原创

670人浏览过

在WordPress中为自定义文章类型显示分类法描述的教程

本教程详细阐述了如何在wordpress中，当按自定义分类法（如作品集类别）过滤或展示自定义文章类型时，同时显示该分类法的描述。核心方法是首先遍历所有分类法术语，然后针对每个术语执行一个独立的wp_query来获取相关文章，从而在显示文章列表的同时，展示对应分类的详细描述信息。

在WordPress开发中，我们经常会创建自定义文章类型（Custom Post Types, CPT）并为其关联自定义分类法（Custom Taxonomies）。一个常见的需求是，当用户浏览或过滤特定分类下的文章时，不仅要显示该分类下的文章列表，还需要同时展示该分类法的描述信息，以提供更丰富的上下文。本文将详细介绍如何通过遍历分类法术语并结合WP_Query来实现这一功能。

核心策略：术语驱动的文章查询

要实现为每个分类显示其描述以及该分类下的文章，最直接且有效的方法是采用“术语驱动的查询”策略。这意味着我们将不再仅仅查询文章，而是首先获取所有目标分类法中的术语（term），然后针对每一个术语，执行一个独立的WordPress查询（WP_Query）来获取与其关联的自定义文章。这种方法确保了在显示文章之前，我们已经拥有了当前术语的所有详细信息，包括其描述。

实现步骤

以下是实现此功能的具体步骤：

1. 获取所有目标分类法术语

首先，我们需要使用 get_terms() 函数来获取特定自定义分类法下的所有术语。这个函数返回一个包含所有术语对象的数组，每个对象都包含了术语的名称、描述、slug等信息。

Typewise.app

面向客户服务和销售团队的AI写作解决方案。

查看详情

<?php
// 假设你的自定义分类法是 'portfolio_category'
$taxonomy_slug = 'portfolio_category';
$terms = get_terms($taxonomy_slug, array(
    'hide_empty' => true // 只获取有文章关联的术语
));

// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
    // 后续步骤将在循环内部进行
else :
    echo '<p>未找到任何分类术语或发生错误。</p>';
endif;
?>

登录后复制

2. 遍历术语并执行文章查询

获取到术语列表后，我们需要遍历这些术语。在每次循环中，我们将：

显示当前术语的名称和描述。
构建一个 WP_Query 参数数组，其中包含 tax_query 参数，用于根据当前术语的ID来过滤文章。
执行 WP_Query 来获取与当前术语关联的自定义文章。
遍历查询结果，显示每篇文章的标题或其他所需信息。
在每次内部文章循环结束后，调用 wp_reset_postdata() 重置全局文章数据，以避免对后续查询产生影响。

<?php
// ... (接上一步的代码)

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 class="category-description"><?php echo esc_html($term->description); ?></p>
                <?php endif; ?>
            </div>

            <div class="posts-grid row">
                <?php
                // 构建WP_Query参数，查询当前术语下的自定义文章
                $args = [
                    'post_type'      => 'your_custom_post_type', // 替换为你的自定义文章类型 slug
                    'post_status'    => 'publish',
                    'posts_per_page' => -1, // 显示所有文章
                    'tax_query'      => [
                        [
                            'taxonomy' => $taxonomy_slug,
                            'field'    => 'term_id',
                            'terms'    => $term->term_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 mb-4">
                            <div class="post-item">
                                <h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
                                <!-- 可以添加文章缩略图、摘要等 -->
                                <?php if (has_post_thumbnail()) : ?>
                                    <a href="<?php the_permalink(); ?>">
                                        <?php the_post_thumbnail('thumbnail', array('class' => 'img-fluid')); ?>
                                    </a>
                                <?php endif; ?>
                                <p><?php the_excerpt(); ?></p>
                            </div>
                        </div>
                    <?php
                    endwhile;
                    wp_reset_postdata(); // 重置文章数据
                else :
                    echo '<div class="col-12"><p>此分类下暂无文章。</p></div>';
                endif;
                ?>
            </div><!-- .posts-grid -->
        </div><!-- .category-section -->
        <?php
    endforeach;
endif;
?>

登录后复制

完整示例代码

将以上步骤整合，一个完整的实现代码示例如下。请根据你的实际情况替换 your_custom_post_type 和 portfolio_category。

<?php
/**
 * 在WordPress中按自定义分类法分组显示文章，并展示分类法描述。
 */

// 定义你的自定义文章类型和自定义分类法
$custom_post_type = 'your_custom_post_type'; // 例如: 'portfolio'
$taxonomy_slug = 'portfolio_category';       // 例如: 'portfolio_category'

// 获取指定分类法下的所有术语
$terms = get_terms($taxonomy_slug, array(
    'hide_empty' => true, // 只显示包含文章的术语
    'orderby'    => 'name',
    'order'      => 'ASC',
));

// 检查是否成功获取到术语且没有WordPress错误
if (!is_wp_error($terms) && !empty($terms)) :
    ?>
    <div class="custom-taxonomy-listing">
        <?php
        foreach ($terms as $term) :
            // 为每个分类术语创建一个独立的展示区块
            ?>
            <section class="category-group mb-5">
                <header class="category-group-header mb-4">
                    <h2 class="category-name display-4"><?php echo esc_html($term->name); ?></h2>
                    <?php if (!empty($term->description)) : ?>
                        <p class="category-description lead"><?php echo esc_html($term->description); ?></p>
                    <?php endif; ?>
                </header>

                <div class="row posts-in-category">
                    <?php
                    // 构建WP_Query参数，查询当前术语下的自定义文章
                    $args = [
                        'post_type'      => $custom_post_type,
                        'post_status'    => 'publish',
                        'posts_per_page' => -1, // 显示所有文章
                        'tax_query'      => [
                            [
                                'taxonomy' => $taxonomy_slug,
                                'field'    => 'term_id',
                                'terms'    => $term->term_id,
                            ],
                        ],
                        'orderby'        => 'date', // 按日期排序
                        'order'          => 'DESC', // 降序
                    ];

                    $query = new WP_Query($args);

                    if ($query->have_posts()) :
                        while ($query->have_posts()) : $query->the_post();
                            ?>
                            <div class="col-lg-4 col-md-6 mb-4">
                                <article id="post-<?php the_ID(); ?>" <?php post_class('post-card'); ?>>
                                    <?php if (has_post_thumbnail()) : ?>
                                        <div class="post-thumbnail">
                                            <a href="<?php the_permalink(); ?>">
                                                <?php the_post_thumbnail('medium', array('class' => 'img-fluid rounded')); ?>
                                            </a>
                                        </div>
                                    <?php endif; ?>
                                    <div class="post-content p-3">
                                        <h3 class="post-title h5 mt-2"><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
                                        <div class="post-excerpt">
                                            <?php the_excerpt(); ?>
                                        </div>
                                        <a href="<?php the_permalink(); ?>" class="read-more btn btn-sm btn-primary mt-2">阅读更多</a>
                                    </div>
                                </article>
                            </div>
                        <?php
                        endwhile;
                        wp_reset_postdata(); // 重置文章数据，非常重要
                    else :
                        // 如果当前分类下没有文章
                        ?>
                        <div class="col-12">
                            <p class="text-muted">此分类“<?php echo esc_html($term->name); ?>”下暂无相关文章。</p>
                        </div>
                    <?php
                    endif;
                    ?>
                </div><!-- .row.posts-in-category -->
            </section><!-- .category-group -->
        <?php
        endforeach;
        ?>
    </div><!-- .custom-taxonomy-listing -->
<?php
else :
    // 如果没有获取到任何分类术语
    ?>
    <p class="alert alert-warning">抱歉，未找到任何自定义分类术语或发生错误。</p>
<?php
endif;
?>

登录后复制

注意事项与最佳实践

替换占位符： 务必将代码中的 your_custom_post_type 替换为你实际的自定义文章类型 slug，将 portfolio_category 替换为你实际的自定义分类法 slug。
性能考量： 每次遍历术语都会执行一个新的 WP_Query。对于拥有大量术语和文章的网站，这可能会导致多次数据库查询。在大多数情况下，这种性能开销是可接受的。如果遇到性能瓶颈，可以考虑使用缓存插件或更高级的查询优化技术（例如，一次性获取所有文章，然后在PHP中按分类法进行分组，但这会增加代码复杂性）。
wp_reset_postdata() 的重要性： 在每次 WP_Query 的文章循环结束后，调用 wp_reset_postdata() 至关重要。它会将全局 $post 对象和相关数据恢复到主查询（main query）的状态，防止对页面其他部分的WordPress函数（如 the_title()、the_permalink() 等）产生意外影响。
错误处理和空状态： 代码中包含了 is_wp_error() 和 !empty($terms) 的检查，以优雅地处理没有术语或获取术语失败的情况。同时，也处理了特定分类下没有文章的空状态。
样式和布局： 示例代码中的 HTML 结构仅为演示目的，你可以根据自己的主题和设计需求进行调整，例如使用 Bootstrap 或其他 CSS 框架来美化输出。
hide_empty 参数： 在 get_terms() 中使用 hide_empty =youjiankuohaophpcn true 可以确保只显示那些至少关联了一篇文章的分类术语，避免显示空分类。

总结

通过上述方法，我们可以有效地在WordPress中为自定义文章类型实现按分类法分组显示，并同时展示每个分类法的描述信息。这种结构化的展示方式不仅提升了内容的可读性，也为访问者提供了更全面的信息，是构建专业WordPress网站的常用技巧。遵循本文的指导和最佳实践，你将能够轻松地将此功能集成到你的项目中。

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