ACF Frontend Admin前端注册表单：国家选项加载失败求助

原代码的核心问题 #

• 混淆ACF字段的key与name：你用$field['key'] == 'country'判断目标字段，但ACF的字段key是系统自动生成的格式（如field_abc123），而非你设置的字段名country，应该通过$field['name']匹配字段名。
• 错误获取国家选项来源：get_field('billing_country', 'user_' . $user->ID)仅能获取单个用户的已选国家值，而非全局可选的国家列表。
• 过滤器钩子参数错误：acf/load_field/key=country中的key参数需对应真实ACF字段key，若用字段名匹配，应改用acf/load_field/name=country钩子。

修正方案 #

根据你的站点环境，选择对应的代码：

场景1：站点使用WooCommerce（直接调用内置国家列表）

// 为ACF Frontend注册表单的country下拉字段加载WooCommerce国家选项
function add_country_choices_to_acf_select_field($field) {
    // 匹配字段名为country的ACF下拉字段
    if ($field['name'] == 'country') {
        // 清空默认选项
        $field['choices'] = [];
        
        // 调用WooCommerce国家列表
        if (class_exists('WC_Countries')) {
            $countries = new WC_Countries();
            $country_list = $countries->get_allowed_countries();
            
            // 将国家列表写入ACF字段选项
            if (!empty($country_list)) {
                foreach ($country_list as $code => $name) {
                    $field['choices'][$code] = $name;
                }
            }
        }
    }
    return $field;
}
add_filter('acf/load_field/name=country', 'add_country_choices_to_acf_select_field');

场景2：无WooCommerce，使用自定义国家选项

先确保你已将国家列表存入WordPress选项（可通过update_option('custom_country_list', ['CN' => '中国', 'US' => '美国', ...])初始化），再使用以下代码：

// 为ACF Frontend注册表单的country下拉字段加载自定义国家选项
function add_country_choices_to_acf_select_field($field) {
    if ($field['name'] == 'country') {
        $field['choices'] = [];
        
        // 从WordPress选项中读取自定义国家列表
        $country_list = get_option('custom_country_list', []);
        
        if (!empty($country_list)) {
            foreach ($country_list as $code => $name) {
                $field['choices'][$code] = $name;
            }
        }
    }
    return $field;
}
add_filter('acf/load_field/name=country', 'add_country_choices_to_acf_select_field');

注意事项 #

• 确保你的ACF字段类型为「下拉选择框」，且未在插件后台手动配置选项（代码会覆盖手动设置的选项）。
• 确认ACF字段的「字段名称」确实为country，可在ACF字段编辑页面查看该参数。

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