本教程详细阐述了在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="'.%20get_category_link(%20%24category->term_id%20)%20.'%20">' . $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="'%20.%20esc_url(%20get_term_link(%20%24term->term_id,%20%24term->taxonomy%20)%20)%20.%20'">' . 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->
