本文详解如何在 woocommerce 后台订单编辑页面（admin）中，通过 woocommerce_admin_shipping_fields 钩子动态设置配送地址字段的默认值——关键在于该钩子返回的数组结构不包含 value 键，需改用 default 键赋值，而非直接操作 value。
本文详解如何在 woocommerce 后台订单编辑页面（admin）中，通过 woocommerce_admin_shipping_fields 钩子动态设置配送地址字段的默认值——关键在于该钩子返回的数组结构不包含 value 键，需改用 default 键赋值，而非直接操作 value。
在 WooCommerce 后台订单编辑页（如 /wp-admin/post.php?post=123&action=edit）中，开发者常希望通过 URL 参数（如 ?f=John&l=Doe&a=123+Main+St）自动填充配送信息字段。虽然 woocommerce_admin_billing_fields 钩子支持直接设置 'value' => $_GET['xxx']，但woocommerce_admin_shipping_fields 的默认字段数组结构完全不同：它不提供 value 键，而是由 WooCommerce 内部在渲染时根据 'default' 键（若存在）或数据库值来填充输入框。
✅ 正确实现方式：使用 default 键
你需要在钩子回调中为每个目标字段显式添加 'default' 子键，并赋予期望的初始值。以下是适配你原始需求的可靠代码：
function rt_woocommerce_admin_shipping_fields( $fields ) {
// 安全获取并过滤 URL 参数（强烈建议）
$f = isset( $_GET['f'] ) ? sanitize_text_field( $_GET['f'] ) : '';
$l = isset( $_GET['l'] ) ? sanitize_text_field( $_GET['l'] ) : '';
$a = isset( $_GET['a'] ) ? sanitize_text_field( $_GET['a'] ) : '';
$b = isset( $_GET['b'] ) ? sanitize_text_field( $_GET['b'] ) : '';
// 为关键字段注入 default 值（注意：仅当字段已存在于 $fields 数组中才可覆盖）
if ( isset( $fields['first_name'] ) ) {
$fields['first_name']['default'] = $f;
}
if ( isset( $fields['last_name'] ) ) {
$fields['last_name']['default'] = $l;
}
if ( isset( $fields['address_1'] ) ) {
$fields['address_1']['default'] = $a;
}
if ( isset( $fields['address_2'] ) ) {
$fields['address_2']['default'] = $b;
}
return $fields;
}
add_filter( 'woocommerce_admin_shipping_fields', 'rt_woocommerce_admin_shipping_fields', 10, 1 );⚠️ 重要注意事项
- default 是唯一有效的键：woocommerce_admin_shipping_fields 过滤器返回的字段定义数组中，value 键被完全忽略；只有 default 被 WooCommerce 表单渲染逻辑识别。
- 字段必须存在才能覆盖：务必先检查 isset($fields['xxx'])，避免因字段未启用（如被主题/插件移除）导致 PHP Notice。
- 安全第一：始终对 $_GET 输入执行 sanitize_text_field() 或更严格的验证（如 absint() 处理数字），防止 XSS 或注入风险。
- 仅影响新建/未保存订单：default 值仅在字段尚未从数据库加载数据时生效（例如新创建订单或清空表单后）。若订单已有保存的配送地址，数据库值将优先显示。
- 不适用于批量编辑或AJAX场景：此钩子仅作用于订单编辑主表单，不触发于批量操作或部分 AJAX 加载区域。
? 验证与调试建议
若修改后仍无效果，请依次排查：
- 确认 URL 参数拼写与代码中 $_GET 键名完全一致（区分大小写）；
- 检查是否启用了“复用账单地址”选项（ship_to_different_address），该选项可能隐藏配送字段；
- 使用 error_log( print_r( $fields, true ) ); 输出原始 $fields 结构，确认目标字段确实存在且键名准确；
- 确保钩子在 functions.php 中正确加载（无语法错误、未被条件逻辑跳过）。
通过遵循上述规范，你即可稳定、安全地实现后台订单配送字段的 URL 参数预填充，提升运营效率与用户体验。
