基于购物车总额在WooCommerce结账页添加自定义文件上传字段

你的代码主要存在两个问题：一是未正确获取订单总额变量，二是手动处理金额字符串的方式不可靠；另外直接修改模板文件并非最佳实践（主题更新会导致修改丢失）。下面给出两种可行的解决方式：

方法1：使用WooCommerce钩子（推荐） #

直接在主题的functions.php文件中添加以下代码，无需修改模板文件，更安全稳定：

// 在结账页订单审核区域后添加自定义字段
add_action('woocommerce_checkout_after_order_review', 'add_upload_signature_field_by_total');
function add_upload_signature_field_by_total() {
    // 直接获取处理好的订单总额（浮点型数值，无需手动去除货币符号）
    $cart_total = WC()->cart->total;

    if ($cart_total > 500) {
        echo '<div id="billing_uploadsign_field" class="billing-uploadsign-field">';
        
        woocommerce_form_field('billing_uploadsign', array(
            'type'     => 'file',
            'class'    => array('form-row-wide'),
            'label'    => __('Upload Signature', 'woocommerce'),
            'required' => true,
            // 可选：限制上传文件类型为图片
            'custom_attributes' => array('accept' => 'image/*')
        ), WC()->checkout->get_value('billing_uploadsign'));
        
        echo '</div>';
    }
}

// 保存上传的文件到订单元数据
add_action('woocommerce_checkout_create_order', 'save_signature_upload_to_order');
function save_signature_upload_to_order($order) {
    if (!empty($_FILES['billing_uploadsign']['name'])) {
        $upload_result = wp_handle_upload($_FILES['billing_uploadsign'], array('test_form' => false));
        
        if (!isset($upload_result['error']) || $upload_result['error'] === 0) {
            $order->update_meta_data('_billing_uploadsign', $upload_result['url']);
        }
    }
}

方法2：修改模板文件（不推荐） #

如果你坚持要修改form-checkout.php，只需替换原来的金额处理逻辑，直接用WooCommerce内置的数值获取方式：

// 替换你原来的金额处理代码
$cart_total = WC()->cart->total;

// Check if order total is greater than 500
if ($cart_total > 500) {
    echo '<div id="billing_uploadsign_field" class="billing-uploadsign-field">';

    woocommerce_form_field('billing_uploadsign', array(
        'type'     => 'file',
        'class'    => array('form-row-wide'),
        'label'    => __('Upload Signature', 'woocommerce'),
        'required' => true,
    ), $checkout->get_value('billing_uploadsign'));

    echo '</div>';
}

关键说明 #

• 原代码中$cart_total变量未定义，导致后续字符串处理逻辑失效，条件判断永远不成立，所以字段无法显示。
• WC()->cart->total是WooCommerce已经处理好的订单总额（包含税费、运费等），直接为浮点型数值，无需手动处理货币符号或千位分隔符，避免了不同地区格式差异的问题。
• 文件上传字段必须添加保存逻辑，否则用户上传的文件不会关联到订单中，上述代码已包含这部分处理。

内容的提问来源于stack exchange，提问作者romin patel