WordPress自定义文章类型分类(Taxonomy)的正确获取与查询方法

碧海醫心
发布: 2025-12-04 12:54:25
原创
199人浏览过

wordpress自定义文章类型分类(taxonomy)的正确获取与查询方法

本教程详细阐述了在WordPress中如何正确获取和显示自定义文章类型(Custom Post Type)的分类(Taxonomy)术语,以及如何根据这些术语查询相关文章。文章将纠正使用get_categories和cat参数的常见误区,并指导读者利用get_terms函数获取自定义分类术语,并通过WP_Query的tax_query参数实现精确的文章筛选,确保代码的专业性和效率。

在WordPress开发中,自定义文章类型(Custom Post Types, CPT)和自定义分类法(Custom Taxonomies)是扩展网站功能的强大工具。然而,许多开发者在处理自定义分类法时,常会混淆其与WordPress默认分类(Categories)的区别,导致在使用get_categories等函数时遇到问题。本教程将深入探讨如何正确地获取、显示自定义文章类型的分类术语,并根据这些术语查询相关文章。

理解WordPress分类法的基础

WordPress默认提供了两种内置分类法:category(分类)和post_tag(标签),它们主要用于管理默认文章类型post。当您创建自定义文章类型时,通常也需要为其注册自定义分类法,以便更好地组织内容。

例如,以下代码展示了如何在functions.php中为名为pdf的自定义文章类型注册一个名为pdf_cat的自定义分类法:

// 在 functions.php 中注册自定义分类法
function register_custom_pdf_taxonomy() {
    $args = array(
        'label'                 => 'PDF分类', // 分类法的显示名称
        'public'                => true,       // 是否公开可见
        'show_ui'               => true,       // 是否在后台显示管理界面
        'show_in_nav_menus'     => true,       // 是否在导航菜单中可用
        'show_admin_column'     => true,       // 是否在文章列表页显示为列
        'hierarchical'          => true,       // 是否具有层级结构(像分类一样)
        'query_var'             => true,       // 是否允许通过URL查询
        'rewrite'               => array( 'slug' => 'pdf-category' ), // URL重写规则
        'capabilities'          => array(
            'manage_terms'      => 'manage_categories',
            'edit_terms'        => 'edit_categories',
            'delete_terms'      => 'delete_categories',
            'assign_terms'      => 'assign_categories',
        ),
    );
    // 将 'pdf_cat' 分类法注册到 'pdf' 文章类型
    register_taxonomy('pdf_cat', 'pdf', $args);
}
add_action('init', 'register_custom_pdf_taxonomy');
登录后复制

上述代码注册了一个名为pdf_cat的分类法,并将其关联到自定义文章类型pdf。请注意,pdf_cat是一个独立的分类法,与WordPress默认的category分类法是不同的实体。

正确获取自定义分类法(Taxonomy)的术语(Terms)

当您需要获取特定自定义分类法下的所有术语(Terms),例如获取pdf_cat下的所有分类项时,不应使用get_categories()函数。get_categories()专门用于获取WordPress默认的category分类法下的分类。对于自定义分类法,正确的函数是get_terms()。

错误示例(应避免):

以下是尝试使用get_categories()来获取自定义文章类型pdf的分类的常见错误方式:

<?php
// 这是一个错误示例,因为 get_categories() 不适用于自定义分类法
$args = array(
    'post_type' => 'pdf', // 尝试通过 post_type 过滤,但 get_categories() 不支持此参数
    'orderby'   => 'slug',
    'order'     => 'ASC',
    'parent'    => 0,
    'hide_empty'=> false
);
$categories = get_categories($args); // 这将返回默认的 'category' 分类,而不是 'pdf_cat'
foreach( $categories as $category ){
    echo '<option><a class="ctg" href="'. get_category_link( $category->term_id ) .' ">' . $category->name . '</a></option>';
}
?>
登录后复制

这段代码的问题在于,get_categories()函数忽略了post_type参数,它总是返回默认的category分类。

正确方法:使用 get_terms()

要获取自定义分类法pdf_cat下的所有术语,应使用get_terms()函数,并明确指定taxonomy参数。

<?php
$terms = get_terms([
    'taxonomy'   => 'pdf_cat', // 指定要获取的自定义分类法 slug
    'hide_empty' => false,     // 是否隐藏没有关联文章的术语
    'orderby'    => 'name',    // 按照名称排序
    'order'      => 'ASC',     // 升序排列
]);

if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
    echo '<select>';
    foreach ( $terms as $term ) {
        // 使用 get_term_link() 获取自定义分类法术语的链接
        echo '<option><a class="ctg" href="' . esc_url( get_term_link( $term->term_id, $term->taxonomy ) ) . '">' . esc_html( $term->name ) . '</a></option>';
    }
    echo '</select>';
}
?>
登录后复制

在上述代码中:

  • 'taxonomy' => 'pdf_cat':这是关键,它告诉WordPress我们想要获取pdf_cat分类法下的术语。
  • 'hide_empty' => false:即使某个术语当前没有关联任何pdf文章,也会被显示出来。
  • get_term_link( $term->term_id, $term->taxonomy ):这是获取自定义分类法术语链接的正确函数。它需要术语ID和分类法slug作为参数。

根据自定义分类法术语查询文章

当用户点击某个自定义分类术语的链接后,您可能需要在新页面上显示属于该术语的所有自定义文章类型pdf的文章。同样,这里也存在与默认分类查询混淆的常见错误。

错误示例(应避免):

以下是尝试使用get_the_category()和cat参数来查询自定义文章类型pdf的常见错误方式:

<?php
// 这是一个错误示例,因为 get_the_category() 和 'cat' 参数不适用于自定义分类法
$cat = get_the_category(); // 这将获取当前文章的默认 'category',而不是 'pdf_cat'
$cat = $cat[0];
$catname = get_cat_name($cat->
登录后复制

以上就是WordPress自定义文章类型分类(Taxonomy)的正确获取与查询方法的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号