首页 > 营销学院 > 技术知识

WordPress自定义文章类型分类（术语）获取指南

本教程将详细指导如何在wordpress中正确获取自定义文章类型的分类，即自定义分类法（custom taxonomy）的术语（terms）。不同于针对内置“分类”的`get_categories()`函数，获取自定义分类法术语需使用`get_terms()`函数，通过指定分类法名称来精确检索，确保内容展示的灵活性与准确性。

理解WordPress分类体系

在WordPress中，内容组织主要通过分类（Categories）和标签（Tags）实现。然而，当处理自定义文章类型（Custom Post Types）时，为了提供更灵活、更贴合业务逻辑的分类方式，WordPress引入了自定义分类法（Custom Taxonomies）。

内置分类与标签： 这些是WordPress默认提供的分类方式，通常用于post文章类型。
- get_categories()函数专门用于获取内置category分类法下的所有术语（即分类）。
自定义分类法： 您可以通过register_taxonomy()函数为自定义文章类型创建自己的分类体系，例如为“产品”文章类型创建“产品类别”分类法。对于这些自定义分类法，get_categories()不再适用。

理解这一区别至关重要，因为错误的函数选择会导致无法获取到期望的数据。

使用get_terms()获取自定义分类法术语

要正确获取自定义文章类型所关联的自定义分类法术语，我们应该使用更通用的get_terms()函数。此函数能够检索WordPress中任何注册的分类法下的术语。

核心参数：

get_terms()函数接受一个参数数组，其中最关键的是'taxonomy'。

'taxonomy'：指定要查询的自定义分类法的名称。例如，如果您的自定义分类法注册时名称为'pdf_cat'，则此处应传入'pdf_cat'。
'hide_empty'：布尔值，默认为true。如果设置为false，即使某个术语下没有关联任何文章，它也会被返回。
'orderby'：排序依据，例如'name'（按名称）、'slug'（按别名）、'count'（按文章数量）等。
'order'：排序顺序，'ASC'（升序）或'DESC'（降序）。

示例代码：获取并显示自定义分类法术语

假设您已在functions.php中注册了一个名为'pdf_cat'的自定义分类法，并将其关联到'pdf'自定义文章类型：

// functions.php 中的自定义分类法注册示例
function register_pdf_taxonomy() {
    $labels = array(
        'name'                       => _x( 'PDF分类', 'Taxonomy General Name', 'text_domain' ),
        'singular_name'              => _x( 'PDF分类', 'Taxonomy Singular Name', 'text_domain' ),
        'menu_name'                  => __( 'PDF分类', 'text_domain' ),
        'all_items'                  => __( '所有PDF分类', 'text_domain' ),
        'parent_item'                => __( '父级PDF分类', 'text_domain' ),
        'parent_item_colon'          => __( '父级PDF分类:', 'text_domain' ),
        'new_item_name'              => __( '新PDF分类名称', 'text_domain' ),
        'add_new_item'               => __( '添加新PDF分类', 'text_domain' ),
        'edit_item'                  => __( '编辑PDF分类', 'text_domain' ),
        'update_item'                => __( '更新PDF分类', 'text_domain' ),
        'view_item'                  => __( '查看PDF分类', 'text_domain' ),
        'separate_items_with_commas' => __( '用逗号分隔PDF分类', 'text_domain' ),
        'add_or_remove_items'        => __( '添加或移除PDF分类', 'text_domain' ),
        'choose_from_most_used'      => __( '从常用PDF分类中选择', 'text_domain' ),
        'popular_items'              => __( '热门PDF分类', 'text_domain' ),
        'search_items'               => __( '搜索PDF分类', 'text_domain' ),
        'not_found'                  => __( '未找到', 'text_domain' ),
        'no_terms'                   => __( '无PDF分类', 'text_domain' ),
        'items_list'                 => __( 'PDF分类列表', 'text_domain' ),
        'items_list_n*igation'      => __( 'PDF分类列表导航', 'text_domain' ),
    );
    $args = array(
        'labels'                     => $labels,
        'hierarchical'               => true, // 是否分层，类似分类
        'public'                     => true,
        'show_ui'                    => true,
        'show_admin_column'          => true,
        'show_in_n*_menus'          => true,
        'show_tagcloud'              => false,
    );
    register_taxonomy( 'pdf_cat', array( 'pdf' ), $args ); // 将 'pdf_cat' 关联到 'pdf' 文章类型
}
add_action( 'init', 'register_pdf_taxonomy', 0 );

现在，在您的页面模板中，可以使用以下代码获取并显示'pdf_cat'分类法下的所有术语：

<?php
$args = array(
    'taxonomy'   => 'pdf_cat', // 指定自定义分类法的名称
    'hide_empty' => false,     // 显示所有术语，即使没有关联文章
    'orderby'    => 'name',    // 按名称排序
    'order'      => 'ASC',     // 升序排列
);

$terms = get_terms($args);

if (!empty($terms) && !is_wp_error($terms)) {
    echo '<select name="pdf_category_filter" onchange="location = this.value;">'; // 示例：生成一个下拉菜单
    echo '<option value="">选择一个PDF分类</option>';
    foreach ($terms as $term) {
        // 获取自定义分类法术语的链接
        $term_link = get_term_link($term);
        if (!is_wp_error($term_link)) {
            echo '<option value="' . esc_url($term_link) . '">' . esc_html($term->name) . '</option>';
        }
    }
    echo '</select>';
    /*
    // 如果您想生成列表，可以使用 <ul><li> 结构
    echo '<ul>';
    foreach ($terms as $term) {
        $term_link = get_term_link($term);
        if (!is_wp_error($term_link)) {
            echo '<li><a class="ctg" href="' . esc_url($term_link) . '">' . esc_html($term->name) . '</a></li>';
        }
    }
    echo '</ul>';
    */
} else {
    echo '<p>没有找到任何PDF分类。</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/2081">
                            <img src="https://img.php.cn/upload/ai_manual/000/000/000/175679957430506.png" alt="NoCode">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/2081">NoCode</a>
                            <p>美团推出的零代码应用生成平台</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="NoCode">
                                <span>180</span>
                            </div>
                        </div>
                        <a href="/ai/2081" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="NoCode">
                        </a>
                    </div>
                ';
}
?>

这段代码首先定义了get_terms()的参数，然后调用该函数获取术语列表。接着，它会遍历这些术语，为每个术语生成一个链接，并将其显示在页面上。get_term_link($term)是获取特定术语URL的正确方式。

结合自定义分类法术语查询文章

获取到自定义分类法术语后，通常的下一步是根据用户选择的术语来筛选和显示相关的自定义文章类型。这可以通过WP_Query配合tax_query参数来实现。

示例代码：根据自定义分类法术语查询文章

假设您已经从URL参数或其他方式获取到了当前选中的自定义分类法术语的slug。

<?php
// 假设从URL获取当前选中的分类法术语slug
// 例如：http://yourdomain.com/pdf-category/my-term-slug/
// 或者通过 $_GET['pdf_cat_slug'] 获取
$current_term_slug = get_query_var('term'); // 如果是分类法归档页，可以直接获取
if (empty($current_term_slug)) {
    $current_term_slug = isset($_GET['pdf_cat_slug']) ? sanitize_text_field($_GET['pdf_cat_slug']) : '';
}

$paged = ( get_query_var('paged') ) ? get_query_var('paged') : 1;

$args = array(
    'post_type'      => 'pdf', // 指定自定义文章类型
    'posts_per_page' => 15,
    'paged'          => $paged,
    'tax_query'      => array(
        array(
            'taxonomy' => 'pdf_cat',          // 自定义分类法名称
            'field'    => 'slug',             // 根据术语的slug进行查询
            'terms'    => $current_term_slug, // 要查询的术语slug
        ),
    ),
);

// 如果没有选择特定的分类法术语，则移除 tax_query，显示所有pdf文章
if (empty($current_term_slug)) {
    unset($args['tax_query']);
}

$custom_query = new WP_Query($args);

if ($custom_query->h*e_posts()) :
    echo '<h2>' . (empty($current_term_slug) ? '所有PDF' : get_term_by('slug', $current_term_slug, 'pdf_cat')->name . '下的PDF') . '</h2>';
    echo '<ul>';
    while ($custom_query->h*e_posts()) : $custom_query->the_post();
        ?>
        <li>
            <h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
            <?php the_excerpt(); // 显示文章摘要 ?>
        </li>
        <?php
    endwhile;
    echo '</ul>';

    // 分页链接
    echo paginate_links(array(
        'total'     => $custom_query->max_num_pages,
        'current'   => max(1, get_query_var('paged')),
        'format'    => '?paged=%#%',
        'prev_text' => __('&laquo; 上一页'),
        'next_text' => __('下一页 &raquo;'),
    ));

    wp_reset_postdata(); // 重置主查询，避免影响后续查询
else :
    echo '<p>没有找到相关文章。</p>';
endif;
?>

这段代码展示了如何使用WP_Query的tax_query参数来构建一个基于自定义分类法术语的查询。tax_query允许您指定分类法名称、查询字段（如slug、term_id）以及要匹配的术语。

注意事项与最佳实践

区分函数： 始终记住get_categories()用于WordPress内置的category分类法，而get_terms()用于所有分类法，包括您自定义的分类法。
分类法名称： 确保get_terms()中的'taxonomy'参数与您register_taxonomy()时定义的分类法名称完全一致。
错误处理： 在处理get_terms()和get_term_link()的返回值时，使用!is_wp_error()进行检查是一个好习惯，可以防止潜在的PHP错误。
WP_Query vs query_posts()： 推荐使用new WP_Query()来创建自定义查询，而不是query_posts()。query_posts()会修改主查询，可能导致不预期的问题，而WP_Query创建的是一个独立的新查询，更安全、更灵活。
wp_reset_postdata()： 在使用WP_Query循环文章后，务必调用wp_reset_postdata()来恢复全局$post变量到主查询的状态，以避免对页面其他部分造成影响。
hide_empty参数： 根据需求决定是否显示没有关联文章的分类法术语。如果希望用户只能看到有内容的分类，请保持'hide_empty' => true（默认值）。

总结

正确获取和利用自定义文章类型的分类（即自定义分类法术语）是构建复杂WordPress网站的关键技能。通过掌握get_terms()函数来检索术语，并结合WP_Query的tax_query参数来筛选文章，您可以为用户提供强大且直观的内容导航体验。遵循本教程中的指导和最佳实践，将确保您的WordPress开发工作更加高效和健壮。

以上就是WordPress自定义文章类型分类（术语）获取指南的详细内容，更多请关注php中文网其它相关文章！

# word # html # go # wordpress # php # 这段 # 厦门网站推广找哪家 # 制度店铺营销推广内容 # 校园电子商务的网站建设 # 没有找到 # 怎么看 # 可以使用 # 相关文章 # 您可以 # 升序 # 的是 # 您的 # 自定义 # 排列 # 区别 # pdf # ai # 恩施绍兴网站推广 # 营销推广方案写什么类型 # 有实力SEO优化价格 # 云南搜索关键词排名推荐 # seo关键词排名艾金手指下拉十九 # 成都网站优化做什么 # 灵宝网站建设与开发

相关栏目：【 Google疑问12 】【 Facebook疑问10 】【优化推广96088 】【技术知识133117 】【 IDC资讯59369 】【网络运营7196 】【 IT资讯61894 】

2025-11-24

SQL多表关联如何理解_核心原理解析助你掌握关键方法【教程】 SQL多表连接如何理解_JOIN关联关系详细步骤解析【指导】 SQL多表连接结果异常怎么办_JOIN条件排查方法解析【指导】 SQL索引下推是什么_ICP机制性能提升原理【教程】 SQL跨表统计怎么写_重要技巧总结提升查询效率【技巧】 SQL注入如何防护_完整逻辑拆解助力系统化掌握【技巧】 SQL上传文件信息建模方法_SQL存储文件元数据方案 SQL多语种存储方案设计_SQL字符集选择策略 SQL字符串处理如何编写_重要技巧总结提升查询效率【教学】 SQL去重查询怎么实现_优化思路讲解帮助高效处理数据【技巧】 SQL统计复购用户怎么做_多次行为分析SQL思路【教程】 SQL字符串处理如何编写_优化思路讲解帮助高效处理数据【教程】 SQL动态字段解析技巧_SQL解析JSON多层字段 SQL线上慢SQL如何治理_规范与工具实践总结【技巧】 SQL表结构如何演进_兼容老数据设计思路【教程】 SQL排序规则如何设置_ORDERBY排序原理与性能说明【指导】 SQL去重查询怎么实现_真实案例解析强化复杂查询思维【教学】 SQL按字段范围分批处理_SQL避免长时间锁表 SQL统计不同字段组合数量_多列聚合查询技巧【技巧】 SQL多字段去重怎么处理_GROUPBY去重思路说明【教学】

了解您产品搜索量及市场趋势，制定营销计划

同行竞争及网站分析保障您的广告效果

点击免费数据支持

提交您的需求，1小时内享受我们的专业解答。

运城市盐湖区信雨科技有限公司

运城市盐湖区信雨科技有限公司是一家深耕海外推广领域十年的专业服务商，作为谷歌推广与Facebook广告全球合作伙伴，聚焦外贸企业出海痛点，以数字化营销为核心，提供一站式海外营销解决方案。公司凭借十年行业沉淀与平台官方资源加持，打破传统外贸获客壁垒，助力企业高效开拓全球市场，成为中小企业出海的可靠合作伙伴。