本文介绍如何在woocommerce后台新建订单页面中，为自定义账单字段（如邮箱）动态填充url参数传递的值，并确保该值在页面加载时即可见、可编辑。
本文介绍如何在woocommerce后台新建订单页面中，为自定义账单字段（如邮箱）动态填充url参数传递的值，并确保该值在页面加载时即可见、可编辑。
在WooCommerce后台创建新订单时（/wp-admin/post-new.php?post_type=shop_order），开发者常需根据上下文（例如营销链接中的令牌）预填部分账单信息，以提升运营效率。虽然可通过 woocommerce_admin_billing_fields 钩子添加自定义字段，但默认不支持自动赋值——关键在于为字段数组显式指定 'value' 键。
以下是一个完整、健壮的实现方案：
✅ 正确注册并预填自定义字段
add_filter('woocommerce_admin_billing_fields', 'rt_woocommerce_admin_billing_fields');
function rt_woocommerce_admin_billing_fields($fields) {
// 安全获取 URL 参数：确保 query_var 已注册（见下方注意事项）
$email = get_query_var('email') ?: '';
// 覆盖或新增 billing_email 字段，显式设置 value
$fields['billing_email'] = array(
'label' => __('Email', 'woocommerce'),
'value' => sanitize_email($email), // 强烈建议过滤输入
'show' => true,
'class' => 'short',
'required' => false, // 可选：避免强制校验干扰流程
);
return $fields;
}⚠️ 重要前提：注册自定义 query_var
WooCommerce 默认不识别 email 作为合法查询变量，因此必须提前注册，否则 get_query_var('email') 始终返回空：
add_filter('query_vars', 'rt_register_email_query_var');
function rt_register_email_query_var($vars) {
$vars[] = 'email';
return $vars;
}? 使用示例：带参数的后台链接
生成如下链接供管理员点击使用：
/wp-admin/post-new.php?post_type=shop_order&email=test%40example.com
→ 页面加载后，“Email”字段将自动显示 test@example.com，且仍可手动修改。
? 注意事项与最佳实践
- 安全性优先：始终对 get_query_var() 返回值进行校验与过滤（如 sanitize_email()），防止XSS或脏数据注入；
- 字段复用风险：billing_email 是WooCommerce原生字段，覆盖它可能影响默认行为（如客户匹配逻辑）。若需完全独立字段，建议使用唯一键名（如 billing_custom_email），并配合 woocommerce_process_shop_order_meta 保存；
- 兼容性：该方法适用于 WooCommerce 5.0+，字段结构与 WC_Admin_Meta_Boxes::output_fields() 渲染逻辑一致；
- 调试技巧：临时添加 error_log(print_r($_GET, true)); 可验证URL参数是否成功传递至后台请求。
通过以上配置，您即可实现URL驱动的后台字段智能预填充，兼顾灵活性与安全性，是电商运营自动化的重要基础能力。
