Question

WooCommerce 的后台订单管理支持搜索功能，要扩展搜索功能，首先要明确它能搜什么，不能搜什么。要知道这个信息，读源代码是最快的方法。我们直接找到 WooCommerce 订单搜索的源代码—— class-wc-order-data-store-cpt.php 文件里的 search_orders() 函数，这就是搜索调用的函数。

订单搜索的 SQL 语句

订单搜索会查找两个数据表—— wp_postmeta 和 wp_woocommerce_order_items 表，假设搜索“Flat rate”，SQL 语句如下：

SELECT DISTINCT p1.post_id
FROM wp_postmeta p1
WHERE p1.meta_value LIKE '%Flat rate%'
AND p1.meta_key IN ('_billing_address_index','_shipping_address_index','_billing_last_name','_billing_email')

SELECT order_id
FROM wp_woocommerce_order_items as order_items
WHERE order_item_name LIKE '%Flat rate%'

这两条 SQL 的查询结果最后被合并到一起作为搜索结果。

订单搜索可以搜什么

可以搜索所有的 Order Items 以及用户姓名和地址信息，具体来说：

• 订单 ID
• 订单备注（用户下单时填写的备注）
• 姓名
• 国家
• 城市
• 州/省
• 具体地址
• 邮编
• 电子邮件地址
• 电话
• 产品名称
• 附加费名称
• 快递名称
• 优惠码名称
• 税费名称

搜索对大小写不敏感。

订单搜索不能搜什么

• 支付方式
• Order Key
• 有退款的订单
• 自定义字段等等

扩展订单搜索功能

例如，让订单搜索支持自定义字段和支付方式，代码如下：

function sola_extend_woocommerce_order_search( $search_fields ) {

  $search_fields[] = '_payment_method_title';
  $search_fields[] = '_custom_field_key';

  return $search_fields;
}
add_filter( 'woocommerce_shop_order_search_fields', 'sola_extend_woocommerce_order_search' );

根据退款原因搜索订单

function sola_woocommerce_order_search_refund( $order_ids, $term ){

  global $wpdb;

  $search_fields = array( '_refund_reason' );
  $like = '%' . $wpdb->esc_like( wc_clean( $term ) ) . '%';
  $sql = "SELECT DISTINCT p1.post_parent FROM {$wpdb->posts} p1
  LEFT JOIN {$wpdb->postmeta} p2 ON p1.ID = p2.post_id
  WHERE p2.meta_value LIKE %s AND p2.meta_key IN ('" . implode( "','", array_map( 'esc_sql', $search_fields ) ) . "')";

  $refund_ids = $wpdb->get_col( $wpdb->prepare( $sql, $like ));
  $order_ids = array_unique( array_merge( $order_ids, $refund_ids ) );

  return $order_ids;   
}
add_filter( 'woocommerce_shop_order_search_results', 'sola_woocommerce_order_search_refund',10, 2 );