WordPress自定义文章类型与分类法高效筛选指南

本文旨在深入探讨如何在wordpress中利用自定义文章类型（custom post type）和自定义分类法（custom taxonomy）实现内容的精准筛选。我们将从分类法的注册开始，逐步讲解如何展示分类选项，并重点介绍如何使用`wp_query`结合`tax_query`参数来根据选定的分类法术语（term）过滤自定义文章，确保内容展示的灵活性与准确性。

在WordPress中，自定义文章类型和自定义分类法是构建复杂内容结构的关键工具。它们允许开发者超越默认的文章和页面，创建更符合特定业务需求的内容模型。当内容结构变得复杂时，如何有效地筛选和展示这些内容就成为了一个核心问题。

1. 注册自定义分类法

首先，我们需要为自定义文章类型（例如这里的pdf）注册一个自定义分类法（例如pdf_cat）。这通常在主题的functions.php文件或自定义插件中完成。

function register_pdf_taxonomy() {
    $labels = array(
        'name'              => _x( 'PDF分类', 'taxonomy general name', 'your-text-domain' ),
        'singular_name'     => _x( 'PDF分类', 'taxonomy singular name', 'your-text-domain' ),
        'search_items'      => __( '搜索PDF分类', 'your-text-domain' ),
        'all_items'         => __( '所有PDF分类', 'your-text-domain' ),
        'parent_item'       => __( '父级PDF分类', 'your-text-domain' ),
        'parent_item_colon' => __( '父级PDF分类:', 'your-text-domain' ),
        'edit_item'         => __( '编辑PDF分类', 'your-text-domain' ),
        'update_item'       => __( '更新PDF分类', 'your-text-domain' ),
        'add_new_item'      => __( '添加新PDF分类', 'your-text-domain' ),
        'new_item_name'     => __( '新PDF分类名称', 'your-text-domain' ),
        'menu_name'         => __( 'PDF分类', 'your-text-domain' ),
    );

    $args = array(
        'labels'             => $labels,
        'public'             => true,
        'hierarchical'       => true, // 设置为层级分类，类似文章分类
        'show_ui'            => true,
        'show_admin_column'  => true,
        'query_var'          => true,
        'rewrite'            => array( 'slug' => 'pdf-category' ), // 定义分类法在URL中的别名
    );

    // 将 'pdf_cat' 分类法注册到 'pdf' 自定义文章类型
    register_taxonomy( 'pdf_cat', array( 'pdf' ), $args );
}
add_action( 'init', 'register_pdf_taxonomy' );

这段代码定义了一个名为pdf_cat的自定义分类法，并将其关联到名为pdf的自定义文章类型。hierarchical设置为true使其行为类似于WordPress的默认分类（Category），支持层级结构。

2. 展示分类法选项以供筛选

为了让用户能够选择分类进行筛选，我们需要在前端页面展示pdf_cat分类法下的所有术语（Term）。通常，这会以链接列表或下拉菜单的形式呈现。

以下代码示例展示了如何获取并展示pdf_cat下的所有术语，生成可点击的筛选链接：

 'pdf_cat',
    'hide_empty' => false, // 显示即使没有文章的分类
]);

if (!empty($categories) && !is_wp_error($categories)) {
    echo '
';
    echo '
按分类筛选PDF:
';
    echo '
';
    // 添加一个“所有PDF”的选项，链接到PDF文章类型归档页
    echo '
所有PDF
';
    foreach ($categories as $category) {
        // 生成每个分类的链接，通常链接到该分类的归档页
        // 或者，如果是在自定义页面进行筛选，可以添加一个查询参数
        echo '
' . esc_html($category->name) . '
';
    }
    echo '
';
    echo '
';
}
?>

在这个示例中，我们为每个分类生成了一个链接。点击这些链接时，会将当前分类的term_id作为pdf_cat_id参数添加到当前页面的URL中（例如：yourdomain.com/your-page/?pdf_cat_id=123）。这种方式适用于在自定义页面上实现筛选逻辑。

VisualizeAI

用AI把你的想法变成现实

下载

3. 实现自定义文章类型按分类法筛选

核心的筛选逻辑在于使用WP_Query类配合tax_query参数。tax_query允许我们根据一个或多个分类法来过滤文章。

假设我们通过URL参数pdf_cat_id获取到用户选择的分类ID，以下是如何构建WP_Query的示例：

 'pdf',         // 指定自定义文章类型为 'pdf'
    'post_status' => 'publish',     // 只获取已发布的文章
    'posts_per_page' => 10,         // 每页显示10篇文章
    'paged'       => $paged,        // 应用分页
);

// 如果存在选定的分类ID，则添加 tax_query 参数
if ($selected_cat_id > 0) {
    $args['tax_query'] = array(
        array(
            'taxonomy' => 'pdf_cat',      // 指定要查询的分类法
            'field'    => 'term_id',      // 指定查询字段，可以是 'term_id', 'slug', 'name'
            'terms'    => $selected_cat_id, // 指定要查询的分类术语ID
        ),
    );
}

// 执行 WP_Query 查询
$pdf_query = new WP_Query($args);

// 循环显示查询结果
if ($pdf_query->have_posts()) {
    while ($pdf_query->have_posts()) : $pdf_query->the_post();
        ?>
        

            

            
            
分类:
                ' . esc_html($term->name) . '';
                    }
                    echo implode(', ', $term_names);
                }
                ?>
            
        
        ';
    echo paginate_links(array(
        'total'   => $pdf_query->max_num_pages,
        'current' => max(1, $paged),
        'format'  => '?paged=%#%',
        'prev_text' => '« 上一页',
        'next_text' => '下一页 »',
    ));
    echo '