本文介绍如何通过 woocommerce_admin_billing_fields 钩子，在 woocommerce 管理后台“新建订单”页面中，为自定义账单字段（如邮箱）自动填充来自 url 查询参数（如 ?email=test@example.com）的值，并确保该值在表单加载时即可见、可编辑。
本文介绍如何通过 woocommerce_admin_billing_fields 钩子，在 woocommerce 管理后台“新建订单”页面中，为自定义账单字段（如邮箱）自动填充来自 url 查询参数（如 ?email=test@example.com）的值，并确保该值在表单加载时即可见、可编辑。
在 WooCommerce 后台新建订单流程中，有时需根据外部来源（如营销链接、API 调用或内部跳转）预设客户信息，以提升运营效率。例如，管理员点击含 ?email=john@domain.com 的链接进入订单创建页时，希望「账单邮箱」字段已自动填入该值，而非手动输入。
实现的关键在于：不仅注册字段，还需为其指定初始值。WooCommerce 的 woocommerce_admin_billing_fields 过滤器支持通过 'value' 键设置字段默认内容。只需在原有代码中补充 $email 变量并赋值即可：
function rt_woocommerce_admin_billing_fields( $fields ) {
// 从 URL 查询参数获取 email（需确保已注册 query var）
$email = get_query_var('email');
$fields['billing_email'] = array(
'label' => __( 'Email', 'your-textdomain' ),
'value' => $email, // ? 关键：注入预设值
'show' => true,
'class' => 'short',
);
return $fields;
}
add_filter( 'woocommerce_admin_billing_fields', 'rt_woocommerce_admin_billing_fields' );⚠️ 重要前提与注意事项：
- 必须提前注册查询变量：get_query_var('email') 能正常工作，前提是 'email' 已被 WordPress 识别为合法查询变量。请在主题 functions.php 或插件中添加以下注册代码（否则将始终返回空）：
// 注册自定义 query var
function rt_register_email_query_var( $vars ) {
$vars[] = 'email';
return $vars;
}
add_filter( 'query_vars', 'rt_register_email_query_var' );- 安全性建议：若该字段用于真实订单，应校验邮箱格式（如 is_email($email)），避免无效输入污染数据；生产环境还可结合 sanitize_email() 进行净化。
- 字段覆盖说明：此方法会完全替换原生 billing_email 字段的显示逻辑（包括标签和值）。如需保留原生字段行为并仅追加新字段，请改用 billing_custom_email 等非冲突键名，并配合 woocommerce_admin_order_data_after_billing_address 动态输出。
✅ 总结：通过组合 query_vars 注册 + woocommerce_admin_billing_fields 的 value 参数，即可实现 URL 驱动的后台字段预填充。该方案轻量、无侵入性，适用于快速定制化场景，是 WooCommerce 管理端扩展的典型实践模式。
