本文介绍如何在 woocommerce 后台新建订单页面中，为自定义账单字段（如邮箱）动态填充 url 查询参数传递的值，并确保该值在页面加载时即可见、可编辑。
本文介绍如何在 woocommerce 后台新建订单页面中，为自定义账单字段（如邮箱）动态填充 url 查询参数传递的值，并确保该值在页面加载时即可见、可编辑。
在 WooCommerce 后台创建新订单时（/wp-admin/post-new.php?post_type=shop_order），开发者常需根据外部上下文（例如营销链接、API 回调或内部跳转）预填部分账单信息，提升运营效率。你已成功通过 woocommerce_admin_billing_fields 钩子添加了自定义字段，但仅注册字段并不足以实现“自动填充”——关键在于为该字段显式指定 value 键。
✅ 正确实现：注入动态值到字段配置
WooCommerce 在渲染后台账单字段时，会读取 $fields 数组中每个字段的 value 键作为默认值。因此，只需在钩子回调中获取查询参数并赋值即可：
function rt_woocommerce_admin_billing_fields( $fields ) {
// 安全获取 URL 中的 'email' 查询参数（需提前在 rewrite rules 或 query_vars 中注册）
$email = get_query_var('email') ?: '';
// 覆盖或扩展 billing_email 字段，显式设置 value
$fields['billing_email'] = array(
'label' => __( 'Email', 'your-textdomain' ),
'value' => sanitize_email( $email ), // ✅ 建议过滤输入
'show' => true,
'class' => 'short',
'required' => false, // 可选：按需设置必填
);
return $fields;
}
add_filter( 'woocommerce_admin_billing_fields', 'rt_woocommerce_admin_billing_fields' );⚠️ 重要前提：注册查询变量
get_query_var('email') 能正常工作，前提是 'email' 已被 WordPress 识别为合法查询变量。否则将始终返回空值。请在主题的 functions.php 或插件中添加以下注册代码：
// 注册自定义查询变量
function rt_register_email_query_var( $vars ) {
$vars[] = 'email';
return $vars;
}
add_filter( 'query_vars', 'rt_register_email_query_var' );此时，你可以通过如下 URL 触发预填充效果：
/wp-admin/post-new.php?post_type=shop_order&email=test%40example.com
? 提示：URL 中的 email 参数需进行 URL 编码（如 @ → %40），前端跳转时建议使用 urlencode() 处理。
? 补充说明与最佳实践
- 字段复用性：billing_email 是 WooCommerce 原生字段，覆盖其配置不会影响前端逻辑，但若需新增非标准字段（如 billing_company_id），命名需避免与核心字段冲突，并配合 woocommerce_admin_order_data_after_billing_address 等钩子输出 HTML。
- 安全性：务必对 get_query_var() 获取的值进行校验与过滤（如 sanitize_email() 或 esc_attr()），防止 XSS 或脏数据写入。
- 兼容性：该方案适用于 WooCommerce 6.0+ 及主流 PHP 版本；若字段未生效，请检查是否启用了缓存插件导致 admin 页面被缓存（应禁用后台页面缓存）。
- 调试技巧：临时添加 error_log( print_r( get_query_var('email'), true ) ); 可快速验证参数是否正确传入。
通过以上三步（注册 query_var → 获取并过滤值 → 注入字段 value），即可实现 URL 驱动的后台字段智能预填，显著优化批量订单录入与跨系统集成体验。
