获取自定义文章类型分类描述的教程-php教程-PHP中文网

获取自定义文章类型分类描述的教程

霞舞

发布： 2025-12-02 13:15:13

原创

850人浏览过

获取自定义文章类型分类描述的教程

本教程详细介绍了如何在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-youjiankuohaophpcnname) 和描述 ($term->description)。

mybatis语法和介绍中文WORD版

本文档主要讲述的是mybatis语法和介绍；MyBatis 是一个可以自定义SQL、存储过程和高级映射的持久层框架。MyBatis 摒除了大部分的JDBC代码、手工设置参数和结果集重获。MyBatis 只使用简单的XML 和注解来配置和映射基本数据类型、Map 接口和POJO 到数据库记录。相对Hibernate和Apache OJB等“一站式”ORM解决方案而言，Mybatis 是一种“半自动化”的ORM实现。感兴趣的朋友可

查看详情

<?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高级开发中一项非常实用的技能。

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