本文将详细介绍如何在 WooCommerce 订单管理页面中添加一个可编辑的自定义字段，用于记录订单完成时的总里程数。通过本文，你将学会如何在订单详情页面添加输入框，并将用户输入的数据保存到数据库，最后在订单管理页面中显示该数据。
添加自定义字段到订单详情页面
首先，我们需要在 WooCommerce 订单详情页面中添加一个文本输入框，用于输入总里程数。我们可以使用 woocommerce_admin_order_data_after_order_details 钩子来实现这一点。
add_action( 'woocommerce_admin_order_data_after_order_details', 'editable_order_custom_field', 12, 1 );
function editable_order_custom_field( $order ){
$order_id = $order->get_id();
$custom_km = get_post_meta( $order_id, 'custom_km', true ); // 获取已保存的值
woocommerce_wp_text_input( array(
'id' => 'custom_km',
'label' => __("Total Km:", "woocommerce"),
'value' => $custom_km, // 使用已保存的值
'wrapper_class' => 'form-field-wide',
) );
}
这段代码使用 woocommerce_wp_text_input 函数创建一个文本输入框，id 设置为 custom_km，label 设置为 “Total Km:”。wrapper_class 用于控制输入框的宽度。关键在于获取并设置 value，确保编辑时显示的是已保存的数据。
保存自定义字段数据
接下来，我们需要将用户输入的数据保存到数据库中。我们可以使用 woocommerce_process_shop_order_meta 钩子来实现这一点。
add_action( 'woocommerce_process_shop_order_meta', 'save_custom_filed_data' );
function save_custom_filed_data( $order_id ){
if ( isset( $_POST['custom_km'] ) ) {
update_post_meta( $order_id, 'custom_km', wc_clean( $_POST['custom_km'] ) );
}
}
这段代码首先检查 $_POST 中是否存在 custom_km 字段，如果存在，则使用 update_post_meta 函数将数据保存到 postmeta 表中。wc_clean 函数用于清理用户输入的数据，防止恶意代码注入。
显示自定义字段数据
最后，我们需要在订单管理页面中显示保存的自定义字段数据。我们可以使用 woocommerce_admin_order_data_after_billing_address 钩子来实现这一点。
add_action('woocommerce_admin_order_data_after_billing_address', 'display_the_custom_distance_km', 10, 1);
function display_the_custom_distance_km($order)
{
$custom_km = get_post_meta($order->get_id(), 'custom_km', true);
if ($custom_km) {
echo '<p><strong>Custom Km:</strong><br>' . esc_html($custom_km) . '</p>';
}
}
这段代码使用 get_post_meta 函数从数据库中获取 custom_km 的值，然后使用 echo 函数将其显示在订单管理页面中。esc_html 函数用于转义 HTML 实体，防止 XSS 攻击。
注意事项：
- 将以上代码添加到你的主题的 functions.php 文件中，或者创建一个自定义插件来添加这些代码。
- 确保在保存数据之前，对用户输入的数据进行验证和清理，以防止恶意代码注入。
- 可以根据需要调整钩子的优先级，以控制自定义字段在页面中的显示位置。
总结：
通过以上步骤，你就可以在 WooCommerce 订单管理页面中添加一个可编辑的自定义字段，用于记录订单完成时的总里程数。这个方法可以扩展到其他自定义字段，例如服务类型、维修项目等，从而更好地管理你的 WooCommerce 订单。记住，安全至关重要，始终要对用户输入的数据进行验证和清理。
以上就是为 WooCommerce 订单管理页面添加可编辑的自定义字段的详细内容，更多请关注php中文网其它相关文章！