通过
搜索
搜索kadegray / statamic-phone-number-fieldtype
此包最新版本（1.0.3）没有可用的许可信息。
Statamic 电话号码字段类型插件
1.0.3
2023-05-20 05:12 UTC
Requires
- giggsey/libphonenumber-for-php: ^8.13
- sokil/php-isocodes: ^4.1
- sokil/php-isocodes-db-i18n: ^4.0
Requires (Dev)
- statamic/cms: ^3.3
README
Statamic 电话号码字段类型是一个Statamic插件，它包含了您在网站上存储和显示电话号码所需的一切。
功能
- 使用国际电话输入的电话号码字段类型。
- E164格式：电话号码将按国际标准E164格式保存。
- 国家选择：用户可以选择国家，并输入国家格式电话号码，方便使用。
- 自动国家检测：当用户输入国际格式电话号码时，将自动选择相应的国家。
- 自定义选项
- 隐藏国家选择：如不需要，隐藏国家选择字段以定制用户界面。
- 初始国家：设置默认国家以获得更流畅的用户体验。
- 首选国家：在国家选择下拉菜单中突出显示常用国家。
- 排除国家：通过排除特定国家来自定义可用的国家选项。
- 仅国家：选择在国家选择下拉菜单中显示的国家。
- 修饰符
- e164_to_national：将E164格式的电话号码转换为国家格式。
- e164_to_international：将E164格式的电话号码转换为国际格式。
如何安装
您可以在Statamic控制面板的工具 > 插件部分搜索此插件，并点击安装，或者从项目根目录运行以下命令
composer require kadegray/statamic-phone-number-fieldtype
如何使用
电话号码字段类型
一旦您将电话号码字段类型包含在蓝图文件中并编辑条目，它将以国际电话输入的形式呈现，方便输入和显示。
当您打开国家选择时，将以下方式显示
当用户在字段中输入"2015550123"时，字段类型将自动将其格式化为E164格式，如"+12015550123"，其中"+1"代表国家代码。电话号码将按E164格式保存在条目中。
在保存条目后重新加载页面，您将观察到号码已自动按国家格式格式化。此格式化行为基于所选国家，允许正确处理国际和国内号码。
字段类型配置
当您编辑字段类型时，您可以配置以下选项
显示国家选择- 启用或禁用国家选择的显示。初始国家- 设置初始国家。首选国家- 在国家选择中指定要显示在顶部的前选国家。排除国家- 从国家选择中排除特定国家。仅国家- 指定在国家选择中显示的国家。
修饰符
如果您已将字段处理程序分配为phone_number或australia_phone_number，您可以使用以下代码以E164格式渲染原始存储值
{{ phone_number }}
{{ australia_phone_number }}
+12015550123
+61412345678
但是，如果您希望以国家格式渲染号码，您可以使用e164_to_national修饰符如下
{{ phone_number | e164_to_national }}
{{ australia_phone_number | e164_to_national }}
(201) 555-0123
0412 345 678
此外，如果您想以更直观的国际格式展示该数字，可以使用 e164_to_international 修饰符
{{ phone_number | e164_to_international }}
{{ australia_phone_number | e164_to_international }}
+1 201-555-0123
+61 412 345 678