WordPress自定义文章类型:正确获取和筛选自定义分类法术语

胖婷大大_9880

胖婷大大_9880

2025-11-28

802人浏览

原创

WordPress自定义文章类型:正确获取和筛选自定义分类法术语

本教程详细介绍了如何在wordpress中为自定义文章类型获取并显示其关联的自定义分类法术语,以及如何根据这些术语筛选文章。文章强调应使用get_terms()函数替代get_categories()来处理自定义分类法,并利用wp_query的tax_query参数实现精确的文章筛选,同时提供了完整的代码示例和最佳实践。

理解WordPress分类法体系

在WordPress中,"分类"(Category)和"标签"(Tag)是两种内置的分类法(Taxonomy),用于组织文章(Post)。当开发者创建自定义文章类型(Custom Post Type, CPT)时,通常也会为其注册自定义分类法,以实现更灵活的内容组织。例如,如果注册了一个名为pdf的自定义文章类型,并为其注册了一个名为pdf_cat的自定义分类法,那么pdf_cat就是专门用于pdf文章类型的“分类”。

需要明确的是,WordPress核心函数get_categories()专门用于获取默认的category分类法中的术语(terms)。当尝试获取自定义分类法中的术语时,直接使用get_categories()并传入post_type参数是无效的,因为它不会识别自定义分类法。正确的做法是使用get_terms()函数。

根据您在functions.php中的代码片段,您已经为pdf文章类型注册了一个名为pdf_cat的自定义分类法:

$args = array(
    'label' => 'category', // 这里的label只是后台显示,不代表分类法slug
    'public' => true,
    'show_ui' => true,
    'show_in_nav_menus' => true,
    'show_admin_column' => true,
    'hierarchical' => true,
    'query_var' => true
);
register_taxonomy('pdf_cat', 'pdf', $args);

这里的关键是register_taxonomy('pdf_cat', 'pdf', $args);,它定义了自定义分类法的slug为pdf_cat,并将其关联到pdf文章类型。

正确获取自定义分类法中的术语

要获取pdf_cat分类法中的所有术语,应该使用get_terms()函数。此函数允许您指定要查询的分类法slug。

以下是获取并显示pdf_cat分类法中所有术语的示例代码:

AgentGen — HTML to PDF & Image
AgentGen — HTML to PDF & Image

将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……

下载
<?php $args = array(
    'taxonomy'   => 'pdf_cat', // 指定自定义分类法slug
    'hide_empty' => false,    // 是否隐藏没有关联文章的术语
    'orderby'    => 'name',   // 按名称排序
    'order'      => 'ASC',    // 升序
);

$categories = get_terms($args); // 注意这里是get_terms

if (!empty($categories) && !is_wp_error($categories)) {
    echo '<select>'; // 示例:在一个下拉菜单中显示
    foreach ($categories as $category) {
        // 使用get_term_link获取术语链接,并进行URL转义
        $term_link = get_term_link($category);
        if (!is_wp_error($term_link)) {
            echo '<option value="' . esc_attr($category->slug) . '">'; // value可以是slug或ID
            echo '<a class="ctg" href="'%20.%20esc_url(%24term_link)%20.%20'">' . esc_html($category->name) . '</a>';
            echo '</option>';
        }
    }
    echo '</select>';
} else {
    echo '<p>未找到任何PDF分类。</p>';
}
?>

代码解析:

  • 'taxonomy' => 'pdf_cat':这是最关键的参数,它告诉WordPress我们想要获取pdf_cat这个自定义分类法中的术语。
  • 'hide_empty' => false:确保即使没有文章关联到某个分类术语,该术语也能被获取到。
  • get_term_link($category):用于获取特定分类术语的归档页链接。
  • esc_url() 和 esc_html():这是WordPress的安全最佳实践,分别用于转义URL和HTML输出,防止XSS攻击。
  • !is_wp_error($categories):在处理WordPress函数返回值时,总是检查是否返回了WP_Error对象,以增强代码健壮性。

根据自定义分类法术语筛选文章

当需要根据自定义分类法中的某个术语来筛选并显示文章时,不能使用cat参数(该参数仅适用于默认的category分类法),而应该使用WP_Query中的tax_query参数。

以下是如何根据pdf_cat分类法中的特定术语来查询pdf文章类型的示例:

<?php // 假设我们从URL或其他方式获取到当前需要筛选的分类术语
// 例如,如果是在一个自定义分类归档页面,可以通过get_query_var('term')获取slug
// 或者通过get_query_var('taxonomy')获取当前分类法slug
$current_term_slug = get_query_var('term'); // 获取当前分类术语的slug
$taxonomy_slug = 'pdf_cat'; // 你的自定义分类法slug

// 验证并获取分类术语对象
$current_term = null;
if ($current_term_slug) {
    $current_term = get_term_by('slug', $current_term_slug, $taxonomy_slug);
}

if ($current_term && !is_wp_error($current_term)) {
    $paged = get_query_var('paged', 1); // 获取当前页码,用于分页
    $posts_per_page = 15; // 每页显示的文章数量

    $args = array(
        'post_type'      => 'pdf', // 指定自定义文章类型
        'posts_per_page' => $posts_per_page,
        'paged'          => $paged,
        'tax_query'      => array( // 使用tax_query进行分类法筛选
            array(
                'taxonomy' => $taxonomy_slug,          // 指定自定义分类法slug
                'field'    => 'term_id',               // 可以是 'term_id', 'slug', 'name'
                'terms'    => $current_term->term_id,  // 指定要筛选的术语ID
                'operator' => 'IN',                    // 术语匹配操作符
            ),
        ),
        // 'orderby' => 'date', // 可以添加其他查询参数
        // 'order'   => 'DESC',
    );

    $custom_query = new WP_Query($args); // 使用WP_Query进行查询

    if ($custom_query->have_posts()) :
        echo '<h2>' . esc_html($current_term->name) . '分类下的PDF文件</h2>';
        echo '

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php word html wordpress

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
wordpress seo
wordpress seo

WordPress网站SEO优化方法有:1、选择一个SEO友好的主题,具有清晰的代码结构,快速的加载速度和响应式设计;2、使用SEO插件,优化你的标题标签,元描述,关键字,XML站点地图等;3、优化你的内容,内容是SEO优化的核心;4、优化你的网站速度;5、创建友好的URL;6、使用内部链接;7、优化图像;8、使用社交媒体;9、定期更新你的网站;10、监控和分析你的网站等等。

2023.09.18

7035

6

wordpress下载后怎么安装
wordpress下载后怎么安装

安装前准备:确保服务器满足要求、获取安装文件、创建数据库。上传 wordpress 文件。创建数据库和用户。运行安装程序:选择语言、输入数据库信息、网站标题和管理员信息。安装 wordpress。安装后配置:设置永久链接、安装主题、安装插件、创建内容。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.15

7099

6

WordPress插件教程
WordPress插件教程

本专题整理热门WordPress插件资源,涵盖SEO优化、缓存加速、安全防护、表单管理、电商扩展等插件推荐与使用教程。

2026.06.16

338

17

WordPress建站教程大全
WordPress建站教程大全

本专题汇总WordPress教程相关内容,包括WordPress安装教程、建站教程、使用技巧、网站管理经验和实战案例,帮助用户快速掌握WordPress建站与运营方法。

2026.06.16

940

20

WordPress开发教程
WordPress开发教程

本专题提供WordPress开发技术资料,包括主题开发、插件开发、自定义功能开发、API调用及性能优化等内容。

2026.06.16

1098

25

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习