WordPress自定义文章类型：通过自定义分类法实现高效内容筛选

<?php
/**
 * 注册自定义分类法 'pdf_cat'
 */
function register_pdf_category_taxonomy() {
    // 定义分类法的标签，用于后台界面显示
    $labels = array(
        'name'                       => _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' );
?>

<?php
/**
 * 获取并展示 'pdf_cat' 分类法的所有术语
 */
$categories = get_terms([
    'taxonomy'   => 'pdf_cat',    // 指定要获取的自定义分类法
    'hide_empty' => false,        // 设置为 false 以显示所有分类，包括当前没有关联文章的分类
    'orderby'    => 'name',       // 按名称排序
    'order'      => 'ASC',        // 升序排列
]);

if ( ! empty( $categories ) && ! is_wp_error( $categories ) ) {
    echo '<div class="pdf-category-filter">';
    echo '<label for="pdf_category_select">选择PDF分类:</label>';
    echo '<select id="pdf_category_select" onchange="window.location.href=this.value">';
    echo '<option value="">所有分类</option>'; // 添加一个“所有分类”选项

    foreach ( $categories as $category ) {
        // 构建分类术语的链接
        $term_link = get_term_link( $category );
        if ( ! is_wp_error( $term_link ) ) {
            // 输出选项，其值为分类术语的URL
            echo '<option value="' . esc_url( $term_link ) . '">' . esc_html( $category->name ) . '</option>';
        }
    }
    echo '</select>';
    echo '</div>';
}
?>

<?php
/**
 * 实现自定义文章类型 'pdf' 的内容筛选
 */

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

// 示例：从当前分类法归档页或URL参数获取分类ID
$current_cat_id = 0;
if ( is_tax( 'pdf_cat' ) ) {
    // 如果当前页面是 'pdf_cat' 分类法的归档页
    $queried_object = get_queried_object();
    $current_cat_id = $queried_object->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();
        ?>
        <div class="pdf-item">
            <h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
            <p><?php the_excerpt(); ?></p>
            <?php
            // 显示文章关联的 'pdf_cat' 分类
            $terms = get_the_terms( get_the_ID(), 'pdf_cat' );
            if ( $terms && ! is_wp_error( $terms ) ) :
                echo '<p>分类: ';
                $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 );
                echo '</p>';
            endif;
            ?>
        </div>
        <?php
    endwhile;

    // 显示分页链接
    echo '<div class="pagination">';
    echo paginate_links( array(
        'total'   => $pdf_query->max_num_pages,
        'current' => $paged,
        'format'  => '?paged=%#%', // 针对非分类归档页的URL格式
        'prev_text' => '&laquo; 上一页',
        'next_text' => '下一页 &raquo;',
    ) );
    echo '</div>';

    wp_reset_postdata(); // 重置全局文章数据，恢复主查询
else :
    echo '<p>没有找到符合条件的PDF文档。</p>';
endif;
?>