WordPress 自定义文章类型按标签筛选显示教程-php教程

本文详解如何在 wordpress 中正确使用 `wp_query` 或 `get_posts()` 按自定义分类法(taxonomy)的标签(term)筛选自定义文章类型(cpt),重点解决因大小写、注册名称与查询名称不一致导致的查询失败问题。

在 WordPress 开发中,通过标签(term)筛选自定义文章类型(Custom Post Type, CPT)是常见需求,但极易因术语命名规范问题导致查询无结果。例如,你注册了一个名为 Reviews 的自定义文章类型,并为其关联了一个自定义分类法(taxonomy)gametypes(注意:注册时通常使用小写、无空格、无大写字母的机器名),并在其中创建了 slug 为 newest 的标签。此时若在查询中错误地使用 ‘Gametypes’(首字母大写)或 ‘Newest’(错误 slug),tax_query 将无法匹配,返回空数组。

✅ 正确做法是:严格使用注册时定义的 taxonomy 机器名(slug)和 term 的实际 slug(非名称 name)。WordPress 分类法 slug 默认全部小写、连字符分隔,且对大小写敏感。即使后台显示“Gametypes”,其真实注册名极大概率是 gametypes;同理,“Newest” 标签的 slug 很可能是 newest(除非手动修改过)。

以下为推荐的完整查询代码(兼容 WP_Query 和 get_posts):

$args = array(
'post_type' => 'reviews', // ✅ CPT 机器名:小写、无空格(注册时定义的)
'posts_per_page' => 6, // 推荐用 'posts_per_page' 替代已弃用的 'numberposts'
'post_status' => 'publish', // 显式指定状态,避免草稿/私密文章混入
'orderby' => 'date',
'order' => 'DESC',
'tax_query' => array(
array(
'taxonomy' => 'gametypes', // ✅ 必须与 register_taxonomy() 中第一个参数完全一致(小写)
'field' => 'slug', // 推荐用 'slug'(稳定);也可用 'term_id' 或 'name'(需注意编码/多语言风险)
'terms' => 'newest', // ✅ 对应后台该分类法下标签的 URL slug(非中文名或标题)
),
),
);

// 方式一:使用 WP_Query(推荐用于主循环,支持分页、钩子等)
$review_query = new WP_Query( $args );
if ( $review_query->have_posts() ) {
while ( $review_query->have_posts() ) {
$review_query->the_post();
echo '

' . get_the_title() . '

';
echo '

' . wp_trim_words( get_the_excerpt(), 20 ) . '

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » WordPress 自定义文章类型按标签筛选显示教程-php教程
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4027557+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4027557+
  • 本周更新: 0+
  • 最后更新: 2026-03-16