WooCommerce订单页添加自定义字段方法

本篇文章给大家分享《WooCommerce 订单页添加可编辑自定义字段》，覆盖了文章的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

本文将详细介绍如何在 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 '
Custom Km:
' . esc_html($custom_km) . '
';
    }
}

这段代码使用 get_post_meta 函数从数据库中获取 custom_km 的值，然后使用 echo 函数将其显示在订单管理页面中。esc_html 函数用于转义 HTML 实体，防止 XSS 攻击。

注意事项：

• 将以上代码添加到你的主题的 functions.php 文件中，或者创建一个自定义插件来添加这些代码。
• 确保在保存数据之前，对用户输入的数据进行验证和清理，以防止恶意代码注入。
• 可以根据需要调整钩子的优先级，以控制自定义字段在页面中的显示位置。

总结：

通过以上步骤，你就可以在 WooCommerce 订单管理页面中添加一个可编辑的自定义字段，用于记录订单完成时的总里程数。这个方法可以扩展到其他自定义字段，例如服务类型、维修项目等，从而更好地管理你的 WooCommerce 订单。记住，安全至关重要，始终要对用户输入的数据进行验证和清理。

终于介绍完啦！小伙伴们，这篇关于《WooCommerce订单页添加自定义字段方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！