如何让WP_Query按匹配的meta_query OR子句对结果排序？

需求：当使用relation为OR的meta_query时，希望将匹配status为Completed的结果排在最后，同时让其他状态（包括未在查询中列出的状态）的结果优先显示。当前的查询参数示例如下：

$args = [
   ...
   'meta_query' => [
      'relation' => 'OR',
      'clause_one' => [
         'key' => 'status',
         'compare' => 'IN',
         'value' => ['Registered', 'Pretested']
      ],
      'clause_two' => [
         'key' => 'status',
         'value' => 'Completed',
      ]
   ],
];

方法1：用自定义排序过滤器实现（推荐） #

最灵活的方式是通过posts_orderby过滤器直接修改SQL的排序逻辑，精准控制Completed状态的排序优先级：

// 添加排序过滤器
add_filter('posts_orderby', 'custom_status_sort_order');

// 执行查询
$query = new WP_Query($args);

// 用完立刻移除过滤器，避免干扰后续查询
remove_filter('posts_orderby', 'custom_status_sort_order');

// 自定义排序函数
function custom_status_sort_order($orderby) {
    global $wpdb;
    // 用CASE语句给不同状态分配排序权重：Completed权重为2，其他为1
    // 升序排列后，权重1的结果会排在前面，Completed自然就到最后了
    return "CASE WHEN {$wpdb->postmeta}.meta_value = 'Completed' THEN 2 ELSE 1 END ASC, {$orderby}";
}

补充说明： #

• 如果原本查询有自己的排序规则（比如按发布日期），上面的代码会在自定义排序之后保留原规则，你可以根据需求调整顺序。
• 如果存在没有status元字段的文章，需要在CASE里加额外判断，比如WHEN {$wpdb->postmeta}.meta_key IS NULL THEN 1，确保这类文章也排在Completed前面。

方法2：扩展meta_query并指定子句排序优先级 #

如果你想严格按照匹配的子句来排序（比如先显示其他未列出的状态，再显示Registered/Pretested，最后是Completed），可以扩展meta_query的子句，然后在orderby里指定优先级：

$args = [
   ...
   'meta_query' => [
      'relation' => 'OR',
      // 匹配未列出的其他状态
      'clause_other' => [
         'key' => 'status',
         'compare' => 'NOT IN',
         'value' => ['Registered', 'Pretested', 'Completed'],
         'type' => 'CHAR'
      ],
      // 匹配Registered/Pretested
      'clause_one' => [
         'key' => 'status',
         'compare' => 'IN',
         'value' => ['Registered', 'Pretested'],
         'type' => 'CHAR'
      ],
      // 匹配Completed
      'clause_two' => [
         'key' => 'status',
         'value' => 'Completed',
         'compare' => '=',
         'type' => 'CHAR'
      ]
   ],
   // 指定排序优先级：clause_other > clause_one > clause_two
   'orderby' => [
      'clause_other' => 'ASC',
      'clause_one' => 'ASC',
      'clause_two' => 'ASC'
   ]
];

补充说明： #

• 这种方法需要把所有可能的状态都覆盖到meta_query的子句里，否则未匹配的文章可能不会按预期排序。
• 如果不需要区分其他状态和Registered/Pretested，可以去掉clause_other，直接把clause_one的优先级设为高于clause_two。

内容的提问来源于stack exchange，提问作者christian