WooCommerce技术问题：添加加拿大省份选项或自定义州/省输入功能

嘿，我来帮你搞定这两个WooCommerce的州/省问题——我之前在客户的电商项目里刚好处理过类似需求，分享几个实用的落地方案：

一、先搞定加拿大省份选项缺失的问题 #

首先先排查基础设置，大概率是配置问题：

• 进入WooCommerce → 设置 → 常规，确保**加拿大（CA）**在「启用国家/地区」列表里被勾选，同时在「州/省」设置区域，加拿大对应的选项设为「需要」或「可选」。有时候没启用对应国家，省份下拉列表根本不会加载。

如果排查后还是没有完整的加拿大省份，直接用代码强制添加——把这段代码加到主题的functions.php文件里，或者用Code Snippets这类自定义代码插件（更安全，避免主题更新丢失代码）：

add_filter( 'woocommerce_states', 'add_canada_provinces_to_woocommerce' );
function add_canada_provinces_to_woocommerce( $states ) {
    // 覆盖或添加加拿大所有省份
    $states['CA'] = array(
        'AB' => 'Alberta',
        'BC' => 'British Columbia',
        'MB' => 'Manitoba',
        'NB' => 'New Brunswick',
        'NL' => 'Newfoundland and Labrador',
        'NT' => 'Northwest Territories',
        'NS' => 'Nova Scotia',
        'NU' => 'Nunavut',
        'ON' => 'Ontario',
        'PE' => 'Prince Edward Island',
        'QC' => 'Quebec',
        'SK' => 'Saskatchewan',
        'YT' => 'Yukon'
    );
    return $states;
}

这段代码会直接给加拿大生成完整的省份下拉列表，亲测有效。

二、添加「其他」州/省选项或允许自定义文本输入 #

如果需要给用户提供自定义州/省的入口，有两种常用方案：

方案1：下拉框加「其他」选项，配合隐藏文本框 #

这个方案兼顾规范和灵活性——下拉框保留现有州/省选项，末尾加「其他（请输入）」，用户选择后自动显示文本框让其输入自定义内容，同时内容会同步保存到订单后台：

// 给所有国家的州/省下拉添加「其他」选项（也可以只给加拿大加，注释里有写法）
add_filter( 'woocommerce_states', 'add_other_state_option' );
function add_other_state_option( $states ) {
    // 只给加拿大加的写法：$states['CA']['OTHER'] = '其他（请输入）';
    // 下面是给所有国家加
    foreach ( $states as $country => $state_list ) {
        $states[$country]['OTHER'] = '其他（请输入）';
    }
    return $states;
}

// 添加隐藏的自定义文本框，选择「其他」时显示
add_action( 'woocommerce_after_checkout_billing_form', 'add_custom_state_input' );
add_action( 'woocommerce_after_checkout_shipping_form', 'add_custom_state_input' );
function add_custom_state_input() {
    ?>
    <div id="custom-state-container" style="display:none;margin-top:10px;">
        <label for="custom_state">自定义州/省</label>
        <input type="text" id="custom_state" name="custom_state" class="input-text" />
    </div>
    <script>
        jQuery(document).ready(function($) {
            // 监听账单和配送的州/省下拉变化
            $('select[name=billing_state], select[name=shipping_state]').change(function() {
                if ($(this).val() === 'OTHER') {
                    $('#custom-state-container').show();
                } else {
                    $('#custom-state-container').hide();
                    $('#custom_state').val('');
                }
            });
        });
    </script>
    <?php
}

// 把自定义州/省内容保存到订单
add_action( 'woocommerce_checkout_update_order_meta', 'save_custom_state_to_order' );
function save_custom_state_to_order( $order_id ) {
    if ( ! empty( $_POST['custom_state'] ) ) {
        $custom_state = sanitize_text_field( $_POST['custom_state'] );
        update_post_meta( $order_id, '_custom_state', $custom_state );
        // 同步更新订单的州字段，后台直接显示自定义内容
        $order = wc_get_order( $order_id );
        $order->update_meta_data( '_billing_state', $custom_state );
        $order->update_meta_data( '_shipping_state', $custom_state );
        $order->save();
    }
}

// 在订单后台显示自定义州/省内容
add_action( 'woocommerce_admin_order_data_after_billing_address', 'display_custom_state_in_admin' );
function display_custom_state_in_admin( $order ) {
    $custom_state = get_post_meta( $order->get_id(), '_custom_state', true );
    if ( $custom_state ) {
        echo '<p><strong>自定义州/省:</strong> ' . esc_html( $custom_state ) . '</p>';
    }
}

方案2：直接把州/省字段改成文本框（适合不需要下拉的场景） #

如果觉得下拉框太繁琐，想让用户直接输入省/地区名称，尤其是针对加拿大这类场景，可以直接把州/省字段改成文本框：

add_filter( 'woocommerce_checkout_fields', 'change_state_to_text_field_for_canada' );
function change_state_to_text_field_for_canada( $fields ) {
    // 把账单和配送的州/省字段改成文本框
    $fields['billing']['billing_state']['type'] = 'text';
    $fields['billing']['billing_state']['label'] = '省/地区';
    $fields['shipping']['shipping_state']['type'] = 'text';
    $fields['shipping']['shipping_state']['label'] = '省/地区';
    return $fields;
}

注意：如果只想给加拿大用户显示文本框，其他国家保留下拉框，需要配合JS做动态切换，上面的代码是全局修改的最简版本。

内容的提问来源于stack exchange，提问作者Spencer Phillips