请求协助修复WooCommerce订单页中Woo Food插件的自定义状态筛选问题

问题原因 #

Woo Food插件的订单筛选逻辑通常仅默认识别WooCommerce原生订单状态或插件自带状态，未将自定义订单状态纳入筛选器的可选列表。

解决方案 #

方法1：使用WooFood专属钩子添加自定义状态

多数情况下，WooFood提供了筛选订单状态的钩子，直接通过PHP代码将自定义状态注入筛选列表：

// 将自定义订单状态添加到WooFood的筛选器中
add_filter('woofood_order_statuses', 'inject_custom_status_to_woofood');
function inject_custom_status_to_woofood($statuses) {
    // 替换为你的自定义订单状态键名（需以wc-开头）
    $custom_status_key = 'wc-custom-prepared';
    // 获取该状态的显示标签
    $custom_status_label = wc_get_order_status_name($custom_status_key);
    
    // 将自定义状态追加到筛选列表
    $statuses[$custom_status_key] = $custom_status_label;
    
    return $statuses;
}

方法2：兼容WooCommerce全局状态注册（若自定义状态未注册）

如果你的自定义订单状态尚未在WooCommerce中注册，先完成注册再注入筛选器：

// 注册自定义订单状态
add_action('init', 'register_woocommerce_custom_order_status');
function register_woocommerce_custom_order_status() {
    register_post_status('wc-custom-prepared', array(
        'label'                     => '已准备取餐',
        'public'                    => true,
        'exclude_from_search'       => false,
        'show_in_admin_all_list'    => true,
        'show_in_admin_status_list' => true,
        'label_count'               => _n_noop('已准备取餐 <span class="count">(%s)</span>', '已准备取餐 <span class="count">(%s)</span>')
    ));
}

// 把自定义状态添加到WooCommerce全局订单状态列表
add_filter('woocommerce_order_statuses', 'add_custom_status_to_wc_global_list');
function add_custom_status_to_wc_global_list($order_statuses) {
    $updated_statuses = array();
    // 将自定义状态插入到「处理中」状态之后
    foreach ($order_statuses as $key => $label) {
        $updated_statuses[$key] = $label;
        if ($key === 'wc-processing') {
            $updated_statuses['wc-custom-prepared'] = '已准备取餐';
        }
    }
    return $updated_statuses;
}

// 强制WooFood筛选器包含自定义状态
add_filter('woofood_admin_order_filter_statuses', 'add_custom_status_to_woofood_admin');
function add_custom_status_to_woofood_admin($statuses) {
    $statuses['wc-custom-prepared'] = '已准备取餐';
    return $statuses;
}

方法3：JS兜底方案（若插件硬编码状态列表）

如果上述PHP钩子无效，说明插件可能硬编码了筛选状态，可通过后台JS动态添加选项：

// 在订单页加载自定义JS
add_action('admin_enqueue_scripts', 'enqueue_woofood_custom_status_js');
function enqueue_woofood_custom_status_js($hook) {
    // 仅在WooCommerce订单管理页加载
    if ('edit.php' !== $hook || $_GET['post_type'] !== 'shop_order') {
        return;
    }
    wp_add_inline_script('jquery', '
        jQuery(document).ready(function($) {
            // 定位WooFood的状态筛选下拉框
            const $statusSelect = $(\'select#woofood-order-status\');
            if ($statusSelect.length) {
                // 添加自定义状态选项（替换为你的状态键和标签）
                $statusSelect.append(\'<option value="wc-custom-prepared">已准备取餐</option>\');
            }
        });
    ');
}

验证步骤 #

1. 将上述代码添加到当前主题的functions.php文件，或创建一个独立的自定义插件
2. 清空WordPress后台缓存及浏览器缓存
3. 进入WooCommerce订单管理页，检查WooFood筛选栏的状态下拉列表是否包含你的自定义状态
4. 选择自定义状态，确认订单列表能正确过滤出对应状态的订单

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