WordPress自定义文章类型如何通过自定义分类法进行筛选

wordpress自定义文章类型如何通过自定义分类法进行筛选

本文详细介绍了在WordPress中如何正确地通过自定义分类法（Custom Taxonomy）来筛选自定义文章类型（Custom Post Type）。文章从注册自定义分类法、显示分类选项入手，重点阐述了使用`WP_Query`结合`tax_query`参数进行精确内容筛选的方法，纠正了误用标准分类筛选机制的常见错误，并提供了完整的代码示例及注意事项，旨在帮助开发者高效管理和展示定制化内容。

在WordPress开发中，自定义文章类型（Custom Post Type）和自定义分类法（Custom Taxonomy）是构建复杂网站不可或缺的工具。它们允许开发者超越默认的文章和分类功能，创建高度定制化的内容结构。然而，许多初学者在尝试根据自定义分类法筛选自定义文章类型时，常常会遇到困惑，尤其是在错误地沿用标准文章分类的筛选方法时。本文将深入探讨如何在WordPress中正确且高效地实现这一目标。

注册自定义分类法

首先，我们需要为自定义文章类型注册一个自定义分类法。这通常在主题的functions.php文件或自定义插件中完成。以下代码示例展示了如何为名为pdf的自定义文章类型注册一个名为pdf_cat的自定义分类法：

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' ),
        'popular_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' ),
        'separate_items_with_commas' => __( '使用逗号分隔 PDF 分类', 'your-text-domain' ),
        'add_or_remove_items'        => __( '添加或删除 PDF 分类', 'your-text-domain' ),
        'choose_from_most_used'      => __( '从最常用的 PDF 分类中选择', 'your-text-domain' ),
        'not_found'                  => __( '未找到 PDF 分类', 'your-text-domain' ),
        'menu_name'                  => __( 'PDF 分类', 'your-text-domain' ),
    );

    $args = array(
        'labels'             => $labels,
        'public'             => true,
        'show_ui'            => true,
        'show_in_n*_menus'  => true,
        'show_admin_column'  => true,
        'hierarchical'       => true, // 设置为 true 允许像分类目录一样有层级
        'query_var'          => true,
        'rewrite'            => array( 'slug' => 'pdf-category' ), // 自定义 URL slug
    );
    register_taxonomy('pdf_cat', 'pdf', $args);
}
add_action('init', 'register_pdf_taxonomy');

这段代码定义了pdf_cat分类法的各种显示文本（labels），并配置了其行为（args），例如是否公开、是否在管理界面显示、是否支持层级等。

显示自定义分类法选项

在前端页面上，我们通常需要列出所有的自定义分类法术语（terms），以便用户进行选择和筛选。这可以通过get_terms()函数实现。以下代码展示了如何获取并显示pdf_cat下的所有分类选项：

<?php
$args = array(
    'taxonomy'   => 'pdf_cat', // 指定要获取的分类法
    'hide_empty' => false,     // 显示所有分类，包括没有文章的
    'orderby'    => 'name',    // 按名称排序
    'order'      => 'ASC',     // 升序
);
$categories = get_terms($args);

if (!empty($categories) && !is_wp_error($categories)) {
    echo '<select name="pdf_category_filter" onchange="location = this.value;">';
    echo '<option value="">所有 PDF 分类</option>'; // 添加一个“所有”选项

    foreach ($categories as $category) {
        // 构建分类链接，用于筛选
        $link = get_term_link($category->term_id, $category->taxonomy);
        if (!is_wp_error($link)) {
            echo '<option value="' . esc_url($link) . '">' . esc_html($category->name) . '</option>';
        }
    }
    echo '</select>';
}
?>

这里我们使用了get_terms()来获取pdf_cat分类法下的所有术语。get_term_link()函数则用于生成每个分类术语的链接，用户点击这些链接时，可以导航到对应的分类存档页面，从而实现筛选。

正确筛选自定义文章类型：使用 tax_query

这是实现自定义文章类型按自定义分类法筛选的核心部分。许多开发者可能会尝试使用WP_Query的cat参数，但这仅适用于WordPress内置的“分类目录”（category）分类法。对于自定义分类法，我们必须使用tax_query参数。

全诚商城生成HTML 第三版免虚拟目录版

第三版升级内容：1、增加了分类可以自定义分类名称的颜色和粗体显示搜索引擎优化。2、增加了商品搜索引擎优化和相关文章添加3、增加了配套商品的添加4、增加了前台商品列表按照分类、属性、品牌、价格范围进行筛选5、增加了商品的配件功能6、增加了分类的批量删除7、增加了商品扩展属性在前台的显示关闭方式8、增加了商品具体显示页商品编码和打折商品图标显示形式9、增加了最近浏览商品功能10、增加了非会员直接购物

0 查看详情全诚商城生成HTML 第三版免虚拟目录版

tax_query允许我们构建复杂的分类法查询，它接受一个数组，数组中的每个元素代表一个分类法查询条件。

假设我们已经通过URL参数或其他方式获取到了要筛选的分类术语ID（例如，当用户点击了某个分类链接时，URL中可能包含term_id或slug）。以下是使用tax_query来筛选pdf文章类型的正确方法：

<?php
// 假设 $current_category_id 变量包含了当前要筛选的 pdf_cat 分类术语ID
// 这个ID可以通过多种方式获取，例如：
// 1. 从URL参数获取：$current_category_id = isset($_GET['pdf_cat_id']) ? intval($_GET['pdf_cat_id']) : 0;
// 2. 如果在分类存档页面：$current_category_id = get_queried_object_id();
// 3. 如果通过分类 slug 获取：
//    $current_category_slug = get_query_var('term'); // 如果是分类存档页
//    $term = get_term_by('slug', $current_category_slug, 'pdf_cat');
//    $current_category_id = $term ? $term->term_id : 0;

// 为演示，我们假设 $catid 变量已经包含了目标分类的ID
$catid = 0; // 默认值，表示不筛选特定分类
if (is_tax('pdf_cat')) { // 判断是否在pdf_cat的分类存档页
    $queried_object = get_queried_object();
    if ($queried_object instanceof WP_Term && $queried_object->taxonomy === 'pdf_cat') {
        $catid = $queried_object->term_id;
    }
} else if (isset($_GET['pdf_cat_id'])) { // 从URL参数获取
    $catid = intval($_GET['pdf_cat_id']);
}

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

$pdf_args = array(
    'post_type'   => 'pdf',        // 指定自定义文章类型
    'paged'       => $paged,       // 处理分页
    'post_status' => 'publish',    // 只获取已发布的文章
    'posts_per_page' => 15,        // 每页显示15篇文章
);

// 如果 $catid 大于 0，则添加分类法查询条件
if ($catid > 0) {
    $pdf_args['tax_query'] = array(
        array(
            'taxonomy' => 'pdf_cat',      // 指定要查询的自定义分类法
            'field'    => 'term_id',      // 指定查询字段，可以是 'term_id'、'slug' 或 'name'
            'terms'    => $catid,         // 指定要查询的分类术语ID或slug数组
            'operator' => 'IN',           // 操作符，'IN'表示在给定术语中，'NOT IN'表示不在，'AND'表示同时拥有
        ),
    );
}

$pdf_query = new WP_Query($pdf_args);

if ($pdf_query->h*e_posts()) :
    while ($pdf_query->h*e_posts()) : $pdf_query->the_post();
        // 在这里显示文章内容
        ?>
        <div class="pdf-item">
            <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
            <?php the_excerpt(); ?>
            <!-- 其他自定义字段或内容 -->
        </div>
        <?php
    endwhile;

    // 分页链接
    echo paginate_links(array(
        'total'   => $pdf_query->max_num_pages,
        'current' => $paged,
        'prev_text' => __('« 上一页'),
        'next_text' => __('下一页 »'),
    ));

    wp_reset_postdata(); // 重置全局文章数据
else :
    echo '<p>未找到相关 PDF。</p>';
endif;
?>

tax_query 参数详解：

taxonomy: (字符串，必需) 自定义分类法的名称，例如 'pdf_cat'。
field: (字符串，可选) 用于匹配terms数组的字段。可以是'term_id'、'slug'或'name'。默认是'term_id'。
terms: (整数或字符串数组，必需) 要查询的分类术语ID、slug或名称。
operator: (字符串，可选) 如何处理terms数组。
- 'IN' (默认): 帖子必须属于terms数组中的任何一个术语。
- 'NOT IN': 帖子不能属于terms数组中的任何一个术语。
- 'AND': 帖子必须属于terms数组中的所有术语（适用于多选分类）。
include_children: (布尔值，可选) 对于分层分类法，是否包含子分类的帖子。默认是true。

注意事项与最佳实践

避免使用 query_posts(): query_posts()会修改主查询，可能导致意外行为和性能问题。始终使用new WP_Query()来创建自定义查询。
wp_reset_postdata(): 在自定义循环结束后，务必调用wp_reset_postdata()来恢复全局$post变量到主查询的状态，以避免对后续模板标签造成影响。
安全性: 如果分类ID或slug来自用户输入（例如URL参数），请务必进行数据清理和验证（如intval()、sanitize_text_field()），以防止安全漏洞。
性能: 对于大型网站，考虑使用缓存插件来优化数据库查询，减少服务器负载。
URL结构: 为了更好的用户体验和SEO，建议使用漂亮的URL结构。例如，当点击pdf_cat分类时，URL应该是/pdf-category/category-slug/，而不是带有参数的/page/?pdf_cat_id=123。这可以通过在注册分类法时设置rewrite参数，并确保主题正确处理分类存档页面来实现。

总结

通过本文的讲解，您应该已经掌握了在WordPress中通过自定义分类法筛选自定义文章类型的正确方法。关键在于理解并利用WP_Query的tax_query参数，而不是错误地使用针对标准分类的cat参数。遵循这些指导原则和最佳实践，您将能够更灵活、更高效地管理和展示您的WordPress网站内容。

以上就是WordPress自定义文章类型如何通过自定义分类法进行筛选的详细内容，更多请关注php中文网其它相关文章！

# 可选 # 辽宁高级网站建设价格 # 推广网站的自媒体 # 长春seo搜索栏定位 # 青岛seo搜索优化 # 普洱营销推广培训机构 # 淄博网站建设推广 # 上蔡seo关键词公司 # 营销推广的效果评估 # 山阳区网站建设 # 图片推广素材网站推荐 # 任何一个 # 分页 # 相关文章 # 适用于 # 上传 # php # 第三版 # 组中 # 增加了 # 自定义 # 字符串数组 # pdf # ai # 工具 # seo # wordpress # go # 前端 # html # word

返回目录在线咨询

上一篇：PHP中根据嵌套数组项值条件赋值的教程
下一篇：在正则表达式中有效处理非ASCII特殊字符（如‘á’）的最佳实践

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。