17370845950

新闻动态

在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() 函数来获取指定分类法下的所有术语。这是一个非常灵活的函数，可以接受各种参数来过滤和排序术语。

 true, // 只显示有文章关联的术语
    'orderby'    => 'name',
    'order'      => 'ASC'
));

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

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

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


    
        
            name); ?>
            description)) : ?>
                description); ?>

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

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


    
        
            name); ?>
            description)) : ?>
                description); ?>
            
        

        
             '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 '该分类下暂无文章。';
            endif;
            ?>
        
    


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

步骤 4: 显示关联文章

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

have_posts()) :
    while ($query->have_posts()) : $query->the_post(); ?>
        
            
                ">
                    
                         'img-fluid')); ?>
                    
                    
                
            
        
    该分类下暂无文章。';
endif;

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

完整代码示例

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

 true, // 只显示有文章关联的术语
    'orderby'    => 'name',
    'order'      => 'ASC'
));

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

        
            
                name); ?>
                description)) : ?>
                    description); ?>
                
            

            
                 '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(); ?>

                        
                            
                                ">
                                    
                                         'img-fluid')); ?>
                                    
                                    
                                
                            
                        

                    该分类下暂无文章。';
                endif; ?>

            
        

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

总结

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