本文详细介绍了如何在wordpress中为自定义文章类型（custom post type）创建并应用自定义分类法（custom taxonomy），特别是如何利用tax_query参数实现基于分类法的精确内容筛选。教程将涵盖分类法注册、前端筛选选项展示以及后端查询逻辑的构建，旨在帮助开发者构建更灵活、可维护的wordpress内容管理系统。
在WordPress开发中，自定义文章类型（Custom Post Type, CPT）和自定义分类法（Custom Taxonomy）是构建强大内容管理系统的基石。它们允许开发者超越默认的文章和页面结构，创建更符合特定业务需求的内容模型。本文将聚焦于如何为自定义文章类型添加自定义分类法，并实现基于这些分类法的内容筛选功能，确保内容展示的灵活性和准确性。
1. 注册自定义分类法
首先，我们需要为自定义文章类型注册一个自定义分类法。在本例中，我们假设已存在一个名为 pdf 的自定义文章类型，我们将为其创建一个名为 pdf_cat 的分类法。注册分类法的代码通常放置在主题的 functions.php 文件或自定义插件中。
_x( 'PDF 分类', 'taxonomy general name', 'textdomain' ),
'singular_name' => _x( 'PDF 分类', 'taxonomy singular name', 'textdomain' ),
'search_items' => __( '搜索 PDF 分类', 'textdomain' ),
'all_items' => __( '所有 PDF 分类', 'textdomain' ),
'parent_item' => __( '父级 PDF 分类', 'textdomain' ),
'parent_item_colon' => __( '父级 PDF 分类:', 'textdomain' ),
'edit_item' => __( '编辑 PDF 分类', 'textdomain' ),
'update_item' => __( '更新 PDF 分类', 'textdomain' ),
'add_new_item' => __( '添加新 PDF 分类', 'textdomain' ),
'new_item_name' => __( '新 PDF 分类名称', 'textdomain' ),
'menu_name' => __( 'PDF 分类', 'textdomain' ),
);
// 定义分类法的参数
$args = array(
'labels' => $labels, // 使用上面定义的标签
'public' => true, // 分类法是否公开可见
'show_ui' => true, // 是否在WordPress管理界面显示UI
'show_in_nav_menus' => true, // 是否在导航菜单中显示
'show_admin_column' => true, // 是否在文章列表页显示为列
'hierarchical' => true, // 是否具有层级结构（类似分类，而非标签）
'query_var' => true, // 是否允许在查询中使用此分类法
'rewrite' => array( 'slug' => 'pdf-category' ), // 自定义分类法的URL slug
);
// 注册分类法，将其关联到 'pdf' 自定义文章类型
register_taxonomy('pdf_cat', 'pdf', $args);
}
add_action( 'init', 'register_pdf_category_taxonomy' );
?>在上述代码中，register_taxonomy() 函数的第二个参数 'pdf' 指明了 pdf_cat 分类法将应用于 pdf 自定义文章类型。hierarchical 设置为 true 意味着 pdf_cat 将表现得像传统分类一样，支持父子关系。
2. 前端展示分类筛选选项
为了让用户能够选择分类进行筛选，我们需要在前端页面展示这些自定义分类法的术语（terms）。通常，这会通过一个下拉菜单或一组链接来实现。
'pdf_cat', // 指定要获取的自定义分类法
'hide_empty' => false, // 设置为 false 以显示所有分类，包括当前没有关联文章的分类
'orderby' => 'name', // 按名称排序
'order' => 'ASC', // 升序排列
]);
if ( ! empty( $categories ) && ! is_wp_error( $categories ) ) {
echo '';
echo '';
echo '';
echo '';
}
?>这段代码会生成一个下拉菜单。当用户选择一个分类时，onchange 事件会将页面重定向到该分类的归档页（由 get_term_link() 生成），或者你可以自定义URL，例如 /?post_type=pdf&pdf_cat_id=TERM_ID，然后通过URL参数来获取筛选条件。
3. 实现自定义文章类型的内容筛选
现在，我们来实现核心的筛选逻辑。当用户选择一个自定义分类法术语后，我们需要使用 WP_Query 来查询匹配的自定义文章类型。关键在于使用 tax_query 参数，而不是传统的 cat 参数（cat 参数主要用于WordPress的默认分类）。
《领林企业网站管理系统》是针对小型企业网站建站而开发的一套PHP网站系统。该系统适用于只需简单文章(图文)功能模块和单页功能模块，偏重于简洁的文章内容管理的网站。 本版本特性有：· 提供一级文章分类管理模块。· 提供单页、留言板、页面板块划分和系统辅助等功能模块。· 使用Smarty模板引擎，可自定义模板，极大的方便用户设计实现符合
假设我们正在一个页面模板中处理筛选逻辑，并且已经从URL或其他方式获取到了要筛选的分类ID（$cat_id）。
term_id;
} elseif ( isset( $_GET['pdf_cat_id'] ) ) {
// 假设通过URL参数 'pdf_cat_id' 传递分类ID
$current_cat_id = intval( $_GET['pdf_cat_id'] ); // 确保是整数，防止安全问题
}
// 构建 WP_Query 的参数数组
$pdf_args = array(
'post_type' => 'pdf', // 指定要查询的自定义文章类型
'paged' => $paged, // 处理分页
'post_status' => 'publish', // 只查询已发布的文章
'posts_per_page' => 10, // 每页显示的文章数量
'orderby' => 'date', // 按日期排序
'order' => 'DESC', // 降序排列
);
// 如果存在要筛选的分类ID，则添加 tax_query 参数
if ( $current_cat_id ) {
$pdf_args['tax_query'] = array(
array(
'taxonomy' => 'pdf_cat', // 自定义分类法的名称
'field' => 'term_id', // 根据术语的ID进行匹配
'terms' => $current_cat_id, // 要筛选的分类术语ID
'operator' => 'IN', // 匹配包含这些术语的文章
),
);
}
// 执行自定义查询
$pdf_query = new WP_Query( $pdf_args );
// 循环显示查询结果
if ( $pdf_query->have_posts() ) :
while ( $pdf_query->have_posts() ) : $pdf_query->the_post();
?>
分类: ';
$term_names = array();
foreach ( $terms as $term ) {
$term_names[] = '' . esc_html( $term->name ) . '';
}
echo implode( ', ', $term_names );
echo '';
endif;
?>
';
echo paginate_links( array(
'total' => $pdf_query->max_num_pages,
'current' => $paged,
'format' => '?paged=%#%', // 针对非分类归档页的URL格式
'prev_text' => '« 上一页',
'next_text' => '下一页 »',
) );
echo '
