WooCommerce后台订单页面按元数据筛选可用下载文件的实现问题

Hey，我刚好碰到过类似的需求，咱们一步步来解决这个问题：

首先，要搞定后台订单页面的下载文件筛选，核心是找到控制后台下载列表渲染的钩子，以及正确获取用户下单时选中的选项数组。

1. 先获取用户选中的选项数组 #

你已经在前端和邮件里实现了筛选，说明用户的选中选项已经存在订单或订单项目的元数据里了。这类数据一般存在订单项目元数据中（毕竟每个商品可能有不同的选项），用wc_get_order_item_meta就能拿到：

// 把selected_options替换成你实际存储选项的元键
$selected_options = wc_get_order_item_meta( $item->get_id(), 'selected_options', true );

如果你的选项是存在订单级别的元数据里（比如整个订单共用同一个选项），那就要从订单对象里取：

$order = $item->get_order();
$selected_options = $order->get_meta( 'selected_options', true );

2. 用正确钩子过滤后台下载列表 #

控制后台订单页面下载项显示的关键钩子是woocommerce_order_item_downloads，它会在后台渲染每个订单项目的下载列表时触发，我们可以通过它过滤掉不符合条件的文件。

给你一段完整的示例代码，直接放到主题的functions.php或者自定义插件里就行：

add_filter( 'woocommerce_order_item_downloads', 'filter_admin_order_downloads_by_user_options', 10, 2 );
function filter_admin_order_downloads_by_user_options( $downloads, $item ) {
    // 只在后台执行，避免干扰前端和邮件的现有逻辑
    if ( ! is_admin() ) {
        return $downloads;
    }

    // 获取用户下单时选中的选项数组
    // 记得把selected_options替换成你实际用的元键
    $selected_options = wc_get_order_item_meta( $item->get_id(), 'selected_options', true );

    // 如果没有选项数据，直接返回原下载列表
    if ( empty( $selected_options ) || ! is_array( $selected_options ) ) {
        return $downloads;
    }

    // 过滤下载文件：只保留文件名包含选中选项的文件
    $filtered_downloads = array();
    foreach ( $downloads as $download ) {
        // 从完整文件链接里提取文件名
        $file_name = basename( $download['file'] );
        
        // 遍历选项数组，检查文件名是否匹配
        foreach ( $selected_options as $option ) {
            // 这里用strpos判断文件名是否包含选项字符串，你也可以改成精确匹配
            if ( strpos( $file_name, $option ) !== false ) {
                $filtered_downloads[] = $download;
                break; // 找到匹配项就跳出循环，避免重复添加
            }
        }
    }

    return $filtered_downloads;
}

3. 几个注意点 #

• 一定要把代码里的selected_options替换成你实际存储选项的元键，要和前端/邮件处理时用的保持一致；
• 如果你的匹配逻辑不是“文件名包含选项字符串”，可以把strpos改成你需要的判断方式（比如===精确匹配）；
• 测试前记得清空缓存，确保代码生效。

这样修改后，后台订单页面的下载列表就会和前端、邮件一样，只显示符合用户选中选项的文件啦！

备注：内容来源于stack exchange，提问作者ilariaroglieri