本教程详细介绍了如何在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分类法中所有术语的示例代码：
'pdf_cat', // 指定自定义分类法slug
'hide_empty' => false, // 是否隐藏没有关联文章的术语
'orderby' => 'name', // 按名称排序
'order' => 'ASC', // 升序
);
$categories = get_terms($args); // 注意这里是get_terms
if (!empty($categories) && !is_wp_error($categories)) {
echo '';
} else {
echo '未找到任何PDF分类。
';
}
?>代码解析：
- '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文章类型的示例：
'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 '' . esc_html($current_term->name) . '分类下的PDF文件
';
echo '- ';
while ($custom_query->have_posts()) : $custom_query->the_post();
echo '
- ' . esc_html(get_the_title()) . '
