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

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' );

<?php
$categories = get_terms([
    'taxonomy'   => 'pdf_cat',
    'hide_empty' => false, // 显示即使没有文章的分类
]);

if (!empty($categories) && !is_wp_error($categories)) {
    echo '<div class="pdf-filter-options">';
    echo '<h3>按分类筛选PDF:</h3>';
    echo '<ul>';
    // 添加一个“所有PDF”的选项，链接到PDF文章类型归档页
    echo '<li><a href="' . esc_url( get_post_type_archive_link('pdf') ) . '">所有PDF</a></li>';
    foreach ($categories as $category) {
        // 生成每个分类的链接，通常链接到该分类的归档页
        // 或者，如果是在自定义页面进行筛选，可以添加一个查询参数
        echo '<li><a href="' . esc_url( add_query_arg('pdf_cat_id', $category->term_id, get_permalink()) ) . '">' . esc_html($category->name) . '</a></li>';
    }
    echo '</ul>';
    echo '</div>';
}
?>

<?php
// 获取当前页码，用于分页
$paged = get_query_var('paged', 1);

// 从URL参数中获取选定的分类ID，并进行安全检查
$selected_cat_id = isset($_GET['pdf_cat_id']) ? intval($_GET['pdf_cat_id']) : 0;

$args = array(
    'post_type'   => '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();
        ?>
        <div class="pdf-item">
            <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
            <?php the_excerpt(); // 显示文章摘要 ?>
            <p>分类:
                <?php
                $terms = get_the_terms(get_the_ID(), 'pdf_cat');
                if ($terms && !is_wp_error($terms)) {
                    $term_names = array();
                    foreach ($terms as $term) {
                        $term_names[] = '<a href="' . esc_url(get_term_link($term)) . '">' . esc_html($term->name) . '</a>';
                    }
                    echo implode(', ', $term_names);
                }
                ?>
            </p>
        </div>
        <?php
    endwhile;

    // 显示分页导航
    echo '<div class="pagination">';
    echo paginate_links(array(
        'total'   => $pdf_query->max_num_pages,
        'current' => max(1, $paged),
        'format'  => '?paged=%#%',
        'prev_text' => '&laquo; 上一页',
        'next_text' => '下一页 &raquo;',
    ));
    echo '</div>';

    // 重置文章数据，以防影响主查询
    wp_reset_postdata();

} else {
    echo '<p>没有找到相关PDF。</p>';
}
?>