在 WooCommerce 后台订单列表中，我们可以按照订单状态、订单日期、订单客户来筛选订单，有些情况下，按照 WooCommerce 订单的自定义字段来筛选订单是很有必要的，本文我将带大家了解一下怎么为 WooCommerce 后台订单列表添加按自定义字段来过滤订单的功能，完成后的效果图如下：
第一步
在订单筛选表单中添加一个自定义字段下拉输入
在这一步中，我们使用 woocommerce_order_list_table_restrict_manage_orders 和 restrict_manage_posts 这两个 Hook，第一个是针对高性能存储数据类型的订单，第二个是针对自定义文章类型数据类型的订单。两个 Hook 的参数是一样的，所以我们可以把一个函数同时挂载到这两个 Hook 上面。
- <?php
- add_action( 'woocommerce_order_list_table_restrict_manage_orders', 'wprs_order_filter', 25, 2 );
- add_action( 'restrict_manage_posts', 'wprs_order_filter', 25, 2 );
- function wprs_order_filter( $post_type, $which ) {
- if( 'shop_order' !== $post_type ) {
- return;
- }
- $rudr_custom_field = isset( $_GET[ 'rudr_custom_field' ] ) ? $_GET[ 'rudr_custom_field' ] : '';
- ?>
- <select name="rudr_custom_field">
- <option value="">Custom field</option>
- <option value="value-1"<?php selected( $rudr_custom_field, 'value-1' ) ?>>Value 1</option>
- <option value="value-2"<?php selected( $rudr_custom_field, 'value-2' ) ?>>Value 2</option>
- </select>
- <?php
- }
第二步
添加订单筛选逻辑到订单查询过程中
通过前面的两个 Hook，我们把自定义字段字段筛选输入添加到了订单过滤表单中，这一步，我们需要添加订单筛选逻辑到订单查询过程中，来实现订单筛选。
这一步，我们也需要使用两个 Hook：
woocommerce_order_data_store_cpt_get_orders_query：用来筛选高性能数据类型的订单。
pre_get_posts：用来筛选文章类型数据的订单。
第一个 Hook 示例
- add_action( 'woocommerce_order_list_table_prepare_items_query_args', function( $query_args ) {
- if( isset( $_GET[ 'wprs_custom_field' ] ) && $_GET[ 'wprs_custom_field' ] ) {
- $query_args[ 'meta_query' ] = array(
- array(
- 'key' => 'wprs_custom_field',
- 'value' => $_GET[ 'wprs_custom_field' ],
- )
- );
- }
- return $query_args;
- } );
第二个 Hook 示例
- add_action( 'pre_get_posts', function( $query ) {
- if( ! is_admin() ) {
- return;
- }
- global $pagenow;
- // 如果不是订单列表页面，跳过后面的步骤，直接返回
- if( 'edit.php' !== $pagenow || 'shop_order' !== $query->get( 'post_type' ) ) {
- return;
- }
- if( isset( $_GET[ 'wprs_custom_field' ] ) && $_GET[ 'wprs_custom_field' ] ) {
- // 第一种写法
- // $query->set( 'meta_key', 'wprs_custom_field' );
- // $query->set( 'meta_value', $_GET[ 'wprs_custom_field' ] );
- $query->set( 'meta_query', array(
- array(
- 'key' => 'wprs_custom_field',
- 'value' => $_GET[ 'wprs_custom_field' ],
- )
- ) );
- }
- } );
完成了这一步，我们就实现了一个完整的按自定义筛选 WooCommerce 订单的功能，由于目前流行的 WooCommerce 版本同时支持文章类型数据的订单和高性能存储数据类型的订单，实现这个功能时，我们需要同时支持这两种数据类型，来实现此功能最大的兼容性。
完成了这一步，我们就实现了一个完整的按自定义筛选 WooCommerce 订单的功能，由于目前流行的 WooCommerce 版本同时支持文章类型数据的订单和高性能存储数据类型的订单，实现这个功能时，我们需要同时支持这两种数据类型，来实现此功能最大的兼容性。
如果需要筛选的自定义字段数据选项比较多，放到下拉选择里面用户体验可能不会太好，我们还可以考虑使用订单搜索的功能来实现，请参考本站之前的文章：允许用户在 WooCommerce 中通过搜索订单备注过滤订单。
