WordPress自定义文章类型分类（术语）获取指南

// functions.php 中的自定义分类法注册示例
function register_pdf_taxonomy() {
    $labels = array(
        'name'                       => _x( 'PDF分类', 'Taxonomy General Name', 'text_domain' ),
        'singular_name'              => _x( 'PDF分类', 'Taxonomy Singular Name', 'text_domain' ),
        'menu_name'                  => __( 'PDF分类', 'text_domain' ),
        'all_items'                  => __( '所有PDF分类', 'text_domain' ),
        'parent_item'                => __( '父级PDF分类', 'text_domain' ),
        'parent_item_colon'          => __( '父级PDF分类:', 'text_domain' ),
        'new_item_name'              => __( '新PDF分类名称', 'text_domain' ),
        'add_new_item'               => __( '添加新PDF分类', 'text_domain' ),
        'edit_item'                  => __( '编辑PDF分类', 'text_domain' ),
        'update_item'                => __( '更新PDF分类', 'text_domain' ),
        'view_item'                  => __( '查看PDF分类', 'text_domain' ),
        'separate_items_with_commas' => __( '用逗号分隔PDF分类', 'text_domain' ),
        'add_or_remove_items'        => __( '添加或移除PDF分类', 'text_domain' ),
        'choose_from_most_used'      => __( '从常用PDF分类中选择', 'text_domain' ),
        'popular_items'              => __( '热门PDF分类', 'text_domain' ),
        'search_items'               => __( '搜索PDF分类', 'text_domain' ),
        'not_found'                  => __( '未找到', 'text_domain' ),
        'no_terms'                   => __( '无PDF分类', 'text_domain' ),
        'items_list'                 => __( 'PDF分类列表', 'text_domain' ),
        'items_list_navigation'      => __( 'PDF分类列表导航', 'text_domain' ),
    );
    $args = array(
        'labels'                     => $labels,
        'hierarchical'               => true, // 是否分层，类似分类
        'public'                     => true,
        'show_ui'                    => true,
        'show_admin_column'          => true,
        'show_in_nav_menus'          => true,
        'show_tagcloud'              => false,
    );
    register_taxonomy( 'pdf_cat', array( 'pdf' ), $args ); // 将 'pdf_cat' 关联到 'pdf' 文章类型
}
add_action( 'init', 'register_pdf_taxonomy', 0 );

<?php
$args = array(
    'taxonomy'   => 'pdf_cat', // 指定自定义分类法的名称
    'hide_empty' => false,     // 显示所有术语，即使没有关联文章
    'orderby'    => 'name',    // 按名称排序
    'order'      => 'ASC',     // 升序排列
);

$terms = get_terms($args);

if (!empty($terms) && !is_wp_error($terms)) {
    echo '<select name="pdf_category_filter" onchange="location = this.value;">'; // 示例：生成一个下拉菜单
    echo '<option value="">选择一个PDF分类</option>';
    foreach ($terms as $term) {
        // 获取自定义分类法术语的链接
        $term_link = get_term_link($term);
        if (!is_wp_error($term_link)) {
            echo '<option value="' . esc_url($term_link) . '">' . esc_html($term->name) . '</option>';
        }
    }
    echo '</select>';
    /*
    // 如果您想生成列表，可以使用 <ul><li> 结构
    echo '<ul>';
    foreach ($terms as $term) {
        $term_link = get_term_link($term);
        if (!is_wp_error($term_link)) {
            echo '<li><a class="ctg" href="' . esc_url($term_link) . '">' . esc_html($term->name) . '</a></li>';
        }
    }
    echo '</ul>';
    */
} else {
    echo '<p>没有找到任何PDF分类。</p>';
}
?>

<?php
// 假设从URL获取当前选中的分类法术语slug
// 例如：http://yourdomain.com/pdf-category/my-term-slug/
// 或者通过 $_GET['pdf_cat_slug'] 获取
$current_term_slug = get_query_var('term'); // 如果是分类法归档页，可以直接获取
if (empty($current_term_slug)) {
    $current_term_slug = isset($_GET['pdf_cat_slug']) ? sanitize_text_field($_GET['pdf_cat_slug']) : '';
}

$paged = ( get_query_var('paged') ) ? get_query_var('paged') : 1;

$args = array(
    'post_type'      => 'pdf', // 指定自定义文章类型
    'posts_per_page' => 15,
    'paged'          => $paged,
    'tax_query'      => array(
        array(
            'taxonomy' => 'pdf_cat',          // 自定义分类法名称
            'field'    => 'slug',             // 根据术语的slug进行查询
            'terms'    => $current_term_slug, // 要查询的术语slug
        ),
    ),
);

// 如果没有选择特定的分类法术语，则移除 tax_query，显示所有pdf文章
if (empty($current_term_slug)) {
    unset($args['tax_query']);
}

$custom_query = new WP_Query($args);

if ($custom_query->have_posts()) :
    echo '<h2>' . (empty($current_term_slug) ? '所有PDF' : get_term_by('slug', $current_term_slug, 'pdf_cat')->name . '下的PDF') . '</h2>';
    echo '<ul>';
    while ($custom_query->have_posts()) : $custom_query->the_post();
        ?>
        <li>
            <h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
            <?php the_excerpt(); // 显示文章摘要 ?>
        </li>
        <?php
    endwhile;
    echo '</ul>';

    // 分页链接
    echo paginate_links(array(
        'total'     => $custom_query->max_num_pages,
        'current'   => max(1, get_query_var('paged')),
        'format'    => '?paged=%#%',
        'prev_text' => __('&laquo; 上一页'),
        'next_text' => __('下一页 &raquo;'),
    ));

    wp_reset_postdata(); // 重置主查询，避免影响后续查询
else :
    echo '<p>没有找到相关文章。</p>';
endif;
?>