README

OctoberCMS 的地址小部件。

安装

要安装地址小部件，将以下内容添加到您插件的 composer.json 文件中。

"require": {
    "owl/address": "~1.0@dev"
}

接下来，在您的插件 Plugin.php 文件中注册小部件。

public function registerFormWidgets()
{
    return [
        'Owl\FormWidgets\Address\Widget' => [
            'label' => 'Address',
            'code' => 'owl-address'
        ],
    ];
}

使用方法

您可以通过将字段类型声明为 owl-address 来将此小部件添加到您的表单中。

address:
    label: Address
    type: owl-address

这允许表单字段查询谷歌地图公共 API，并使用自动完成功能预测位置。

您可以通过使用字段映射进一步自定义它，以便它根据所选位置自动填充其他字段，例如纬度、经度等。为此，首先使用字段映射声明表单字段。

address:
    label: Address
    type: owl-address
    fieldMap:
        latitude: latitude
        longitude: longitude
        city: city
        zip: zip
        country: country_code
        state: state_code
        name: place_name
        address: place_address
        formataddress: fmt_address

现在定义应该填充结果值的字段。字段名称应与字段映射字段中指定的值相同。

city:
    label: City
zip:
    label: Zip
country_code:
    label: Country
state_code:
    label: State
latitude:
    label: Latitude
longitude:
    label: Longitude
place_name:
    label: Place Name
place_address:
    label: Place Address
fmt_address:
    label: Formatted Address

小部件自动检测字段的 presence 并在每次使用自动完成选择位置时应用正确的值。

可用映射

街道
城市
邮编
州
国家
国家-长
纬度
经度
名称
地址
地址格式

owl / address

维护者

详细信息

README

安装

使用方法