README

为 SilverStripe v4 表单提供 CountryDropdownField。

内容

SilverStripe 决定在 v4 中从 framework 中删除 CountryDropdownField，这是一个相当方便的字段，当您需要在表单中输入国际地址时。此模块提供了一个替代字段，具有与原始字段类似的所有配置选项。

通过 Composer 安装

$ composer require silverware/countries

与所有 SilverStripe 模块一样，配置是通过 YAML 完成的。对于 CountryDropdownField 有三个配置选项可用

default_to_locale - 默认设置为 false；如果设置为 true，字段的默认值将基于当前用户的区域设置或应用默认区域设置（从 i18n 获取）。
default_country - 默认设置为 null；如果 default_to_locale 设置为 false，则定义要使用的国家代码作为默认值。
invalid_countries - 定义一个国家代码列表，这些代码被认为是无效的，并从默认源数据中删除。

注意： 此模块中的 default_to_locale 和 default_country 与原始 SilverStripe 字段不同。原始类具有 default_to_locale 设置为 true 和 default_country 设置为 NZ。

您仍然可以通过配置设置这些默认值，但我认为最好不默认假设区域或国家。通常，这些默认值会被原始字段使用项目的覆盖。

要使用字段，只需在文件头部 use 类即可

use SilverWare\Countries\Forms\CountryDropdownField;

然后您可以在表单代码中创建字段的实例

CountryDropdownField::create('MyCountryCode', 'Country');

请使用 GitHub 问题跟踪器报告错误和功能请求。

您的贡献将受到欢迎，以帮助改进此项目。有关更多信息，请参阅 contributing。