WordPress Query Loop 区块进阶：自定义查询、筛选与变体

一句话结论

WordPress 的 Query Loop 区块不只是「列出最新文章」那么简单：通过注册区块变体（block variation）、用 query_loop_block_query_vars 过滤器注入自定义 WP_Query 参数，以及配合自定义文章类型，你可以不写一整个区块就实现「按评分筛选的书评网格」「按活动日期排序的事件列表」这类动态查询。本文用三段最小可用代码讲清进阶玩法。

一、 Query Loop 区块能查什么

Query Loop（core/query）本质是把 WP_Query 包装成可视化区块。它的 query 属性已经支持分类、标签、作者、排序、每页数量等参数。但有些需求核心区块面板没有暴露，比如「按自定义字段排序」「只显示未来活动」——这时候要借助过滤器。

二、用区块变体做「开箱即用」的预设

如果你做了一个「书评」自定义文章类型，每次插入 Query Loop 都要手动切到 book 类型很烦。注册一个变体，让它默认就查 book：

const MY_VARIATION = 'my-plugin/books-list';
registerBlockVariation( 'core/query', {
  name: MY_VARIATION,
  title: 'Books List',
  description: 'Displays a list of books',
  isActive: ( { namespace, query } ) =>
    namespace === MY_VARIATION && query.postType === 'book',
  attributes: {
    namespace: MY_VARIATION,
    query: { postType: 'book', perPage: 6, order: 'desc', orderBy: 'date', inherit: false },
  },
  scope: [ 'inserter' ],
} );

这样用户在插入器里看到的就是一个像独立区块一样的「 Books List 」，点一下就能用，无需懂 query 是什么。

三、用过滤器注入自定义查询

想「只显示未来活动、且按活动日期排序」，核心区块面板没有这个开关。用 query_loop_block_query_vars 钩子注入 meta 查询：

add_filter( 'query_loop_block_query_vars', 'wpdocs_filter_query' );
function wpdocs_filter_query( $query ) {
  if ( 'wpdocs_event' !== $query['post_type'] ) {
    return $query;
  }
  $query['meta_key']     = 'eventDate';
  $query['meta_value']   = date( 'Y-m-d' );
  $query['meta_compare'] = '>=';
  if ( 'date' === $query['orderby'] ) {
    $query['orderby'] = 'meta_value';
  }
  return $query;
}

四、进阶能力对照

相关阅读

• WordPress 区块绑定（Block Bindings）：不写自定义区块也能接动态数据
• WordPress 区块方案（Block Patterns）实战
• WordPress 自定义文章类型从零注册
• WordPress 构建你的第一个区块