本教程详细介绍了如何在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分类法中所有术语的示例代码：
<?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="' . esc_url($term_link) . '">' . 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 '<ul>';
while ($custom_query->have_posts()) : $custom_query->the_post();
echo '<li><a href="' . esc_url(get_permalink()) . '">' . esc_html(get_the_title()) . '</a> 
