在 WooCommerce 中将结帐自定义字段数据添加到运输包裹中进行计算

Question

我正在创建一个插件，它将使用 API 计算自定义运输变体。我有一个 jQuery 脚本，它根据输入的地址计算邮政和 fias 代码。

$("#billing_address_1").suggestions({
        serviceUrl: "https://suggestions.dadata.ru/suggestions/api/4_1/rs",
        token: php_vars.dadata_suggest_token,
        type: "ADDRESS",
        count: 5,
        onSelect: function (suggestion) {
            $("#billing_city").val(suggestion.data.city);
            $("#billing_state").val(suggestion.data.region);
            $("#billing_postcode").val(suggestion.data.postal_code);
            if (suggestion.data.settlement_fias_id)
                $("#billing_fias_code").val(suggestion.data.settlement_fias_id);
            else if (suggestion.data.city_fias_id)
                $("#billing_fias_code").val(suggestion.data.city_fias_id);
            else
                $("#billing_fias_code").val('');
        }
    }); 

为了存储 fias 代码，我创建了自定义字段。

add_filter( 'woocommerce_checkout_fields' , array( $this, 'custom_checkout_fields' ));
add_action( 'woocommerce_checkout_update_order_meta', array( $this, 'shipping_apartment_update_order_meta') ); 
function custom_checkout_fields( $fields ) {
        $fields['shipping']['shipping_fias_code'] = array(
            'type' => 'text',
            'label' => __('FIAS', 'woocommerce'),
            'placeholder' => _x('Код', 'placeholder', 'woocommerce'),
            'required' => false,
            'class' => array('form-row-wide'),
            'clear' => true
        );
        $fields['billing']['billing_fias_code'] = array(
            'type' => 'text',
            'label' => __('FIAS', 'woocommerce'),
            'placeholder' => _x('Код', 'placeholder', 'woocommerce'),
            'required' => false,
            'class' => array('form-row-wide'),
            'clear' => true
        );
        
        return $fields;
    }

    function shipping_apartment_update_order_meta( $order_id ) {
        if ( ! empty( $_POST['shipping_fias_code'] ) ) {
            update_post_meta( $order_id, 'shipping_fias_code', sanitize_text_field( $_POST['shipping_fias_code'] ) );
        }
        if ( ! empty( $_POST['billing_fias_code'] ) ) {
            update_post_meta( $order_id, 'billing_fias_code', sanitize_text_field( $_POST['billing_fias_code'] ) );
        }
    }

woocommerce 中 WC_Shipping_Method 中的 calculate_shipping() 方法使用 $ package 变量计算运输选项，该变量有一个“目的地”数组字段，其中包含有关送货地址的信息。 默认情况下，邮政编码会传递到此数组中。 但我还需要在 $package 中传递我的自定义字段。

据我了解，我创建的字段将保存通过 jQuery 脚本添加到那里的信息，只有在发布表单后。 但是 $package['destination'] 中包含的其他字段在向它们添加信息后会立即保存。

如何将结帐表单中自定义字段的数据添加到$package['destination']变量？

Answer 1

我无法测试（或修改）您的 jQuery 代码，因此您必须自己处理它，也许要对其进行一些更改。 我已经完全重新访问了您的所有代码（除了您的 jQuery 代码）并且一切都如您所愿。

所以$package['destination']将有一个额外的'fias_code'条目。

评论的代码：

// Add billing and shipping fields
add_filter( 'woocommerce_billing_fields' , 'custom_billing_fields' );
add_filter( 'woocommerce_shipping_fields' , 'custom_shipping_fields' );

function custom_shipping_fields( $fields ) {
    $fields['shipping_fias_code'] = array(
        'type' => 'text',
        'label' => __('FIAS', 'woocommerce'),
        'placeholder' => _x('Код', 'placeholder', 'woocommerce'),
        'required' => false,
        'class' => array('form-row-wide'),
        'clear' => true
    );

    return $fields;
}

function custom_billing_fields( $fields ) {
    $fields['billing_fias_code'] = array(
        'type' => 'text',
        'label' => __('FIAS', 'woocommerce'),
        'placeholder' => _x('Код', 'placeholder', 'woocommerce'),
        'required' => false,
        'class' => array('form-row-wide'),
        'clear' => true
    );
    return $fields;
}

// Ajax sender
add_action( 'wp_footer', 'checkout_send_fias_code_via_ajax_js' );
function checkout_send_fias_code_via_ajax_js() {
    if ( is_checkout() && ! is_wc_endpoint_url() ) :
    ?><script type="text/javascript">
    jQuery( function($){
        if (typeof wc_checkout_params === 'undefined')
            return false;

        // Function that send the Ajax request
        function sendAjaxRequest( value, fieldset = 'billing' ) {
            $.ajax({
                type: 'POST',
                url: wc_checkout_params.ajax_url,
                data: {
                    'action': 'fias_code',
                    'fias_code': value,
                    'fieldset' : fieldset
                },
                success: function (result) {
                    $(document.body).trigger('update_checkout'); // Update checkout processes
                    console.log( result ); // For testing (output data sent)
                }
            });
        }

        // Billing fias code change & input events
        $(document.body).on( 'change input', 'input[name=billing_fias_code]', function() {
            sendAjaxRequest( $(this).val() );
        });

        // Shipping fias code change & input events
        $(document.body).on( 'change input', 'input[name=shipping_fias_code]', function() {
            sendAjaxRequest( $(this).val(), 'shipping' );
        });
    });
    </script>
    <?php
    endif;
}

// The Wordpress Ajax PHP receiver (set data to a WC_Session variable)
add_action( 'wp_ajax_fias_code', 'set_fias_code_to_wc_session' );
add_action( 'wp_ajax_nopriv_fias_code', 'set_fias_code_to_wc_session' );
function set_fias_code_to_wc_session() {
    $field_key = 'fias_code';
    if ( isset($_POST[$field_key]) && isset($_POST['fieldset']) ){
        // Get data from custom session variable
        $values = (array) WC()->session->get($field_key);

        // Initializing when empty
        if( ! empty($values) ) {
            $values = array(
                'billing' => WC()->customer->get_meta('billing_'.$field_key),
                'shipping' => WC()->customer->get_meta('shipping_'.$field_key)
            );
        }

        // Sanitizing data sent
        $fieldset  = esc_attr($_POST['fieldset']);
        $fias_code = sanitize_text_field($_POST[$field_key]);

        // Set / udpate custom WC_Session variable
        $values[$fieldset] = $fias_code;
        WC()->session->set($field_key, wc_clean($values));

        // Send back to javascript the data received as an array (json encoded)
        echo json_encode(array($fieldset.'_'.$field_key => $fias_code));
        wp_die(); // always use die() or wp_die() at the end to avoird errors
    }
}

// Update checkout fields 'fias_code' values from custom WC_session variable
add_filter('woocommerce_checkout_get_value', 'update_fias_code_checkout_fields_values', 10, 2 );
function update_fias_code_checkout_fields_values( $value, $input ) {
    $field_key = 'fias_code';

    // Get data from custom session variable
    $values = (array) WC()->session->get($field_key);

    if ( ! empty($values) ) {
        if ( 'billing_'.$field_key === $input ) {
            $value = $values['billing'];
        }
        if ( 'shipping_'.$field_key === $input ) {
            $value = $values['shipping'];
        }
    }
    return $value;
}

// Add 'fias_code' data to destination shipping packages
add_filter( 'woocommerce_cart_shipping_packages', 'add_fias_code_to_destination_shipping_package' );
function add_fias_code_to_destination_shipping_package( $packages ) {
    $customer   = WC()->customer; // The WC_Customer Object

    // Get 'fias_code' data from customer meta data
    $main_key   = 'fias_code';
    $meta_value = $customer->get_meta('shipping_'.$main_key);
    $meta_value = empty($meta_value) ? $customer->get_meta('billing_'.$main_key) : $meta_value;

    // Get data from custom session variable
    $values = (array) WC()->session->get($main_key);

    if ( ! empty($values) ) {
        $session_value = $values['shipping'];

        if ( $session_value === $meta_value ) {
            $session_value = $values['billing'];

            if ( $session_value !== $meta_value ) {
                $meta_value = $values['billing'];
            }
        } else {
            $meta_value = $session_value;
        }
    }

    // Loop through shipping packages
    foreach ( $packages as $key => $package ) {
        // Set to destination package the "fias_code"
        $packages[$key]['destination'][$main_key] = $meta_value;
    }
    return $packages;
}

// Remove custom WC_Session variable once order has been created (before thankyou)
add_action( 'woocommerce_checkout_order_created', 'remove_fias_code_custom_wc_session_variable' );
function remove_fias_code_custom_wc_session_variable() {
    // Remove the custom WC_Session variable
    WC()->session->__unset('fias_code');
}

此代码进入活动子主题（或活动主题）的 functions.php 文件。 测试和工作。

---

重要笔记：

显示和保存fias_code结帐字段：
我正在使用woocommerce_billing_fields和woocommerce_shipping_fields过滤器钩子而不是woocommerce_checkout_fields ，因为这样数据就被保存为订单元数据和用户元数据。 所以你最后的 function 不再需要了。
订单元键以下划线开头，就像所有账单和运输订单元数据一样。
这些字段将显示在我的帐户编辑地址上......因此，如果您想避免这种情况，您需要为两个相关的挂钩添加一个条件。

关于我的 jQuery 代码：
您最好将其复制到外部文件并以干净的 WordPress 方式注册/排队，将 output 限制为仅结帐页面。 然后你将删除相关的动作钩子和钩子函数......

关于动作和过滤器挂钩：
您必须为您的插件更改所有add_action()和add_filter() ，例如：

add_filter( 'woocommerce_billing_fields' , array($this, 'custom_billing_fields') );
add_filter( 'woocommerce_shipping_fields' , array($this, 'custom_shipping_fields') );
add_action( 'wp_footer', array($this, 'checkout_send_fias_code_via_ajax_js') );
add_action( 'wp_ajax_fias_code', array($this, 'set_fias_code_to_wc_session') );
add_action( 'wp_ajax_nopriv_fias_code', array($this, 'set_fias_code_to_wc_session') );
add_filter('woocommerce_checkout_get_value', array($this, 'update_fias_code_checkout_fields_values'), 10, 2 );
add_filter( 'woocommerce_cart_shipping_packages', array($this, 'add_fias_code_to_destination_shipping_package') );
add_action( 'woocommerce_checkout_order_created', array($this, 'remove_fias_code_custom_wc_session_variable') );