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分类法中所有术语的示例代码：

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

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

if (!empty($categories) && !is_wp_error($categories)) {
    echo ''; // 示例：在一个下拉菜单中显示
    foreach ($categories as $category) {
        // 使用get_term_link获取术语链接，并进行URL转义
        $term_link = get_term_link($category);
        if (!is_wp_error($term_link)) {
            echo ''; // value可以是slug或ID
            echo '' . esc_html($category->name) . '';
            echo '';
        }
    }
    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()) . '