为 WooCommerce 订单管理页面添加可编辑的自定义字段

本文将详细介绍如何在 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 钩子来实现这一点。

度加剪辑

度加剪辑（原度咔剪辑），百度旗下AI创作工具

63

查看详情

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中文网其它相关文章！